Update-DscConfiguration
プル サーバーで更新された構成を確認し、適用します。
構文
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 |
