Update-DscConfiguration
プル サーバーで更新された構成を確認し、適用します。
構文
ComputerNameSet (既定)
Update-DscConfiguration
[[-ComputerName] <String[]>]
[-Wait]
[-JobName <String>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Update-DscConfiguration
-CimSession <CimSession[]>
[-Wait]
[-JobName <String>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Update-DscConfiguration コマンドレットはプル サーバーに接続し、ノードの現在の構成と異なる場合は構成をダウンロードし、構成をコンピューターに適用します。
このコマンドレットは、Windows RT 8.1、Windows 8.1、および Windows Server 2012 R2 のNovember 2014 更新プログラムのロールアップの一部としてのみ使用できます。
例
例 1: 構成を更新する
Update-DscConfiguration -Wait -Verbose
このコマンドを実行すると、サーバーは登録済みのプル サービスに接続し、割り当てられた最新の構成をダウンロードして適用します。 Wait パラメーターと Verbose パラメーターは省略可能です。 対話形式で作業する場合、これらのパラメーターを組み合わせることで、構成の適用時の進行状況と成功または失敗に関するリアルタイムのフィードバックが可能になります。
例 2: CIM セッション経由で接続して構成を更新する
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Update-DscConfiguration -CimSession $Session -Wait
最初のコマンドは、New-CimSession コマンドレットを使用して CIM セッションを作成し、CimSession オブジェクトを $Session 変数に格納します。 コマンドによってパスワードの入力が求められます。 詳細については、「Get-Help New-CimSession」と入力します。
2 番目のコマンドは、に格納されている $Session で指定されたコンピューターを更新します。 このコマンドは、Wait パラメーターを指定します。 コンソールは、現在のコマンドが完了するまで、追加のコマンドを受け入れません。
パラメーター
-CimSession
リモート セッションまたはリモート コンピューターでコマンドレットを実行します。 New-CimSession の出力や Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクト 入力します。 既定値は、ローカル コンピューター上の現在のセッションです。
パラメーターのプロパティ
| 型: | |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
CimSessionSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ComputerName
コンピューター名の配列を指定します。 このコマンドレットは、このパラメーターが指定するコンピューターに構成設定を適用します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | CN, サーバー名 |
パラメーター セット
ComputerNameSet
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Credential
ターゲット コンピューターの PSCredential オブジェクト Get-Credential コマンドレットを使用します。 詳細については、「Get-Help Get-Credential」と入力します。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ComputerNameSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-JobName
ジョブのフレンドリ名を指定します。 このパラメーターを指定すると、コマンドレットはジョブとして実行され、Job オブジェクトが返されます。
既定では、Windows PowerShell によって JobN という名前が割り当てられます。N は整数です。
Wait パラメーターを指定する場合は、このパラメーターを指定しないでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ThrottleLimit
コマンドレットを実行するために確立できる同時実行操作の最大数を指定します。 このパラメーターを省略するか、0 の値を入力すると、Windows PowerShell は、コンピューターで実行されている CIM コマンドレットの数に基づいて、コマンドレットの最適なスロットル制限を計算します。 スロットル制限は、セッションまたはコンピューターではなく、現在のコマンドレットにのみ適用されます。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Wait
コマンドレットがすべての構成タスクを完了するまでコンソールをブロックすることを示します。
このパラメーターを指定する場合は、JobName パラメーターを指定しないでください。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
