Get-DscConfiguration

  • リファレンス
モジュール:
PSDesiredStateConfiguration

ノードの現在の構成を取得します。

構文

Get-DscConfiguration
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

説明

コマンドレットは Get-DscConfiguration 、構成が存在する場合は、ノードの現在の構成を取得します。 Common Information Model (CIM) セッションを使用してコンピューターを指定します。 ターゲット コンピューターを指定しない場合、コマンドレットではローカル コンピューターから構成を取得します。

例

例 1: ローカル コンピューターの構成を取得する

Get-DscConfiguration

このコマンドは、ローカル コンピューターの現在の状態を取得します。

例 2: 指定したコンピューターの構成を取得する

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

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

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

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

パラメーター

-AsJob

このコマンドレットがバックグラウンド ジョブとしてコマンドを実行することを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。 コンピューター名またはセッション オブジェクト ( New-CimSession または Get-CimSession コマンドレットの出力など) を入力します。 既定値は、ローカル コンピューターで実行中の現在のセッションです。

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

コマンドレットを実行するために確立できる最大並行処理数を指定します。 このパラメーターを省略するか、 の0値を入力した場合、Windows PowerShellは、コンピューターで実行されている CIM コマンドレットの数に基づいて、コマンドレットの最適なスロットル制限を計算します。 調整限度は、現在のコマンドレットのみに適用されます。セッションやコンピューターには適用されません。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False