Set-ADForestMode

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

Set-ADForestMode

Sets the forest mode for an Active Directory forest.

構文

Parameter Set: Default
Set-ADForestMode [-Identity] <ADForest> [-ForestMode] <ADForestMode> {UnknownForest | Windows2000Forest | Windows2003InterimForest | Windows2003Forest | Windows2008Forest | Windows2008R2Forest | Windows2012Forest | Windows2012R2Forest} [-AuthType <ADAuthType> {Negotiate | Basic} ] [-Credential <PSCredential> ] [-PassThru] [-Server <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Set-ADForestMode cmdlet sets the forest mode for an Active Directory forest. You specify the forest mode by setting the ForestMode parameter.

The Identity parameter specifies the Active Directory forest to modify. You can identify a forest by its fully qualified domain name (FQDN), GUID, DNS host name, or NetBIOS name. You can also specify the forest by passing a forest object through the pipeline. For example, you can use the Get-ADForest cmdlet to retrieve a forest object and then pass the object through the pipeline to the Set-ADForestMode cmdlet.

Set-ADForestMode prompts for confirmation by default.

パラメーター

-AuthType<ADAuthType>

Specifies the authentication method to use. このパラメーターに対して使用できる値:

-- 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.

-Credential<PSCredential>

Specifies the user account credentials to use to perform this task. The default credentials are the credentials of the currently logged on user unless the cmdlet is run from an Active Directory module for Windows PowerShell provider drive. If the cmdlet is run from such a provider drive, the account associated with the drive is the default. Lin

To specify this parameter, you can type a user name, such as User1 or Domain01\User01 or you can specify a PSCredential object. If you specify a user name for this parameter, the cmdlet prompts for a password.

You can also create a PSCredential object by using a script or by using the Get-Credential cmdlet. You can then set the Credential parameter to the PSCredential object.

If the acting credentials do not have directory-level permission to perform the task, Active Directory module for Windows PowerShell returns a terminating error.

-ForestMode<ADForestMode>

Specifies the forest mode for an Active Directory forest. このパラメーターに対して使用できる値:

-- Windows2000Forest or 0
-- Windows2003InterimForest or 1
-- Windows2003Forest or 2
-- Windows2008Forest or 3
-- Windows2008R2Forest or 4
-- Windows2012Forest or 5
-- Windows2012R2Forest or 6

The values are listed in order of functionality from least to most.

-Identity<ADForest>

Specifies an Active Directory forest object by providing one of the following attribute values. The identifier in parentheses is the Lightweight Directory Access Protocol (LDAP) display name for the attribute. このパラメーターに対して使用できる値:

-- A fully qualified domain name
-- A GUID (objectGUID)
-- A DNS host name
-- A NetBIOS name

The cmdlet searches the default naming context or partition to find the object. If two or more objects are found, the cmdlet returns a non-terminating error.

This parameter can also get this object through the pipeline or you can set this parameter to a forest object instance.

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。

-Server<String>

Specifies the Active Directory Domain Services (AD DS) instance to connect to, by providing one of the following values for a corresponding domain name or directory server. The service may be any of the following: Active Directory Lightweight Directory Services (AD LDS), AD DS, or Active Directory snapshot instance.

Specify the AD DS instance in one of the following ways:

Domain name values:

-- Fully qualified domain name
-- NetBIOS name

Directory server values:

-- Fully qualified directory server name
-- NetBIOS name
-- Fully qualified directory server name and port

The default value for this parameter is determined by one of the following methods in the order that they are listed:

-- By using the Server value from objects passed through the pipeline
-- By using the server information associated with the AD DS Windows PowerShell provider drive, when the cmdlet runs in that drive
-- By using the domain of the computer running Windows PowerShell

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

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

入力

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

• None or Microsoft.ActiveDirectory.Management.ADForest

  A forest object is received by the Identity parameter.

出力

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

• None or Microsoft.ActiveDirectory.Management.ADForest

  Returns the modified forest object when the PassThru parameter is specified. By default, this cmdlet does not generate any output.

注

• This cmdlet does not work with AD LDS.

• This cmdlet does not work with an Active Directory snapshot.

• This cmdlet does not work with a read-only domain controller.

例

Example 1: Set the forest mode for a forest

This command sets the ForestMode to Windows2003Forest in the forest fabrikam.com.

PS C:\> Set-ADForestMode -Identity fabrikam.com -ForestMode Windows2003Forest

Example 2: Set the forest mode for the current user

This example sets the forest mode of the current user's forest. The set operation targets the schema master flexible single master operation (FSMO) role to apply the update.

PS C:\> $CurrentForest = Get-ADForest
PS C:\> Set-ADForestMode -Identity $CurrentForest -Server $CurrentForest.SchemaMaster -ForestMode Windows2008R2Forest

関連トピック

Get-ADForest