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

说明

使用此 cmdlet 获取软件更新分类或产品的 对象。 软件更新元数据是在 Configuration Manager 的同步过程中根据在软件更新点组件属性中指定的设置检索的。 有关详细信息，请参阅 配置要同步的分类和产品。

若要筛选此 cmdlet 返回的结果，请使用 CategoryTypeName 和 IsSubscribed 属性。 类别类型包括 UpdateClassification、 Company、 ProductFamily 和 Product。 当 IsSubscribed 属性为 True 时，站点配置为同步该类别。

示例

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

-Fast

-ForceWildcardHandling

-Id

-Name

-TypeName

-UniqueId

输入

None

输出

IResultObject[]

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_UpdateCategoryInstance服务器 WMI 类。

相关链接

• Get-CMSoftwareUpdate