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

说明

使用此 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 的产品系列类别，然后使用其实例 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
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

指定要获取的类别的 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
• 公司
• 产品系列
• 产品

Type:	String
Aliases:	CategoryTypeName
Position:	Named
Default value:	None
Required:	False
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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

IResultObject[]

IResultObject

备注

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

相关链接

• Get-CMSoftwareUpdate