以前、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
参考
- UpdateServices (Windows 10 and Windows Server 2016 PowerShell)
https://docs.microsoft.com/en-us/powershell/module/updateservices/?view=win10-ps - Approve-WsusUpdate
https://docs.microsoft.com/en-us/powershell/module/updateservices/Approve-WsusUpdate?view=win10-ps