Windows Server 2019 で利用可能な WSUS の Windows PowerShell コマンドレット (Get-WsusServer) について

以前、WSUS (Windows Server Update Services) の Windows PowerShell コマンドレット一覧 (https://kogelog.com/2013/12/21/20131221-01/) というブログ エントリを公開しましたが、Windows Server 2012 R2 の情報を元にしていました。

さすがに情報の鮮度がなくなっている状況なので、Windows Server 2019 (バージョン 1809; OS ビルド 17763.1039) で確認した WSUS コマンドレットを日本語の情報として纏めてみました。
※Windows Server 2019 と Windows Server 2016 でコマンドレットの違いは (たぶん) ないです。

このブログ エントリでは、「Get-WsusServer」コマンドレットのヘルプ情報 (意訳）について記載します (WSUS コマンドレット一覧については、「Windows Server 2019 で利用可能な WSUS の Windows PowerShell コマンドレットについて」を参照)。

Get-WsusServer コマンドレット (意訳)

名前

Get-WsusServer

概要

WSUS 更新サーバー オブジェクトを取得します。

構文

Get-WsusServer
  [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
  [-InformationVariable <System.String>]
  [<CommonParameters>]
Get-WsusServer
  [-Name] <String>
  [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
  [-InformationVariable <System.String>]
  [-UseSsl]
  -PortNumber <Int32>
  [<CommonParameters>]

説明

Get-WsusServer コマンドレットは、Windows Server Update Services (WSUS) 更新サーバー オブジェクトを取得します。このコマンドレットには、サーバー名、ポート番号、およびサーバーがパラメーターとして Secure Sockets Layer (SSL) を使用するかどうかを指定するフラグが必要となります。

サーバー名、ポート番号、および SSL を使用するかどうかを指定するフラグを指定した場合、IUpdateServer オブジェクトを返します。

パラメーター

-InformationAction [<System.Management.Automation.ActionPreference>]

このコマンドレットが情報イベントに応答する方法を指定します。このパラメーターで利用可能な値は、次のとおりです :

• Continue
• Ignore
• Inquire
• SilentlyContinue
• Stop
• Suspend

-InformationVariable [<System.String>]

情報変数を指定します。

-Name <String>

WSUS サーバー名を指定します。

-PortNumber <Int32>

アップストリーム WSUS サーバーとの通信に使用するポート番号を指定します。

-UseSsl [<SwitchParameter>]

WSUS サーバーが HTTPS 経由で Secure Sockets Layer (SSL) を使用して上流サーバーと通信する必要がある場合に指定します。

<CommonParameters>

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

入力

• None

出力

• Microsoft.UpdateServices.Commands.IUpdateServer

例

例 1 : ローカル サーバー情報を取得する

コマンド

 Get-WsusServer 

コマンドの実行結果

Name : contoso

コマンドの説明

このコマンドは、ローカル コンピューターの IUpdateServer オブジェクトを取得します。

例 2 : リモート サーバー情報を取得する

コマンド

 Get-WsusServer -Name "contoso" -PortNumber 8530 

コマンドの実行結果

Name : contoso

コマンドの説明

このコマンドは、リモート コンピューターの IUpdateServer オブジェクトを取得します。

関連するリンク

参考

• UpdateServices (Windows 10 and Windows Server 2016 PowerShell)
  https://docs.microsoft.com/en-us/powershell/module/updateservices/?view=win10-ps
• Get-WsusServer
  https://docs.microsoft.com/en-us/powershell/module/updateservices/get-wsusserver?view=win10-ps