[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Modifies the management connection to the Central Management Database.


Set-CsManagementConnection -StoreProvider <FileSystem | Sql> -Connection <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]


Parameter Required Type Description



PS List Modifier

Indicates the type of backend 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 fie system, use this syntax: -StoreProvider FileSystem. SQL Server and the file system are the only valid store providers.




Location information for the SQL Server instance or the file system folder being used as the store provider.

For example, if the new management connection is to a SQ 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.



Switch Parameter

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


Switch Parameter

Prompts you for confirmation before executing the command.

Detailed Description

Configuration data for Microsoft Communications Server 2010 is stored in the Central Management Database; as you might expect, computers running Communications Server services or server roles need to be able to locate this database. When you install Microsoft Communications Server 2010, a service control point is created in Active Directory that provides location information for this database. Typically, computers rely on this service control point in order to connect to the management database. If you want to know the details behind this connection (that is, if you want to know which computer the database is running on, as well information about the SQL Server connection to that database) all you have to do is run the Get-CsManagementConnection cmdlet.

Get-CsManagementConnection is useful because it provides information about the actual connection to the management database; it does not simply retrieve information from the service control point. That’s important, because it’s possible to temporarily change your management connection, in which case the service control point is no longer valid. For example, in a case of hardware or software failure (or maintenance) you might want to temporarily use a different computer or a different instance of SQL Server as your management database. Likewise, Communications Server even lets you use the file system, and a set of XML files, as the management database. (This is usually done for testing purposes only.) The Set-CsManagementConnection cmdlet provides a way for you to provide a new location for the Central Management Database.

Note that any changes you make to Communications Server while using a temporary management connection will not persist if and when you switch back to your original connection. For example, suppose you decide to temporarily use the file system as your store provider. You change the management connection, then create several new voice policies (which will be instantiated as XML files). Suppose you then switch back to your original management connection. When you do so, these new voice policies will disappear; that’s because they were never recorded in the Central Management Database now being used. (However, the XML files will remain in the folder that was designated as the store provider location.)

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 1 --------------------------

Copy Code
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 --------------------------

Copy Code
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.