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.

Note
In Windows Server 2008 R2, the /allsources parameter is deprecated.

/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.

Examples

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

Additional references

Command-Line Syntax Key

Repadmin