Set-CsManagementServer
Topic Last Modified: 2012-03-26
Modifies the replication port used by the Microsoft Lync Server 2010 Central Management service.
Syntax
Set-CsManagementServer [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-ReplicationServicePort <UInt16>] [-WhatIf [<SwitchParameter>]]
Detailed Description
The Central Management service is responsible for replicating data between the Central Management store and computers running Lync Server 2010 services or server roles. The Central Management service runs on a single Front End pool (or a single Standard Edition server) and facilitates replication throughout the Lync Server infrastructure.
The Set-CsManagementServer cmdlet enables you to specify the port that the Central Management service uses for replication.
Who can run this cmdlet: By default, members of the following groups are authorized to run the Set-CsManagementServer cmdlet locally: RTCUniversalServerAdmins. 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 "Set-CsManagementServer"}
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
Identity |
Optional |
Xds Identity |
Unique identifier for the Central Management service. For example: -Identity "ManagementServer:atl-cs-001.litwareinc.com". Note that you can leave off the prefix "ManagementServer:" when specifying a Central Management Server. For example: -Identity "atl-cs-001.litwareinc.com". |
ReplicationServicePort |
Optional |
Integer |
Port number for the replication port used by the Central Management service. |
Force |
Optional |
Switch Parameter |
Suppresses the display of any non-fatal error message that might occur when running the command. |
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. Set-CsManagementServer does not accept pipelined input.
Return Types
Set-CsManagementServer does not return any objects or values. Instead, the cmdlet modifies existing instances of the Microsoft.Rtc.Management.Xds.DisplayManagementServer object.
Example
-------------------------- Example 1 ------------------------
Set-CsManagementServer -Identity "ManagementServer:atl-cs-001.litwareinc.com" -ReplicationServicePort 5076
The command shown in Example 1 connects to the Central Management service with the Identity ManagementServer:atl-cs-001.litwareinc.com and sets the replication service port to port 5076.