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。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-BulletinId

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-Category

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

Type:	IResultObject[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-CategoryName

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

Type:	String[]
Aliases:	CategoryNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DatePostedMax

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

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DatePostedMin

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

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DateRevisedMax

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

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DateRevisedMin

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

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EulaExist

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

Type:	Boolean
Aliases:	EulaExists
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Fast

添加此参数不自动刷新延迟属性。 延迟属性包含检索效率相对低的值。 获取这些属性可能会导致额外的网络流量并减少 cmdlet 性能。

如果不使用此参数，该 cmdlet 将显示一条警告。 若要禁用此警告，请设置 $CMPSSuppressFastNotUsedCheck = $true 。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

此参数处理通配符，并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

指定软件更新的 ID。 此值为 CI_ID， 例如 143404 。

Type:	Int32
Aliases:	CIId, CI_ID
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeUpgrade

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

Type:	SwitchParameter
Aliases:	IncludeUpgrades
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsContentProvisioned

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsDeployed

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsExpired

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsLatest

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsOfflineServiceable

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsSuperseded

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsUserDefined

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-OnlyExpired

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Severity

指定软件更新的严重性。

Type:	CustomSeverityType
Accepted values:	None, Low, Moderate, Important, Critical
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateGroup

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

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-UpdateGroupId

指定软件更新组的一组 ID。 此值为软件更新 CI_ID 的"配置项目 ID" 或"配置项目 ID"。 例如，107078。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateGroupName

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

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Vendor

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-名称

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

可以使用通配符：

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

Type:	String
Aliases:	LocalizedDisplayName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

输入

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