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

Returns information about the management connection to the Central Management Database.

Syntax

Get-CsManagementConnection

Parameters

Parameter Required Type Description

Verbose

Optional

Switch Parameter

Reports detailed activity to the screen as the cmdlet runs.

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.) If you change the management connection (which is done using the Set-CsManagementConnection cmdlet) Get-CsManagementConnection will return information about the new location. (Incidentally, computers running Communications Server use this cmdlet to retrieve connection information rather than directly retrieving that information from Active Directory.)

Return Types

Get-CsManagementConnection returns instances of the Microsoft.Rtc.Management.Xds.ManagementConnection object.

Examples

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

Copy Code
Get-CsManagementConnection

The command in Example 1 returns information about the management connections to the settings database.