Share via


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.

See Also

Other Resources

Get-CsService
Move-CsManagementServer