Returns information about the Microsoft Communications Server 2010 replication process; this includes information on whether replication is currently up-to-date for your Communications Server computers.
Syntax
Get-CsManagementStoreReplicationStatus [-ReplicaFqdn <String>] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
ReplicaFqdn |
Optional |
String |
Fully qualified domain name of the computer whose replication status is to be verified. For example: -ReplicaFqdn "atl-cs-001.litwareinc.com". If this parameter is not included, then replication status information for all your Communications Server computers will be returned. |
|
Force |
Optional |
Switch Parameter |
Suppresses the display of any non-fatal error message that might arise when running the command. |
Detailed Description
When an administrator makes a change of some kind to Microsoft Communications Server (for example, when an administrator creates a new voice policy or changes the Address Book Server configuration settings) that change is recorded in the Central Management Database. In turn, the change must then be replicated to all the computers running Communications Server services or server roles.
In order to replicate data, the Master Replicator (running on the Central Management Server) creates a snapshot of the modified configuration data; a copy of this snapshot is then sent to each computer running Communications Server services or server roles. On those computers, a Local Replicator receives the snapshot and uploads the modified data; the Local Replicator then sends the Master Replicator a message stating that replication is complete.
As an administrator, it’s important to know the current status of the replication process. After all, sometimes "problems" aren’t really problems; instead, the changes you have made simply haven’t had time to replicate out to all your computers. The Get-CsManagementStoreReplicationStatus cmdlet enables you to verify the replication status for any (or all) of the Communications Server computers in your organization.
Return Types
Get-CsManagementStoreReplicationStatus returns instances of the Microsoft.Rtc.Management.Xds.ReplicationState object.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
Get-CsManagementStoreReplicationStatus |
|
In Example 1, Get-CsManagementStoreReplicationStatus is called without any parameters; that returns the replication status (up-to-date or not up-to-date) for all Communications Server computers.
-------------------------- Example 2 --------------------------
| Copy Code |
|
|---|---|
Get-CsManagementStoreReplicationStatus | Where-Object {$_.UpToDate -eq $False}
|
|
Example 2 returns a collection of all the computers where replication is not up-to-date. This is done by first using Get-CsManagementStoreReplicationStatus to retrieve a collection containing the replication status for all the servers. This collection is then piped to the Where-Object cmdlet, which applies a filter that limits the returned data to computers where the UpToDate property is False.
-------------------------- Example 3 --------------------------
| Copy Code |
|
|---|---|
Get-CsManagementStoreReplicationStatus -ReplicaFqdn atl-cs-001.litwareinc.com |
|
In Example 3, returned data is limited to a single computer: atl-cs-001.litwareinc.com/
-------------------------- Example 4 --------------------------
| Copy Code |
|
|---|---|
Get-CsManagementStoreReplicationStatus | Where-Object {$_.LastUpdateCreation -lt "8/11/2010 8:00 PM"}
|
|
Example 4 returns information about the computers that were last replicated prior to 8:00 PM on August 11, 2010. To do this, Get-CsManagementStoreReplicationStatus is first called to return replication information for all your Communications Server computers. This information is then piped to the Where-Object cmdlet, which selects only those computers where the LastUpdateCreation property is less than (-lt) 8:00 PM on August 11, 2010 (8/11/2010 8:00 PM). To return information about computers that were last replicated after 8:00 PM on August 11, 2010 use the -gt (greater than) operator:
Where-Object {$_.LastUpdateCreation -gt "8/11/2010 8:00 PM"}