Remove-RDDatabaseConnectionString
Removes the secondary database connection string for the shared database server in a high availability environment configuration.
Syntax
Remove-RDDatabaseConnectionString
[-DatabaseConnectionString]
[[-ConnectionBroker] <String>]
[-Force]
[<CommonParameters>]
Remove-RDDatabaseConnectionString
[-DatabaseSecondaryConnectionString]
[[-ConnectionBroker] <String>]
[-Force]
[<CommonParameters>]
Description
The Remove-RDDatabaseConnectionString cmdlet removes the secondary database connection string for the database server in a high availability environment with multiple Remote Desktop Connection Broker (RD Connection Broker) servers.
High availability supports multiple RD Connection Broker roles and servers, and uses a database server to store the configuration information for RD Connection Broker servers.
A secondary database connection string allows for connectivity in the case of an expired password for the primary database connection string. The secondary database connection string is optional. You can set this string by using the Set-RDDatabaseConnectionString cmdlet. You can remove the string by using the current cmdlet.
Currently, you cannot use this cmdlet to remove the primary database connection string.
Examples
Remove a remote desktop database connection string
PS C:\> remove-RDDatabaseConnectionString -ConnectionBroker "Rdcb.Contoso.com" -DatabaseConnectionString "DRIVER=SQL Server Native Client 10.0;SERVER=Sqlserver.Contoso.com;Trusted_Connection=Yes;APP=Remote Desktop Services Connection Broker;Database=RemoteDesktopDeployment"
This command removes the database connection string for the RD Connection Broker named Rdcb.Contoso.com.
Parameters
-ConnectionBroker
Specifies the RD Connection Broker server for a remote desktop deployment. If you do not supply a value, the cmdlet uses the fully qualified domain name (FQDN) of the local computer.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseConnectionString
This parameter is not currently supported.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseSecondaryConnectionString
Indicates that this cmdlet removes the secondary database connection string.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Forces the command to run without asking for user confirmation.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
None