New-ADDCCloneConfigFile

適用対象: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

New-ADDCCloneConfigFile

Performs prerequisite checks for cloning a domain controller and generates a clone configuration file if all checks succeed.

構文

Parameter Set: IPv4DynamicSettings
New-ADDCCloneConfigFile [-CloneComputerName <String> ] [-IPv4DNSResolver <String[]> ] [-Path <String> ] [-SiteName <String> ] [ <CommonParameters>]

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

Parameter Set: IPv6DynamicSettings
New-ADDCCloneConfigFile [-CloneComputerName <String> ] [-IPv6DNSResolver <String[]> ] [-Path <String> ] [-SiteName <String> ] [ <CommonParameters>]

Parameter Set: IPv6StaticSettings
New-ADDCCloneConfigFile -IPv6DNSResolver <String[]> -Static [-CloneComputerName <String> ] [-Path <String> ] [-SiteName <String> ] [ <CommonParameters>]

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

詳細説明

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.

パラメーター

-AlternateWINSServer<String>

Specifies the name of the alternate Windows Internet Naming Service (WINS) server for the cloned domain controller to use if the preferred WINS Server is not available.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-CloneComputerName<String>

Specifies the computer name for the cloned domain controller. If this parameter is not specified as a unique name within the enterprise of 15 characters or less, the following formula is used to programmatically generate a name:

-- The first eight characters of the source domain controller computer name. For instance, a source computer name of SourceComputer is truncated to a prefix string of SourceCo.
-- A unique naming suffix of the format –CLnnnn is appended to the prefix string where nnnn is the next available value from 0001-9999 that the primary domain controller (PDC) determines is not currently in use. For example, if 0047 is the next available number within the allowed range, using the above source computer prefix of SourceCo the derived name to use for the clone computer will be SourceCo-CL0047.

エイリアス

cn

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-IPv4Address<String>

Specifies the Internet Protocol version 4 (IPv4) address to be assigned to the cloned domain controller.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-IPv4DefaultGateway<String>

Specifies the Internet Protocol version 4 (IPv4) address for the default gateway to be used by the cloned domain controller.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-IPv4DNSResolver<String[]>

Specifies the Internet Protocol version 4 (IPv4) address for the DNS server to be used by the cloned domain controller to resolve names. A maximum of four string values can be provided.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-IPv4SubnetMask<String>

Specifies the Internet Protocol version 4 (IPv4) subnet mask to use for the subnet where the cloned domain controller is to be located.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-IPv6DNSResolver<String[]>

Specifies the Internet Protocol version 6 (IPv6) address for the DNS server to be used by the cloned domain controller to resolve names.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Offline

Indicates whether the cmdlet is being run against an offline media or on the domain controller being prepared for cloning.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Path<String>

Specifies the folder path to use when writing the clone configuration file. If the cmdlet is run and all prerequisite checks succeed, a DCCloneConfig.xml file will be written and appear in this location as output. The Path parameter is optional when running the cmdlet on the domain controller being prepared for cloning. In this case, the default location of the DIT folder will be used and this parameter does not need to be specified. When running the New-ADCCLoneConfigFile cmdlet in offline mode (i.e. when the Offline parameter is specified), however, the Path parameter is required.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-PreferredWINSServer<String>

Specifies the name of the primary Windows Internet Naming Service (WINS) server to use as the preferred WINS Server for the cloned domain controller.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-SiteName<String>

Specifies the name of the Active Directory site in which to place the cloned domain controller.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Static

Indicates whether the TCP/IP configuration specified for the cloned domain controller is static or dynamic IP configuration.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

  • None

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

  • None

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

This command creates a clone domain controller named VirtualDC2 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"

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

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

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

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

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

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

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

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

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

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

This command creates a clone domain controller named Clone2 with static IPv4 and static 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"

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

This command creates a clone domain controller named Clone2 with 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"

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

This command creates a clone domain controller named Clone1 with 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"

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

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.

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

関連トピック

Get-ADDCCloningExcludedApplicationList

AD DS Administration Cmdlets in Windows PowerShell