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の場合、サイトは、そのカテゴリを同期するように構成されます。

注意

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

例

例 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 と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Fast

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

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

Type:	String
Aliases:	CategoryInstanceID
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Type:	String
Aliases:	LocalizedCategoryInstanceName, CategoryName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-TypeName

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

UpdateClassification
Company
ProductFamily
製品

Type:	String
Aliases:	CategoryTypeName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-UniqueId

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

Type:	String
Aliases:	CategoryInstance_UniqueID
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

入力

なし

出力

IResultObject[]

IResultObject

メモ

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

Get-CMSoftwareUpdate