Repadmin /showrepl

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

Displays the replication status when the specified domain controller last attempted to perform inbound replication of Active Directory partitions.

The repadmin /showrepl command helps you understand the replication topology and replication failures. It reports status for each source domain controller from which the destination has an inbound connection object. The status report is categorized by directory partition.

The administrative workstation on which you run Repadmin must have remote procedure call (RPC) network connectivity to all domain controllers that are targeted by the DSA_LIST parameter.

Replication errors may be caused by the source domain controller; destination domain controller; or any component of the replication process, including the underlying network.

In Windows Server 2003 and Windows Server 2008, Repadmin does not display outbound partners for intrasite replication as it did in the Microsoft Windows 2000 Server operating system. Use the /repsto parameter to display outbound partners.

For examples of how to use this command, see Examples.

Syntax

repadmin /showrepl [DSA_LIST [Source DSA object GUID]] [Naming Context] [/verbose] [/nocache] [/repsto] [/conn] [/all] [/errorsonly] [/intersite] [/csv]

Parameters

Parameter Description

DSA_LIST

Specifies the 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 object GUID

Specifies the unique hexadecimal number that identifies the object whose replication events are listed.

Naming Context

Specifies the distinguished name of the directory partition to replicate.

/verbose

Displays additional information about the source partners from which the destination domain controller performs inbound replication. The information includes fully qualified CNAME, invocation ID, replication flags, and update sequence number (USN) values for originating update and replicated updates.

/nocache

Specifies that globally unique identifiers (GUIDs) are left in hexadecimal form. By default, GUIDs are translated into strings.

/repsto

Lists the partner domain controllers with which the targeted domain controllers use change notification to perform outbound replication. (Partner domain controllers in this case are domain controllers in the same Active Directory site as the source domain controller and domain controllers that are in remote sites where change notification has been enabled.) This list is appended under OUTBOUND NEIGHBORS FOR CHANGE NOTIFICATIONS of the Repadmin output.

/conn

Appends a KCC CONNECTION OBJECTS section to the Repadmin output that lists all connections and why they were created.

/all

Runs both the /repsto and the /conn parameters.

/errorsonly

Displays replication status only for source domain controllers with which the destination domain controller encounters replication errors.

/intersite

Displays the replication status for connections from domain controllers in remote sites from which the domain controller that is listed in the DSA_LIST parameter performs inbound replication.

/csv

Displays the results in a comma-separated-value (CSV) format.

Examples

The following example reports the inbound replication status for all domain controllers in the forest output in CSV format that is ideal for viewing forest-wide replication status in a spreadsheet application such as Microsoft Excel:

repadmin /showrepl * /csv

Note

For more information about how to import a CSV file to Excel, see Import or export text files (https://go.microsoft.com/fwlink/?LinkId=104206).

The following example reports the inbound replication status for all domain controllers in the forest that are experiencing a replication error:

repadmin /showrepl * /errorsonly

The following example reports the inbound replication status for all domain controllers in the site named HQ that perform inbound replication of a read-only or writable copy of the mayberry.contoso.com domain partition:

repadmin /showrepl site:HQ DC=Mayberry,DC=Contoso,dc=Com

Additional references

Command-Line Syntax Key

Repadmin