Get-CMSoftwareUpdateCategory

  • 參考
模組:
ConfigurationManager

取得軟體更新分類或產品。

Syntax

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

Description

使用此 Cmdlet 取得軟體更新分類或產品的物件。 軟體更新中繼資料是在Configuration Manager的同步處理常式期間，根據您在軟體更新點元件屬性中指定的設定來擷取。 如需詳細資訊， 請參閱設定要同步處理的分類和產品。

若要篩選此 Cmdlet 傳回的結果，請使用 CategoryTypeName 和 IsSubscribed 屬性。 類別類型包括 UpdateClassification、 Company、 ProductFamily和 Product。 當 IsSubscribed 屬性為 True時，網站會設定為同步處理該類別。

注意事項

從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請 參閱開始使用。

範例

範例 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的產品系列類別，然後使用其實例識別碼來取得所有子類別。

$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 Client的產品類別，然後取得該類別中的所有軟體更新。

$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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Fast

新增此參數，不自動重新整理延遲屬性。 延遲屬性包含相對沒有效率的擷取值。 取得這些屬性可能會導致額外的網路流量，並降低 Cmdlet 效能。

如果您未使用此參數，Cmdlet 會顯示警告。 若要停用此警告，請設定 $CMPSSuppressFastNotUsedCheck = $true 。

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

-ForceWildcardHandling

此參數會處理萬用字元，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。

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

-Id

指定要取得之類別目錄的識別碼。

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

-Name

指定要取得的類別名稱。

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

-TypeName

指定要取得的類別類型。 一般值包括下列類型：

  • UpdateClassification
  • Company
  • ProductFamily
  • 產品
Type:String
Aliases:CategoryTypeName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-UniqueId

指定要取得之類別的唯一識別碼。 這個值是具有類別目錄 GUID 的型別名稱。 例如，UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1

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

輸入

None

輸出

IResultObject[]

IResultObject

備註

如需此傳回物件及其屬性的詳細資訊，請 參閱SMS_UpdateCategoryInstance伺服器 WMI 類別。