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

スポンサーリンク
Microsoft Store (マイクロソフトストア)

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

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

Add-WsusDynamicCategory コマンドレット (意訳)

名前

Add-WsusDynamicCategory

概要

動的カテゴリを WSUS サーバーに追加します。

構文

Add-WsusDynamicCategory
[-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable <String>]
[-UpdateServer <IUpdateServer>]
-DynamicCategoryType {ComputerModel | Device | Application | Any}
-Name <String>
[<CommonParameters>]

Add-WsusDynamicCategory
[-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore |   Suspend}]
[-InformationVariable <String>]
[-UpdateServer <IUpdateServer>]
-InputObject <IDynamicCategory>
[<CommonParameters>]

説明

Add-WsusDynamicCategory コマンドレットは、動的カテゴリを Windows Server Update Services (WSUS) サーバーに追加します。

更新サーバー間で動的カテゴリを転送するには、パイプライン演算子を使用して、Get-WsusDynamicCategory コマンドレットの結果を現在のコマンドレットに渡します。

パラメーター

-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>

追加する動的カテゴリ名を指定します。

必須 false
位置 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

出力

  • IDynamicCategory

例 1 : ローカル WSUS サーバーに動的カテゴリを追加する

コマンド
 Add-WsusDynamicCategory -DynamicCategoryType Device -Name "PCI/Device07" 
コマンドの実行結果

Name            Type    Status
—-               —-      ——
PCI/Device07 Device True

コマンドの説明

このコマンドは、動的カテゴリ PCI/Device07 をローカル更新サーバーに追加します。このコマンドは、種類が Device であることを指定します。

関連するリンク

  • Get-WsusDynamicCategory
  • Remove-WsusDynamicCategory
  • Set-WsusDynamicCategory
  • Get-WsusServer

参考