Manually starts the Microsoft Communications Server 2010 replication process. You can choose to trigger replication throughout the entire system or only on a specified computer.
Syntax
Invoke-CsManagementStoreReplication [-ReplicaFqdn <String>] [-Force <SwitchParameter>] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
ReplicaFqdn |
Optional |
String |
Fully qualified domain name of the computer where replication should be initiated. For example: -ReplicaFqdn "atl-cs-001.litwareinc.com". If this parameter is not included, then replication will be initiated on all your Communications Server computers. |
|
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.
Replication typically requires no human intervention; in fact, it’s usually best to let the Master Replicator handle the replication process. However, there might be occasions when you need to immediately initiate replication on a computer (or a group of computers) without waiting for the standard replication cycle to run its course. Should such an occasion arise, you can manually replicate information to a computer by using the Invoke-CsManagementStoreReplication cmdlet.
Return Types
Invoke-CsManagementStoreReplication does not return any objects. Instead, the cmdlet manipulates instances of the Microsoft.Rtc.Management.Xds.ReplicationState object.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
Invoke-CsManagementStoreReplication |
|
In the preceding example Invoke-CsManagementStoreReplication is called without any parameters. This forces replication to take place on all Communications Server 2010 computers.
-------------------------- Example 2 --------------------------
| Copy Code |
|
|---|---|
Invoke-CsManagementStoreReplication -ReplicaFQDN atl-cs-001.litwareinc.com |
|
In Example 2, the -ReplicaFQDN parameter is used when calling Invoke-CsManagementStoreReplication. That causes replication to take place only on the computer atl-cs-001.litwareinc.com.