COMMAND EVERYTHING.

New-ADReplicationSite

Creates an Active Directory replication site in the directory.

Last verified: 2026-10-26

Microsoft ActiveDirectory reference: Creates an Active Directory replication site in the directory. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.

New-ADReplicationSite [-WhatIf] [-Confirm] [-AuthType <ADAuthType>]
 [-AutomaticInterSiteTopologyGenerationEnabled <Boolean>] [-AutomaticTopologyGenerationEnabled <Boolean>]
 [-Credential <PSCredential>] [-Description <String>] [-Instance <ADReplicationSite>]
 [-InterSiteTopologyGenerator <ADDirectoryServer>] [-ManagedBy <ADPrincipal>] [-Name] <String>
 [-OtherAttributes <Hashtable>] [-PassThru] [-ProtectedFromAccidentalDeletion <Boolean>]
 [-RedundantServerTopologyEnabled <Boolean>] [-ReplicationSchedule <ActiveDirectorySchedule>]
 [-ScheduleHashingEnabled <Boolean>] [-Server <String>] [-TopologyCleanupEnabled <Boolean>]
 [-TopologyDetectStaleEnabled <Boolean>] [-TopologyMinimumHopsEnabled <Boolean>]
 [-UniversalGroupCachingEnabled <Boolean>] [-UniversalGroupCachingRefreshSite <ADReplicationSite>]
 [-WindowsServer2000BridgeheadSelectionMethodEnabled <Boolean>]
 [-WindowsServer2000KCCISTGSelectionBehaviorEnabled <Boolean>] [-WindowsServer2003KCCBehaviorEnabled <Boolean>]
 [-WindowsServer2003KCCIgnoreScheduleEnabled <Boolean>]
 [-WindowsServer2003KCCSiteLinkBridgingEnabled <Boolean>] [<CommonParameters>]

Required permissions

Use an account with the target resource permissions documented for New-ADReplicationSite. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / ActiveDirectory · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-AuthType

Specifies the authentication method to use. The acceptable values for this parameter are: - Negotiate or 0 - Basic or 1 The default authentication method is Negotiate. A Secure Sockets Layer (SSL) connection is required for the Basic authentication method.

-AutomaticInterSiteTopologyGenerationEnabled

Indicates whether the cmdlet prevents the Knowledge Consistency Checker (KCC) that functions as the intersite topology generator (ISTG) from generating connections for intersite replication. Use this option when you want to create manual intersite connections (disable the ISTG) but retain the KCC to generate intrasite connections.

-AutomaticTopologyGenerationEnabled

Indicates whether to enable automatic topology generation. When enabled, prevents the KCC from generating intrasite connections on all servers in the site. Disable this option if you use manual connections and do not want the KCC to build connections automatically.

-Confirm

Prompts you for confirmation before running the cmdlet.

-Credential

Specifies a user account that has permission to perform this action. The default is the current user. Type a user name, such as User01 or Domain01\User01, or enter a PSCredential object, such as one generated by the Get-Credential cmdlet. If you type a user name, you will be prompted for a password. This parameter is not supported by any providers installed with Windows PowerShell.

-Description

Specifies a description of the object. This parameter sets the value of the Description property for the object. The Lightweight Directory Access Protocol (LDAP) display name (ldapDisplayName) for this property is description.

-Instance

Specifies an instance of a site object to use as a template for a new site object. You can use an instance of an existing site object as a template or you can construct a new site object by using the Windows PowerShell command line or by using a script. Method 1: Use an existing site object as a template for a new object. To retrieve an instance of an existing site object, use the Get-ADReplicationSite cmdlet. Then provide this site object to the *Instance* parameter of the New-ADReplicationSite cmdlet to create a new site object. You can override property values of the new object by setting the appropriate parameters. Method 2: Create a new ADReplicationSite and set the property values by using the Windows PowerShell command line interface. Then pass this object to the *Instance* parameter of the New-ADReplicationSite cmdlet to create the new site object. Note: Specified attributes are not validated, so attempting to set attributes that do not exist or cannot be set will raise an error.

Prerequisites

Windows with the ActiveDirectory module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.

Security considerations

This cmdlet changes system state. Review every target and parameter in the official reference, test outside production, and prepare an appropriate backup or rollback. Do not execute the example automatically.

Examples

New-ADReplicationSite -Name "NorthAmerica"

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/ActiveDirectory/New-ADReplicationSite.md

https://learn.microsoft.com/powershell/module/activedirectory/new-adreplicationsite?view=windowsserver2025-ps

Explain or customize this command with AI

Related commands

Get-ADComputer

Get-ADGroup

Get-ADGroupMember

Get-ADPrincipalGroupMembership