API Reference
Get-ADXReplication
Retrieves Active Directory replication data in raw, per-DC summary, or forest summary forms. No shell-outs; uses DirectoryServices.ActiveDirectory and LDAP only.
Examples
Example 1: Raw neighbors (first 20)
Get-ADXReplication | Select-Object -First 20
Example 2: Raw filtered: failures only, stale > 1 day, RPC, Domain partition
Get-ADXReplication -FailuresOnly -StaleDaysRaw 1 -Transport Rpc -Partition Domain
Example 3: Per-DC summary (stale > 2 days)
Get-ADXReplication -Summary -StaleDays 2 | Sort-Object FailedCount -Descending
Example 4: Forest summary (repadmin /replsummary /bydest)
Get-ADXReplication -ForestSummary -By Destination
Common Parameters
This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.
For more information, see about_CommonParameters.
Syntax
Get-ADXReplication [-Credential <PSCredential>] [-Direction <string>] [-Domain <string>] [-DomainController <string[]>] [-FailuresOnly] [-GroupBy <string>] [-IncludeEventLogs] [-NamingContext <string>] [-Neighbor <string[]>] [-NeighborMatch <string[]>] [-Partition <string>] [-PreferredDomainController <string>] [-QueryMode <Auto|Drsr|Sda>] [-StaleDaysRaw <int>] [-Transport <string>] [<CommonParameters>]#By GroupByParameters
- Credential PSCredential
- Optional alternate credential for replication queries.
- Direction string
- Direction filter for raw output.
- Domain string
- Limit raw neighbor discovery to a specific domain. When omitted, uses the current domain.
- DomainController string[]
- Limit queries to specific domain controllers (skip automatic discovery).
- FailuresOnly SwitchParameter
- Filter to replication failures only.
- GroupBy string
- Group raw output by site or server.
- IncludeEventLogs SwitchParameter
- Include replication-related event logs where applicable.
- NamingContext string
- Optional naming context filter (DN) for raw/showrepl queries.
- Neighbor string[]
- Filter to specific neighbor DNs/servers.
- NeighborMatch string[]
- Wildcard filters for neighbor names.
- Partition string
- Partition filter.
- PreferredDomainController string
- Optional preferred domain controller to target first.
- QueryMode ReplicationQueryMode
- Selects replication data source (Auto/Drsr/Sda). Possible values: Auto, Drsr, Sda
- Possible values:
Auto,Drsr,Sda - StaleDaysRaw int
- Minimum staleness (days) for raw neighbors.
- Transport string
- Transport filter.
Outputs
ADPlayground.Replication.ReplicationForestStats, ADPlayground.Replication.ReplicationForestSummary, ADPlayground.Replication.ReplicationGroupSummary, ADPlayground.Replication.ReplicationShowReplRow, ADPlayground.Replication.ReplicationStatus, ADPlayground.Replication.ReplicationSummary
Get-ADXReplication [-Credential <PSCredential>] [-Direction <string>] [-Domain <string>] [-DomainController <string[]>] [-FailuresOnly] [-NamingContext <string>] [-Neighbor <string[]>] [-NeighborMatch <string[]>] [-Partition <string>] [-PreferredDomainController <string>] [-QueryMode <Auto|Drsr|Sda>] [-ShowReplicationDetails] [-StaleDaysRaw <int>] [-Transport <string>] [<CommonParameters>]#By ShowReplicationDetailsParameters
- Credential PSCredential
- Optional alternate credential for replication queries.
- Direction string
- Direction filter for raw output.
- Domain string
- Limit raw neighbor discovery to a specific domain. When omitted, uses the current domain.
- DomainController string[]
- Limit queries to specific domain controllers (skip automatic discovery).
- FailuresOnly SwitchParameter
- Filter to replication failures only.
- NamingContext string
- Optional naming context filter (DN) for raw/showrepl queries.
- Neighbor string[]
- Filter to specific neighbor DNs/servers.
- NeighborMatch string[]
- Wildcard filters for neighbor names.
- Partition string
- Partition filter.
- PreferredDomainController string
- Optional preferred domain controller to target first.
- QueryMode ReplicationQueryMode
- Selects replication data source (Auto/Drsr/Sda). Possible values: Auto, Drsr, Sda
- Possible values:
Auto,Drsr,Sda - ShowReplicationDetails SwitchParameter
- Emit repadmin /showrepl style rows (per naming context).
- StaleDaysRaw int
- Minimum staleness (days) for raw neighbors.
- Transport string
- Transport filter.
Outputs
ADPlayground.Replication.ReplicationForestStats, ADPlayground.Replication.ReplicationForestSummary, ADPlayground.Replication.ReplicationGroupSummary, ADPlayground.Replication.ReplicationShowReplRow, ADPlayground.Replication.ReplicationStatus, ADPlayground.Replication.ReplicationSummary
Get-ADXReplication [-Credential <PSCredential>] [-IncludeEventLogs] [-IncludeSysvol] [-IncludeTopology] [-PreferredDomainController <string>] [-QueryMode <Auto|Drsr|Sda>] [-StaleDays <int>] [-Summary] [-SummaryDomain <string>] [-SummaryDomainController <string[]>] [-SummaryPartition <string>] [-SysvolBacklogCritical <int>] [-SysvolBacklogWarning <int>] [-TestPing] [-TestPorts] [<CommonParameters>]#By IncludeSysvol + IncludeTopologyParameters
- Credential PSCredential
- Optional alternate credential for replication queries.
- IncludeEventLogs SwitchParameter
- Include replication-related event logs where applicable.
- IncludeSysvol SwitchParameter
- Include SYSVOL replication snapshot for the scoped domain.
- IncludeTopology SwitchParameter
- Emit topology risk indicators (disabled connections, worst edges) in summary output.
- PreferredDomainController string
- Optional preferred domain controller to target first.
- QueryMode ReplicationQueryMode
- Selects replication data source (Auto/Drsr/Sda). Possible values: Auto, Drsr, Sda
- Possible values:
Auto,Drsr,Sda - StaleDays int
- Consider neighbors stale when last success is older than this many days.
- Summary SwitchParameter
- Switch to return per-DC summary (repadmin /replsummary style).
- SummaryDomain string
- Limit summary scope to a specific domain; null for all domains.
- SummaryDomainController string[]
- Limit summary queries to specific domain controllers (skip automatic discovery).
- SummaryPartition string
- Filter summary by partition kind.
- SysvolBacklogCritical int
- DFSR backlog critical threshold when emitting SYSVOL summary.
- SysvolBacklogWarning int
- DFSR backlog warning threshold when emitting SYSVOL summary.
- TestPing SwitchParameter
- Ping involved domain controllers (summary path only).
- TestPorts SwitchParameter
- Test replication-related TCP ports against the involved domain controllers (summary path only).
Outputs
ADPlayground.Replication.ReplicationForestStats, ADPlayground.Replication.ReplicationForestSummary, ADPlayground.Replication.ReplicationGroupSummary, ADPlayground.Replication.ReplicationShowReplRow, ADPlayground.Replication.ReplicationStatus, ADPlayground.Replication.ReplicationSummary
Get-ADXReplication [-Buckets <int[]>] [-By <string>] [-ByDestination] [-BySource] [-Credential <PSCredential>] [-ForestSummary] [-ForestSummaryDomain <string>] [-PreferredDomainController <string>] [-QueryMode <Auto|Drsr|Sda>] [-StaleDaysForest <int>] [-Stats] [<CommonParameters>]#By Buckets + ByParameters
- Buckets int[]
- Optional custom bucket edges for histogram (e.g., 1,3,7).
- By string
- Group summary by Destination or Source.
- ByDestination SwitchParameter
- Shortcut to set By=Destination.
- BySource SwitchParameter
- Shortcut to set By=Source.
- Credential PSCredential
- Optional alternate credential for replication queries.
- ForestSummary SwitchParameter
- Emit forest-wide replication summary (repadmin /replsummary-like).
- ForestSummaryDomain string
- Optional forest DNS name to scope the summary.
- PreferredDomainController string
- Optional preferred domain controller to target first.
- QueryMode ReplicationQueryMode
- Selects replication data source (Auto/Drsr/Sda). Possible values: Auto, Drsr, Sda
- Possible values:
Auto,Drsr,Sda - StaleDaysForest int
- Staleness threshold (days) used for forest stats.
- Stats SwitchParameter
- Include aggregated stats (staleness buckets or threshold view).
Outputs
ADPlayground.Replication.ReplicationForestStats, ADPlayground.Replication.ReplicationForestSummary, ADPlayground.Replication.ReplicationGroupSummary, ADPlayground.Replication.ReplicationShowReplRow, ADPlayground.Replication.ReplicationStatus, ADPlayground.Replication.ReplicationSummary