Remove-RDDatabaseConnectionString
Removes the secondary database connection string for the shared database server in a high availability environment configuration.
Syntax
DatabaseConnectionString
Remove-RDDatabaseConnectionString
[[-ConnectionBroker] <String>]
[-DatabaseConnectionString]
[-Force]
[<CommonParameters>]
DatabaseSecondaryConnectionString
Remove-RDDatabaseConnectionString
[[-ConnectionBroker] <String>]
[-DatabaseSecondaryConnectionString]
[-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DatabaseConnectionString
This parameter is not currently supported.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
DatabaseConnectionString
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DatabaseSecondaryConnectionString
Indicates that this cmdlet removes the secondary database connection string.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
DatabaseSecondaryConnectionString
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
Forces the command to run without asking for user confirmation.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.