Share via

  • Article

Remove-CsManagementConnection

 

Topic Last Modified: 2012-03-26

Resets the management connection to the Active Directory service control point for the Central Management store.

Syntax

Remove-CsManagementConnection [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Detailed Description

Configuration data for Microsoft Lync 2010 is stored in the Central Management store; it is crucial that both Windows PowerShell and the management replication services be able to locate this database. When you install Microsoft Lync Server 2010, a service control point is created in Active Directory Domain Services (AD DS) that provides location information for this database. Typically, computers rely on this service control point in order to connect to the Central Management store. To see the details behind this connection (that is, if you want to know which computer the Central Management store is running on, as well information about the SQL Server connection to that Central Management store), you can run the Get-CsManagementConnection cmdlet.

As a general rule, you will not need to change your management connection. However, it is possible that you might need to temporarily use a new management connection. When you are ready to switch back to the default connection all you need to do is run the Remove-CsManagementConnection cmdlet; this cmdlet erases the current connection information and replaces it with the connection information stored in the Active Directory service control point. This means you do not have to recreate the original connection information; Remove-CsManagementConnection will do that for you.

Note that no problems will occur if you call this cmdlet while using the default connection. If you do so, you will simply continue to use the default connection information stored in Active Directory. Note, too that this cmdlet only affects the management connection information for your current Windows PowerShell session: any changes to the management connection are limited to your local computer and local instance of Windows PowerShell.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Remove-CsManagementConnection cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsManagementConnection"}

Parameters

Parameter Required Type Description

WhatIf

Optional

Switch Parameter

Describes what would happen if you executed the command without actually executing the command.

Confirm

Optional

Switch Parameter

Prompts you for confirmation before executing the command.

Input Types

None. Remove-CsManagementConnection does not accept pipelined input.

Return Types

None. Instead, Remove-CsManagementConnection deletes instances of the Microsoft.Rtc.Management.Xds.ManagementConnection object.

Example

------------------------- Example 1 ------------------------

Remove-CsManagementConnection

The command shown in Example 1 removes the existing management connection information and replaces it with the default connection information stored in Active Directory.