Share via

Restore-DscConfiguration

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

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

構文

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

説明

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

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

例

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

Restore-DscConfiguration

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

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

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

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

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

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

パラメーター

-AsJob

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

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

-CimSession

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

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

-Confirm

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

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

-ThrottleLimit

コマンドレットを実行するために確立できる最大並行処理数を指定します。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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