• Article

Set-CsManagementConnection

 

Topic Last Modified: 2012-03-26

Modifies the management connection to the Central Management store.

Syntax

Set-CsManagementConnection -StoreProvider <FileSystem | Sql> -Connection <String> [-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 replica services be able to locate this database. When you install 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) all you have to do is run the Get-CsManagementConnection cmdlet.

For the most part, after your management connection has been set you will not need to change it. However, in case of hardware or software failure, you might need to temporarily use a connection; for example, you can configure a computer to work from the local replica. The Set-CsManagementConnection cmdlet provides a way for you to provide a new location for the Central Management store.

Note that any changes you make to Lync Server while using a temporary management connection will not persist if and when you switch back to your original connection. (You can switch back by running the Remove-CsManagementConnection cmdlet.) For example, suppose you decide to temporarily use the file system as your store provider. You change the management connection, and then create several new voice policies (each of which will be instantiated as XML files). When you switch back to your original management connection, these new voice policies will disappear because they were never recorded in the Central Management store now being used.

You should also keep in mind that any changes made by running this cmdlet only affect the local computer. You cannot use Set-CsManagementConnection to change the management connection on other computers.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Set-CsManagementConnection cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins.

Parameters

Parameter Required Type Description

Connection

Required

String

Location information for the SQL Server instance or the file system folder being used as the management connection.

For example, if the new management connection is to a SQL Server instance named rtcbackup on the computer atl-sql-001.litwareinc.com then use this syntax: -Connection "atl-sql-001.litwareinc.com\rtcbackup".

If you want to create a management connection to the folder C:\TestTopology then use this syntax: -Connection "C:\TestTopology". If the folder does not exist, Set-CsManagementConnection will create it.

StoreProvider

Required

StoreProvider

Indicates the type of back-end store used for configuration information. To store configuration data in SQL Server, set the StoreProvider like this: -StoreProvider Sql. To store configuration data to the file system, use this syntax: -StoreProvider FileSystem. SQL Server and the file system are the only valid store providers. You should not modify the StoreProvider property unless instructed to do so by Microsoft support personnel.

WhatIf

Optional

Switch Parameter

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

Confirm

Switch Parameter

Prompts you for confirmation before executing the command.

Input Types

None. Set-CsManagementConnection does not accept pipelined input.

Return Types

Set-CsManagementConnection does not return a value or object. Instead, the cmdlet configures instances of the Microsoft.Rtc.Management.Store.StoreProvider object.

Example

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

Set-CsManagementConnection -StoreProvider Sql -Connection "atl-sql-001.litwareinc.com\rtcbackup"

The command shown in Example 1 changes the management connection to the SQL Server instance rtcbackup found on the computer atl-sql-001.litwareinc.com.

-------------------------- Example 2 --------------------------

Set-CsManagementConnection -StoreProvider FileSystem -Connection "C:\TestTopology"

In the preceding example, the management connection is set to file system and, more specifically, to the folder C:\TestTopology on the local computer.