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 返回的结果,请使用 CategoryTypeNameIsSubscribed 属性。 类别类型包括 UpdateClassificationCompanyProductFamilyProduct。 当 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 组合使用。

类型: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

指定要获取的类别的 ID。

类型:String
别名:CategoryInstanceID
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Name

指定要获取的类别的名称。

类型:String
别名:LocalizedCategoryInstanceName, CategoryName
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-TypeName

指定要获取的类别的类型。 常见值包括以下类型:

  • UpdateClassification
  • Company
  • 产品系列
  • 产品
类型:String
别名:CategoryTypeName
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-UniqueId

指定要获取的类别的唯一 ID。 此值是具有类别 GUID 的类型名称。 例如,UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1

类型:String
别名:CategoryInstance_UniqueID
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

None

输出

IResultObject[]

IResultObject

备注

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