Get-CMSoftwareUpdate

模块:

ConfigurationManager

获取软件更新。

语法

Get-CMSoftwareUpdate
   [-ArticleId <String>]
   [-BulletinId <String>]
   [-Category <IResultObject[]>]
   [-CategoryName <String[]>]
   [-DatePostedMax <DateTime>]
   [-DatePostedMin <DateTime>]
   [-DateRevisedMax <DateTime>]
   [-DateRevisedMin <DateTime>]
   [-EulaExist <Boolean>]
   [-Fast]
   [-IncludeUpgrade]
   [-IsContentProvisioned <Boolean>]
   [-IsDeployed <Boolean>]
   [-IsExpired <Boolean>]
   [-IsLatest <Boolean>]
   [-IsOfflineServiceable <Boolean>]
   [-IsSuperseded <Boolean>]
   [-IsUserDefined <Boolean>]
   [-Name <String>]
   [-OnlyExpired]
   [-Severity <CustomSeverityType>]
   [-Vendor <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdate
   [-Fast]
   -Id <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroupId <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroupName <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

使用此 cmdlet 获取一个或多个软件更新。

有关详细信息，请参阅核心文档中的 软件更新管理文档 。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：获取下载的软件更新

此命令获取站点已下载的所有软件更新。

Get-CMSoftwareUpdate -IsContentProvisioned $True

示例 2：按更新组获取软件更新

此命令首先获取名为 TestSUgroup10 的软件更新组对象。 然后，它使用管道运算符将对象传递给 Get-CMSoftwareUpdate。 结果是软件更新组的所有软件更新的列表。

Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate

参数

-ArticleId

指定软件更新 的“项目 ID ”。 例如，4571687。

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

-BulletinId

指定软件更新的 公告 ID 。 例如，MS18-952。

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

-Category

指定软件更新的类别。 若要获取类别对象，请使用 Get-CMSoftwareUpdateCategory cmdlet。

类型:	IResultObject[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-CategoryName

指定软件更新的类别名称数组。

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

-DatePostedMax

指定软件更新发布的最新日期。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DatePostedMin

指定发布软件更新的最早日期。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DateRevisedMax

指定软件更新修订的最新日期。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DateRevisedMin

指定软件更新修订的最早日期。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EulaExist

将此参数设置为 以 $true 筛选具有许可协议的所有更新的结果。

类型:	Boolean
别名:	EulaExists
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。 此值是 CI_ID，例如 143404。

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

-IncludeUpgrade

添加此参数以在升级类别中包含软件更新。

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

-IsContentProvisioned

将此参数设置为 以 $true 筛选网站已下载内容的所有更新的结果。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IsDeployed

将此参数设置为 $true 以筛选已部署的所有更新的结果。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IsExpired

将此参数设置为 $true 以筛选所有已过期更新的结果。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IsLatest

将此参数设置为 以 $true 筛选软件更新最新版本的结果。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IsOfflineServiceable

将此参数设置为 以 $true 筛选所有可脱机维护的更新的结果。 可以使用 DISM 命令行工具将这些更新注入 OS 映像。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IsSuperseded

将此参数设置为 $true 以筛选被取代的所有更新的结果。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IsUserDefined

将此参数设置为 $true 以筛选用户定义的所有更新的结果。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定软件更新的名称。 此参数与本地化的显示名称属性进行比较。

可以使用通配符：

• *：多个字符
• ?：单个字符

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

-OnlyExpired

添加此参数以仅搜索过期的软件更新。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Severity

指定软件更新的严重性。

类型:	CustomSeverityType
接受的值:	None, Low, Moderate, Important, Critical
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UpdateGroup

指定软件更新组对象。 若要获取此对象，请使用 Get-CMSoftwareUpdateGroup cmdlet。

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

-UpdateGroupId

指定软件更新组的 ID 数组。 此值是软件更新组 的CI_ID 或 配置项 ID 。 例如，107078。

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

-UpdateGroupName

指定软件更新组的名称数组。

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

-Vendor

适用于版本 2010 及更高版本。 指定软件更新供应商的名称。 大多数软件更新的供应商是 "Microsoft"。 如果配置第三方软件更新，请使用此值筛选其他更新供应商。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject[]

IResultObject

备注

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

相关链接

• Get-CMSoftwareUpdateGroup
• Save-CMSoftwareUpdate
• Set-CMSoftwareUpdate
• Sync-CMSoftwareUpdate
• Get-CMSoftwareUpdateCategory
• Get-CMSoftwareUpdateGroup
• Get-CMSoftwareUpdateContentInfo