New-ADDCCloneConfigFile

Syntax

New-ADDCCloneConfigFile
   [-CloneComputerName <String>]
   [-IPv4DNSResolver <String[]>]
   [-Path <String>]
   [-SiteName <String>]
   [<CommonParameters>]

New-ADDCCloneConfigFile
   [-AlternateWINSServer <String>]
   [-CloneComputerName <String>]
   [-IPv4Address <String>]
   [-IPv4DefaultGateway <String>]
   [-IPv4DNSResolver <String[]>]
   [-IPv4SubnetMask <String>]
   [-IPv6DNSResolver <String[]>]
   [-Offline]
   -Path <String>
   [-PreferredWINSServer <String>]
   [-SiteName <String>]
   [-Static]
   [<CommonParameters>]

New-ADDCCloneConfigFile
   [-AlternateWINSServer <String>]
   [-CloneComputerName <String>]
   -IPv4Address <String>
   [-IPv4DefaultGateway <String>]
   -IPv4DNSResolver <String[]>
   -IPv4SubnetMask <String>
   [-Path <String>]
   [-PreferredWINSServer <String>]
   [-SiteName <String>]
   [-Static]
   [<CommonParameters>]

New-ADDCCloneConfigFile
   [-CloneComputerName <String>]
   [-IPv6DNSResolver <String[]>]
   [-Path <String>]
   [-SiteName <String>]
   [<CommonParameters>]

New-ADDCCloneConfigFile
   [-CloneComputerName <String>]
   -IPv6DNSResolver <String[]>
   [-Path <String>]
   [-SiteName <String>]
   [-Static]
   [<CommonParameters>]

Description

The New-ADDCCloneConfigFile cmdlet performs prerequisite checks for cloning a domain controller when run locally on the domain controller being prepared for cloning. This cmdlet generates a clone configuration file, DCCloneConfig.xml, at an appropriate location, if all prerequisite checks succeed.

There are two modes of operation for this cmdlet, depending on where it is executed. When run on the domain controller that is being prepared for cloning, it will run the following pre-requisite checks to make sure this domain controller is adequately prepared for cloning:

• Is the PDC emulator FSMO role hosted on a domain controller running Windows Server 2012?
• Is this computer authorized for domain controller cloning (i.e. is the computer a member of the Cloneable Domain Controllers group)?
• Are all program and services listed in the output of the Get-ADDCCloningExcludedApplicationList cmdlet captured in CustomDCCloneAllowList.xml?

If these pre-requisite checks all pass, the New-ADDCCloneConfigFile cmdlet will generate a DCCloneConfig.xml file at a suitable location based on the parameter values supplied. This cmdlet can also be run from a client, with Remote Server Administration Tools, and used to generate a DCCloneConfig.xml against offline media of the domain controller being cloned; however, none of the pre-requisite checks is performed in this usage mode. This usage is intended to generate DCCloneConfig.xml files with specific configuration values for each clone on copies of the offline media.

Examples

Example 1: Create a clone domain controller with a static IPv4 address

PS C:\> New-ADDCCloneConfigFile -Static -IPv4Address "10.0.0.2" -IPv4DNSResolver "10.0.0.1" -IPv4SubnetMask "255.255.255.0" -CloneComputerName "VirtualDC2" -IPv4DefaultGateway "10.0.0.3" -PreferredWINSServer "10.0.0.1" -SiteName "REDMOND"

This command creates a clone domain controller named VirtualDC2 with a static IPv4 address.

Example 2: Create a clone domain controller with a static IPv6 settings

PS C:\> New-ADDCCloneConfigFile -Static -CloneComputerName "Clone1" -IPv6DNSResolver "FEC0:0:0:FFFF::1"

This command creates a clone domain controller named Clone1 with a static IPv6 setting.

Example 3: Create a clone domain controller with a dynamic IPv4 settings

PS C:\> New-ADDCCloneConfigFile -AlternateWINSServer "10.0.0.3" -CloneComputerName "Clone2"-IPv4DNSResolver "10.0.0.1" -PreferredWINSServer "10.0.0.1"

This command creates a clone domain controller named Clone2 with dynamic IPv4 settings.

Example 4: Create a clone domain controller with a dynamic IPv6 settings

PS C:\> New-ADDCCloneConfigFile -IPv6DNSResolver "FEC0:0:0:FFFF::1" -SiteName "REDMOND"

This command creates a clone domain controller with dynamic IPv6 settings.

Example 5: Create a clone domain controller with a static IPv4 and IPv6 settings

PS C:\> New-ADDCCloneConfigFile -Static -IPv4Address "10.0.0.2" -IPv4DNSResolver "10.0.0.1" -IPv4SubnetMask "255.255.255.0" -Static -IPv6DNSResolver "FEC0:0:0:FFFF::1" -CloneComputerName "Clone2" -PreferredWINSServer "10.0.0.1"

This command creates a clone domain controller named Clone2 with static IPv4 and static IPv6 settings.

Example 6: Create a clone domain controller with a static IPv4 and dynamic IPv6 settings

PS C:\> New-ADDCCloneConfigFile -IPv4Address "10.0.0.2" -IPv4DNSResolver "10.0.0.1" -IPv4SubnetMask "255.255.255.0" -IPv4DefaultGateway "10.0.0.3" -IPv6DNSResolver "FEC0:0:0:FFFF::1"

This command creates a clone domain controller named Clone2 with static IPv4 and dynamic IPv6 settings.

Example 7: Create a clone domain controller with a dynamic IPv4 and static IPv6 settings

PS C:\> New-ADDCCloneConfigFile -Static -IPv6DNSResolver "FEC0:0:0:FFFF::1" -CloneComputerName "Clone1" -PreferredWINSServer "10.0.0.1" -SiteName "REDMOND"

This command creates a clone domain controller named Clone1 with dynamic IPv4 and static IPv6 settings.

Example 8: Create a clone domain controller in offline mode in a specified site

PS C:\> New-DCCloneConfig -Offline -CloneComputerName "CloneDC1" -SiteName CONTOSO -Path F:\Windows\NTDS -Force

This command creates a clone domain controller named CloneDC1 in offline mode, in a site called CONTOSO with a dynamic IPv4 address. This command also uses the Force parameter to force overwrite of any previous DCCloneConfig.xml file created at the specified path, F:\Windows\NTDS.

Parameters

-AlternateWINSServer

-CloneComputerName

-IPv4Address

-IPv4DefaultGateway

-IPv4DNSResolver

-IPv4SubnetMask

-IPv6DNSResolver

-Offline

-Path

-PreferredWINSServer

-SiteName

-Static

Inputs

None

Outputs

None

Related Links

• Get-ADDCCloningExcludedApplicationList
• AD DS Administration Cmdlets in Windows PowerShell