Get-CMSoftwareUpdateCategory
取得軟體更新分類或產品。
語法
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 客戶端的產品類別，然後取得該類別中的所有軟體更新。
$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 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Fast
新增此參數，不自動重新整理延遲屬性。 延遲屬性包含相對沒有效率的擷取值。 取得這些屬性可能會導致額外的網路流量，並降低 Cmdlet 效能。
如果您未使用此參數，Cmdlet 會顯示警告。 若要停用此警告，請設定 $CMPSSuppressFastNotUsedCheck = $true。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Id
指定要取得之類別目錄的識別碼。
| 類型: | String |
| 別名: | CategoryInstanceID |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定要取得的類別名稱。
| 類型: | String |
| 別名: | LocalizedCategoryInstanceName, CategoryName |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-TypeName
指定要取得的類別類型。 一般值包括下列類型：
- UpdateClassification
- Company
- ProductFamily
- 產品
| 類型: | String |
| 別名: | CategoryTypeName |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-UniqueId
指定要取得之類別的唯一標識碼。 這個值是具有類別目錄 GUID 的型別名稱。 例如，UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1
| 類型: | String |
| 別名: | CategoryInstance_UniqueID |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
IResultObject[]
IResultObject
備註
如需此傳回物件及其屬性的詳細資訊，請 參閱SMS_UpdateCategoryInstance伺服器 WMI 類別。