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 时,站点配置为同步该类别。
注意
从 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 类。