New-CMActiveDirectoryForest

Configuration Manager で 1 つ以上の Active Directory フォレスト オブジェクトを作成します。

構文

New-CMActiveDirectoryForest
   [-Description <String>]
   [-EnableDiscovery <Boolean>]
   -ForestFqdn <String>
   [-Password <SecureString>]
   [-PublishingPath <String>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-CMActiveDirectoryForest コマンドレットは、完全修飾ドメイン名 (FQDN)、説明、および指定した発行パスを持つ Active Directory フォレスト オブジェクトを作成します。

Active Directory フォレストの探索方法を構成した場合は、Active Directory フォレストの検出を有効にすることができます。 検出を有効にすると、Configuration Manager によって Active Directory サイトとサブネットが検出されます。

Active Directory フォレストの検出には、信頼されていないフォレストを検出または発行するグローバル アカウントが必要です。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例 1: 検出が有効になっている Active Directory フォレスト オブジェクトを作成する

PS XYZ:\> New-CMActiveDirectoryForest -ForestFqdn "tsqa.contoso.com" -EnableDiscovery $True

このコマンドは、FQDN tsqa.contoso.com があり、検出が有効になっている Active Directory フォレスト オブジェクトを作成します。 検出を機能させるには、Active Directory フォレスト検出方法を構成する必要があります。

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

Active Directory フォレスト オブジェクトの説明を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableDiscovery

Active Directory サイトとサブネットを検出するかどうかを指定します。 検出を有効にする場合は、Active Directory フォレスト検出方法を構成する必要があります。 既定値は $False です。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForestFqdn

Configuration Manager オブジェクトの FQDN を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Password

{{ Fill Password Description }}

型:SecureString
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PublishingPath

サイト情報を Active Directory フォレストに発行する 1 つ以上の Configuration Manager サイトを指定します。 コンマ区切りの一覧を引用符で囲んで、複数のサイトを指定できます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UserName

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

IResultObject