次の方法で共有

Restore-DscConfiguration

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

ノードの前の構成を再び実行します。

構文

Restore-DscConfiguration
       [-CimSession <CimSession[]>]
       [-ThrottleLimit <Int32>]
       [-AsJob]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

説明

Restore-DscConfiguration コマンドレットは、以前の構成が存在する場合、ノードの以前の構成を再び実行します。 共通情報モデル (CIM) セッションを使用してコンピューターを指定します。 ターゲット コンピューターを指定しない場合、コマンドレットはローカル コンピューターの構成を復元します。 特定のノードに対する以前の構成がない場合、このコマンドレットはエラー メッセージを返します。

このコマンドレットは、Confirm パラメーターをサポートしていません。

例

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

Restore-DscConfiguration

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

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

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Restore-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

-Confirm

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

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

-ThrottleLimit

コマンドレットを実行するために確立できる同時実行操作の最大数を指定します。

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

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

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