次の方法で共有

Get-DscConfiguration

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

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

構文

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

説明

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

例

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

Get-DscConfiguration

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

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

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

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

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

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

パラメーター

-AsJob

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

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

-CimSession

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

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

-ThrottleLimit

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

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