Get-CMSoftwareUpdateCategory

モジュール:

ConfigurationManager

ソフトウェア更新プログラムの分類または製品を取得します。

構文

Get-CMSoftwareUpdateCategory
   [-Fast]
   [-Name <String>]
   [-TypeName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdateCategory
   [-Fast]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdateCategory
   [-Fast]
   -UniqueId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

説明

このコマンドレットを使用して、ソフトウェア更新プログラムの分類または製品のオブジェクトを取得します。 ソフトウェア更新プログラムのメタデータは、Configuration Manager の同期プロセス中に、ソフトウェア更新ポイント コンポーネントのプロパティで指定した設定に基づいて取得されます。 詳細については、「 同期する分類と製品を構成する」を参照してください。

このコマンドレットが返す結果をフィルター処理するには、 CategoryTypeName プロパティと IsSubscribed プロパティを 使用します。 カテゴリの種類には、 UpdateClassification、 Company、 ProductFamily、 および Product が含まれます。 IsSubscribed プロパティが True の場合、サイトはそのカテゴリを同期するように構成されます。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 1: サブスクライブされた分類を表示する

次の使用例は、同期しているすべてのソフトウェア更新プログラムの分類についてサイトに対してクエリを実行します。

Get-CMSoftwareUpdateCategory -Fast -TypeName "UpdateClassification" | Where-Object { $_.IsSubscribed } | Select-Object LocalizedCategoryInstanceName

サイトが同期していない分類の一覧を返すようにこのコマンドを変更するには、IsSubscribed プロパティへの参照の前に not 演算子 (!) を追加します。 たとえば、!$_.IsSubscribed のように指定します。

例 2: 種類別にカテゴリをカウントする

次の使用例は、サイトが種類ごとに持つカテゴリの数をカウントします。 この数は、ソフトウェアの更新ポイントがアップストリーム ソースと同期していないかどうかを判断するのに役立ちます。

Get-CMSoftwareUpdateCategory -Fast | Group-Object -Property CategoryTypeName

Count Name
----- ----
   13 UpdateClassification
    7 Company
   59 ProductFamily
  338 Product

例 3: Office 製品ファミリの製品を表示する

この例では、最初に Office の製品ファミリ カテゴリを取得し、そのインスタンス ID を使用してすべての子カテゴリを取得します。

$officeFamily = Get-CMSoftwareUpdateCategory -Fast -TypeName "ProductFamily" | Where-Object { $_.LocalizedCategoryInstanceName -eq "Office" }

Get-CMSoftwareUpdateCategory -Fast | Where-Object ParentCategoryInstanceId -eq $officeFamily.CategoryInstanceID | Select-Object LocalizedCategoryInstanceName,CategoryTypeName

LocalizedCategoryInstanceName         CategoryTypeName
-----------------------------         ----------------
Dictionary Updates for Microsoft IMEs Product
New Dictionaries for Microsoft IMEs   Product
Office 2002/XP                        Product
Office 2003                           Product
Office 2007                           Product
Office 2010                           Product
Office 2013                           Product
Office 2016                           Product
Office 365 Client                     Product
Office 2019                           Product

例 4: Office 365 クライアント カテゴリのすべてのソフトウェア更新プログラムを取得する

この例では、最初に Office 365 クライアントの製品カテゴリを取得し、そのカテゴリのすべてのソフトウェア更新プログラムを取得します。

$cat = Get-CMSoftwareUpdateCategory -Fast -TypeName "Product" | Where-Object { $_.LocalizedCategoryInstanceName -eq "Office 365 Client" }

Get-CMSoftwareUpdate -Fast -Category $cat | Select-Object ArticleID,LocalizedDisplayName,IsDeployed,IsSuperseded,NumTotal,NumMissing

パラメーター

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Fast

このパラメーターを追加して、遅延プロパティを自動的に更新しないようにします。 遅延プロパティには、取得するのが比較的非効率的な値が含まれています。 これらのプロパティを取得すると、追加のネットワーク トラフィックが発生し、コマンドレットのパフォーマンスが低下する可能性があります。

このパラメーターを使用しない場合、コマンドレットに警告が表示されます。 この警告を無効にするには、 $CMPSSuppressFastNotUsedCheck = $trueを設定します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

取得するカテゴリの ID を指定します。

型:	String
Aliases:	CategoryInstanceID
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

取得するカテゴリの名前を指定します。

型:	String
Aliases:	LocalizedCategoryInstanceName, CategoryName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	True

-TypeName

取得するカテゴリの種類を指定します。 一般的な値には、次の型が含まれます。

• UpdateClassification
• Company
• ProductFamily
• 製品

型:	String
Aliases:	CategoryTypeName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	True

-UniqueId

取得するカテゴリの一意の ID を指定します。 この値は、カテゴリの GUID を持つ型名です。 たとえば、UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1 のように指定します。

型:	String
Aliases:	CategoryInstance_UniqueID
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None

出力

IResultObject[]

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_UpdateCategoryInstance」を参照してください。

関連リンク

• Get-CMSoftwareUpdate