WSUS 関連の Windows PowerShell コマンドレット (Set-WsusServerSynchronization) について

スポンサーリンク

Windows OS や SQL Server などの、Microsoft 社製品に対する更新プログラムやサービスパックなどを適用する場合、Windows Update を利用して実施するのが一般的と思われます。

しかし、適用するサーバー、クライアントの台数が複数ある環境では、どの更新プログラムやサービスパックを適用すべきか、適用されたか、など管理工数が増加することがよくあります。

Windows Server Update Services (WSUS) サービスを利用することで、Windows OS を実行しているコンピューターに対して、Microsoft 社製品の最新の更新プログラムを効率的に展開することが可能となります。また、WSUS を使用することで、管理しているネットワーク上に存在しているコンピューターへの配布作業を効率的に管理することが可能となります。

Windows Server 2012 から、PowerShell コマンドレットを使用して WSUS の設定が行えるようになりました。しかし、WSUS に関するコマンドレットの情報について、英語の情報はあるものの、日本語の情報についてはあまり公開されていません。

ここでは、WSUS に関する PowerShell コマンドレットの 1 つである「Set-WsusServerSynchronization」コマンドレットについて、日本語の情報として纏めてみました (他のコマンドレットについては、「WSUS 関連の Windows PowerShell コマンドレットについて」を参照)。
※Windows Server 2012 と Windows Server 2012 R2 と比較した際に相違がほとんどないことから、Windows Server 2012 R2 (内容については「Get-Help」コマンドレットの -Full オプションを用いて実行した結果) の情報を元に編集、意訳したものとなります。


■概要

Windows Server Update Services (WSUS) サーバーが Microsoft Update、もしくはアップストリーム サーバーおよびアップストリーム サーバーのプロパティから同期するか、同期先を設定します。

■構文

Set-WsusServerSynchronization [-PortNumber] [-Replica] [-UpdateServer] [-UseSsl]
     -UssServerName [-Confirm] [-WhatIf] [<CommonParameters>]

Set-WsusServerSynchronization [-UpdateServer] -SyncFromMU [-Confirm] [-WhatIf]
     [<CommonParameters>]

■説明

Set-WsusServerSynchronization コマンドレットは、Windows Server Update Services (WSUS) サーバーが Microsoft Update、もしくはアップストリーム サーバーから同期するかどうかを設定します。このコマンドレットは、アップストリーム サーバー名、ポート番号のような設定を指定、および use Secure Sockets Layer (SSL) を使用するかどうかをユーザーに許可します。

■パラメーター

-PortNumber <Int32>
アップストリーム WSUS サーバーを通信するために使用するポート番号を指定します。

必須false
位置named
既定値none
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Replica [<SwitchParameter>]
WSUS サーバーがレプリカ サーバーかどうかを指定します。

必須false
位置named
既定値false
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-SyncFromMU [<SwitchParameter>]
WSUS サーバーが。Microsoft Update から更新を同期するときに指定します。

必須true
位置named
既定値none
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-UpdateServer <IUpdateServer>
WSUS サーバーを含むオブジェクトを指定します。この値は、Get-WsusServer コマンドレットを呼び出し、このコマンドレットに結果として生成される IUpdateServer オブジェクトをパイプラインで送ることによって取得します。

必須false
位置named
既定値none
パイプライン入力を許可するtrue (ByValue)
ワイルドカード文字を許可するfalse

-UseSsl [<SwitchParameter>]
WSUS サーバーが、アップストリーム サーバーと通信するために、HTTPS 経由で Secure Sockets Layer (SSL) を使用すべきときに指定します。

必須false
位置named
既定値false
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-UssServerName <String>
更新を同期するローカル サーバー名を指定します。

必須true
位置named
既定値none
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Confirm [<SwitchParameter>]
コマンドレットを実行する前に、実行の是非を確認するプロンプトを表示します。

必須false
位置named
既定値false
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-WhatIf [<SwitchParameter>]
コマンドレットを実行する場合に、何か起こるかを示します。コマンドレットは実行しません。

必須false
位置named
既定値false
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: VerboseDebugErrorActionErrorVariableWarningActionWarningVariableOutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。

■入力

  • Microsoft.UpdateServices.Commands.IUpdateServer
    IUpdateServer

■出力

  • None

■例

例 1

 Set-WsusServerSynchronization -UssServerName Test -PortNumber 42 -UseSSL 

この例では、ローカル WSUS サーバーがポート番号 42、および SSL プロトコルを用いた他のサーバー「Test」から同期することを指定します。

例 2

 Set-WsusServerSynchronization -SyncFromMU 

The Update Server was successfully configured with the following parameters: Synchronize from Microsoft Update

この例では、ローカル WSUS サーバーが Microsoft Update から同期することを示しています。

■関連するトピック

  • Get-WsusServer

[参考]