Repadmin /replicate
Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2, Windows Server 2008, Windows Server 2008 R2
Triggers the immediate replication of the specified directory partition to a destination domain controller from a source domain controller.
The /replicate command tests replication success after you remove suspected fault conditions without waiting for the replication schedule to open.
You can refer to the source or destination domain controller in any of the following ways:
By its single-label host name
By its fully qualified host name
By the globally unique identifier (GUID) that is assigned to the NTDS Settings object for the domain controller
You can obtain the GUID for the directory system agent (DSA) object from the header of the output of the following command:
repadmin /showrepl <name of domain controller>.
The computer where you run Repadmin, the destination domain controller, and the source domain controller must use the same network protocols that are used by the relevant connection object and have network connectivity over the same ports that are used by that connection object.
For examples of how to use this command, see Examples.
Syntax
repadmin /replicate <Dest_DSA_List> <Naming Context> /allsources [/force] [/async] [/full] [/addref] [/readonly]
repadmin /replicate <Dest_DSA_List> <Source_DSA_Name> <Naming Context> [/force]
Parameters
| Parameter | Description | ||
|---|---|---|---|
<Dest_DSA_List> |
Specifies the single-label host name of a domain controller or a list of domain controllers that are separated in the list by single spaces. For detailed syntax, see Repadmin. |
||
<Source_DSA_Name> |
Specifies the host name of a source domain controller. |
||
/allsources |
Specifies that replication on the destination domain controllers occurs with all replication partners.
|
||
/force |
Allows the caller to override connections that an administrator has disabled by using repadmin /options and allows replication with corrupt and divergent partners. Do not use this parameter if you suspect that Update Sequence Number (USN) Rollback has occurred. |
||
/async |
Specifies that replication is asynchronous. That is, Repadmin starts the replication event, but it does not expect an immediate response from the destination domain controller. Use this parameter to start the KCC, if you do not want to wait for KCC to finish. |
||
/full |
Requests that the source domain controller replicate all changes again for the specified partition. This command resets the up-to-dateness vector (UTDVEC) and the high watermark This parameter does not remove lingering objects on the destination domain controller. Do not use this parameter if you suspect USN Rollbacks has occurred. |
||
/addref |
Enables change notification between the source and destination domain controllers. |
||
/readonly |
Specifies that the destination domain controller holds a read-only copy of the partition that is replicated. |
.gif)
NoteExamples
The following example replicates the Contoso naming context from source-dc01 to dest-dc01:
repadmin /replicate dest-dc01 source-dc01 DC=contoso,DC=com
The following command replicates the Mayberry naming context from source-dc01 to dest-dc01 and specifies that the naming context is read-only on the destination domain controller:
repadmin /replicate dest-dc01 source-dc01 DC=Mayberry,DC=contoso,DC=com /readonly