Test-DscConfiguration

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Path] <String>
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    -ReferenceConfiguration <String>
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

Test-DscConfiguration
    [-Path] <String>
    -CimSession <CimSession[]>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

Test-DscConfiguration
    -CimSession <CimSession[]>
    -ReferenceConfiguration <String>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

Test-DscConfiguration
    -CimSession <CimSession[]>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Test-DscConfiguration コマンドレットは、ノードの実際の構成が目的の構成と一致するかどうかをテストします。 コンピューター名または共通情報モデル (CIM) セッションを使用して、構成をテストするコンピューターを指定します。 ターゲット コンピューターを指定しない場合、コマンドレットはローカル コンピューターの構成をテストします。

必要な構成と実際の構成が一致する場合、コマンドレットは文字列値 'True' を返します。 それ以外の場合は、文字列値 'False' を返します。

Test-DscConfiguration

このコマンドは、ローカル コンピューターの構成をテストします。

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session

この例では、CIM セッションで指定されたコンピューターからの構成をテストします。 この例では、コマンドレットで使用する Server01 という名前のコンピューターの CIM セッションを作成します。 または、CIM セッションの配列を作成して、指定された複数のコンピューターにコマンドレットを適用します。

最初のコマンドは、New-CimSession コマンドレットを使用して CIM セッションを作成し、CimSession オブジェクトを $Session 変数に格納します。 コマンドによってパスワードの入力が求められます。 詳細については、「Get-Help New-CimSession」と入力します。

2 番目のコマンドは、CimSession によって識別されるコンピューター、$Session 変数 (この場合は Server01 という名前のコンピューター) に格納されているオブジェクトの構成をテストします。

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

このコマンドは、ComputerName パラメーターで指定された一連のコンピューターの構成をテストし、全体的な状態、目的の状態にあるリソース、目的の状態ではないリソース、およびコンピューター名を含む詳細情報を返します。

Test-DscConfiguration -Path "C:\Dsc\Configurations"

このコマンドは、Path パラメーターで指定されたフォルダーで定義されている構成をテストします。 構成は一連のコンピューターに対してテストされ、それぞれが構成ファイルのファイル名で識別されます。

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

このコマンドは、ComputerName パラメーターで指定された一連のコンピューターに対して、ファイルで定義された構成をテストします。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。