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

ブログ エントリ内にアフィリエイト広告が含まれています

以前、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 でコマンドレットの違いは (たぶん) ないです。

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

Approve-WsusUpdate コマンドレット (意訳)

名前

Approve-WsusUpdate

概要

クライアントに適用される更新を承認します。

構文

Approve-WsusUpdate
  [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
  [-InformationVariable <System.String>]
  -Action {Install | Uninstall | NotApproved | All}
  -TargetGroupName <String>
  -Update <WsusUpdate>
  [-Confirm]
  [-WhatIf]
  [<CommonParameters>]

説明

Approve-WsusUpdate コマンドレットは、クライアントに適用される更新を承認します。この操作には、Windows Server Update Services (WSUS) 管理者特権が必要となります。

このコマンドレットを使用するには、Get-WsusUpdate コマンドレットを実行し、結果の WsusUpdate オブジェクトをこのコマンドレットにパイプで渡します。

パラメーター

-Action <UpdateApprovalAction>

関連する更新を適用する際、クライアントが実行するアクションを指定します。このパラメーターで利用可能な値は、次のとおりです :

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

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

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

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

-InformationVariable [<System.String>]

情報変数を指定します。

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

-TargetGroupName <String>

このコマンドレットを実行するコンピューター ターゲット グループ名を指定します。

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

-Update <WsusUpdate>

承認/拒否する更新サーバーと、承認/拒否する更新サーバーを含むオブジェクトを指定します。この値は、Get-WsusUpdate コマンドレットを実行し、結果の WsusUpdate オブジェクトをこのコマンドレットに渡すことで取得することが可能です。

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

-Confirm [<SwitchParameter>]

コマンドレットを実行する前に確認を求めます。

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

-WhatIf [<SwitchParameter>]

コマンドレットを実行した際の結果を表示します。実際にコマンドレットは実行されません。

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

<CommonParameters>

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

入力

  • Microsoft UpdateServices.Commands.WsusUpdate

出力

例 1 : 更新を承認する

コマンド
 Get-WsusUpdate -Classification All -Approval Unapproved -Status FailedOrNeeded | Approve-WsusUpdate -Action Install -TargetGroupName "All Computers" 
コマンドの説明

このコマンドは、ステータスが失敗、もしくは必要となるすべての未承認の更新プログラムのインストールを承認します。

関連するリンク

  • Deny-WsusUpdate
  • Get-WsusUpdate

参考

タイトルとURLをコピーしました