以前、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 でコマンドレットの違いは (たぶん) ないです。
このブログ エントリでは、「Set-WsusDynamicCategory」コマンドレットのヘルプ情報 (意訳）について記載します (WSUS コマンドレット一覧については、「Windows Server 2019 で利用可能な WSUS の Windows PowerShell コマンドレットについて」を参照)。
Set-WsusDynamicCategory コマンドレット (意訳)
名前
Set-WsusDynamicCategory
概要
動的カテゴリの同期ステータスを設定します。
構文
Set-WsusDynamicCategory
[-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable <String>]
[-UpdateServer <IUpdateServer>]
-DynamicCategoryType {ComputerModel | Device | Application | Any}
-Name <String>
-Status <WsusDynamicCategoryStatus>
[<CommonParameters>]
Set-WsusDynamicCategory
[-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable <String>]
[-Status <WsusDynamicCategoryStatus>]
[-UpdateServer <IUpdateServer>]
-InputObject <IDynamicCategory>
[<CommonParameters>]
説明
Set-WsusDynamicCategory コマンドレットは、指定された Windows Server Update Services (WSUS) サーバーの動的カテゴリの同期状態を設定します。
パラメーター
-DynamicCategoryType <DynamicCategoryType>
このコマンドレットが変更する動的カテゴリの種類を指定します。このパラメーターで利用可能な値は、次のとおりです :
- ComputerModel
- Device
- Application
| 必須 | true |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-InformationAction [<ActionPreference>]
このコマンドレットが情報イベントに応答する方法を指定します。このパラメーターで利用可能な値は、次のとおりです :
- Continue
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-InformationVariable [<String>]
情報変数を指定します。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-InputObject <IDynamicCategory>
動的なカテゴリ オブジェクトを指定します。このコマンドレットは、このパラメーターが指定する動的カテゴリの同期設定を変更します。動的なカテゴリを取得するには、Get-WsusDynamicCategory コマンドレットを使用します。
| 必須 | true |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | true (ByValue) |
| ワイルドカード文字を許可する | false |
-Name <String>
変更する動的カテゴリ名を指定します。
| 必須 | true |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-Status <WsusDynamicCategoryStatus>
動的カテゴリの更新同期ステータスを指定します。このパラメーターで利用可能な値は、次のとおりです :
- Blocked : この動的カテゴリの更新は同期されていません。
- SyncUpdates : この動的カテゴリの更新は同期されています。
| 必須 | true |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-UpdateServer [<IUpdateServer>]
WSUS サーバーを指定します。このコマンドレットは、このパラメーターが指定するサーバー上の動的カテゴリを変更します。サーバー情報を取得するには、Get-WsusServer コマンドレットを使用します。このパラメーター値を指定しない場合、コマンドレットはローカル サーバー上の動的カテゴリを変更します。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。
入力
- IDynamicCategory
出力
- None
例
例 1 : 動的カテゴリの同期ステータスを設定する
コマンド
Get-WsusDynamicCategory -DynamicCategoryType Device -Name "PCI/Device07" | Set-WsusDynamicCategory -Status Blocked
コマンドの説明
このコマンドは、Get-WsusDynamicCategory コマンドレットを使用して、ローカル サーバーから動的なカテゴリを取得します。このコマンドは、パイプライン演算子を使用して、動的カテゴリを現在のコマンドレットに渡します。現在のコマンドレットは、同期ステータスをブロックに設定します。この値は、この動的カテゴリの更新が同期されないことを意味します。
関連するリンク
- Add-WsusDynamicCategory
- Get-WsusDynamicCategory
- Remove-WsusDynamicCategory
- Get-WsusServer
参考
- UpdateServices (Windows 10 and Windows Server 2016 PowerShell)
https://docs.microsoft.com/en-us/powershell/module/updateservices/?view=win10-ps - Set-WsusDynamicCategory
https://docs.microsoft.com/en-us/powershell/module/updateservices/set-wsusdynamiccategory?view=win10-ps