Edit

Share via

Remove-RDDatabaseConnectionString

  • Reference
Module:
RemoteDesktop

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

Outputs

Null