Update-DscConfiguration

リファレンス

モジュール:: PSDesiredStateConfiguration

プルサーバーで更新された構成を確認し、適用します。

構文

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

コマンドレットは Update-DscConfiguration プルサーバーに接続し、ノードの現在の構成と異なる場合は構成をダウンロードし、構成をコンピューターに適用します。

このコマンドレットは、Windows RT 8.1、Windows 8.1、および Windows Server 2012 R2 の 2014 年 11 月の更新プログラムのロールアップの一部としてのみ使用できます。

例

例 1: 構成を更新する

Update-DscConfiguration -Wait -Verbose

このコマンドを実行すると、サーバーは登録済みのプルサービスに接続し、割り当てられた最新の構成をダウンロードして適用します。 Wait パラメーターと Verbose パラメーターは省略可能です。対話形式で作業する場合、これらのパラメーターを組み合わせることで、構成の適用時の進行状況と成功または失敗に関するリアルタイムのフィードバックが可能になります。

例 2: CIM セッション経由で接続して構成を更新する

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

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

2 番目のコマンドは、に格納されている CimSession で指定されたコンピューターを $Session更新します。コマンドは Wait パラメーターを指定します。コンソールは、現在のコマンドが完了するまで、追加のコマンドを受け入れません。

パラメーター

-CimSession

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

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

-ComputerName

コンピューター名の配列を指定します。コマンドレットは、このパラメーターが指定するコンピューターに構成設定を適用します。

Type:	String[]
Aliases:	CN, ServerName
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

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

-Credential

ターゲットコンピューターに対して、ユーザー名とパスワードを、PSCredential オブジェクトとして指定します。 PSCredential オブジェクトを取得するには、コマンドレットを使用しますGet-Credential。詳細を表示するには「Get-Help Get-Credential」を入力します。

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

-JobName

ジョブのフレンドリ名を指定します。このパラメーターを指定すると、コマンドレットがジョブとして実行され、Job オブジェクトを返します。

既定では、Windows PowerShellは JobN という名前を割り当てます。ここで、N は整数です。

Wait パラメーターを指定した場合は、このパラメーターを指定しないでください。

Type:	String
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

-Wait

コマンドレットがすべての構成タスクを完了するまでコンソールをブロックすることを示します。

このパラメーターを指定した場合は、JobName パラメーターを指定しないでください。

Type:	SwitchParameter
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