Skip to main content

Sync-AdcObject

SYNOPSIS​

Replicate a single item between DCs.

SYNTAX​

__AllParameterSets​

Sync-AdcObject [-Object] <string> [-Source] <string> [-Target] <string[]>
 [[-Credential] <pscredential>] [[-Type] <string>] [-Reverse] [<CommonParameters>]

DESCRIPTION​

Replicate a single item between DCs. Can use either WinRM or LDAP to trigger a bulk sync of a single object in parallel.

Use this command to ensure a specific object in AD has been replicated across all targeted DCs.

EXAMPLES​

EXAMPLE 1​

Sync-AdcObject -Object $userAccount -Source $pdc -Target (Get-ADComputer -LdapFilter "(&(primaryGroupID=516)(!(name=$pdc)))").DNSHostName

Replicates the AD object stored in $userAccount across all domain controllers in the current domain.

PARAMETERS​

-Credential​

Credentials tro use for authenticating the operation.

Type: System.Management.Automation.PSCredential
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Object​

The object to replicate. Must be a distinguishedName.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Reverse​

Reverses the replication order in an LDAP-based replication task. In this case, rather than fanning out network connections, the source server is ordered to replicate with each specified target server.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Source​

The server that contains the current state of the targeted object.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Target​

The server(s) that should receive the latest updates for the targeted object.

Type: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Type​

Which protocl should be used to trigger the replication. Can use either LDAP or WinRM, defaults to LDAP.

Type: System.String
DefaultValue: LDAP
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 4
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.