Get-CMSoftwareUpdate

Gets a software update.

Syntax

Get-CMSoftwareUpdate
   [-ArticleId <String>]
   [-BulletinId <String>]
   [-Category <IResultObject[]>]
   [-CategoryName <String[]>]
   [-DatePostedMax <DateTime>]
   [-DatePostedMin <DateTime>]
   [-DateRevisedMax <DateTime>]
   [-DateRevisedMin <DateTime>]
   [-DisableWildcardHandling]
   [-EulaExists <Boolean>]
   [-Fast]
   [-ForceWildcardHandling]
   [-IncludeUpgrades]
   [-IsContentProvisioned <Boolean>]
   [-IsDeployed <Boolean>]
   [-IsExpired <Boolean>]
   [-IsLatest <Boolean>]
   [-IsOfflineServiceable <Boolean>]
   [-IsSuperseded <Boolean>]
   [-IsUserDefined <Boolean>]
   [-Name <String>]
   [-OnlyExpired]
   [-Severity <CustomSeverityType>]
   [<CommonParameters>]
Get-CMSoftwareUpdate [-DisableWildcardHandling] [-Fast] [-ForceWildcardHandling] -Id 
 []
Get-CMSoftwareUpdate [-DisableWildcardHandling] [-Fast] [-ForceWildcardHandling] -UpdateGroup 
 []
Get-CMSoftwareUpdate [-DisableWildcardHandling] [-Fast] [-ForceWildcardHandling] -UpdateGroupId 
 []
Get-CMSoftwareUpdate [-DisableWildcardHandling] [-Fast] [-ForceWildcardHandling] -UpdateGroupName 
 []

Description

The Get-CMSoftwareUpdate cmdlet gets one or more software updates. Clients receive a software update object when manually or automatically deploying a software update.

Examples

Example 1: Get software updates that have been downloaded

PS C:\> Get-CMSoftwareUpdate -IsContentProvisioned $True

This command gets all software updates that have been downloaded.

Example 2: Get software updates by update group

PS C:\> Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate

This command gets the software update group object named TestSUgroup10 and uses the pipeline operator to pass the object to Get-CMSoftwareUpdate, which gets all software updates for the software update group object.

Required Parameters

-Id

Specifies the ID of a software update.

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

Specifies a software update group object. To obtain an update group object, use the Get-CMSoftwareUpdateGroup cmdlet.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-UpdateGroupId

Specifies an array of IDs of software update groups.

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

Specifies an array of names of software update groups.

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

Optional Parameters

-ArticleId

Specifies the article ID of a software update.

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

Specifies the bulletin ID of a software update.

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

Specifies the category of a software update. To obtain a category object, use the Get-CMSoftwareUpdateCategory cmdlet.

Type:IResultObject[]
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-CategoryName

Specifies an array of category names for software updates.

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

Specifies the latest date that a software update was released.

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

Specifies the earliest date that a software update was released.

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

Specifies the latest date that a software update was revised.

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

Specifies the earliest date that a software update was revised.

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

Indicates that wildcard handling is disabled.

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

Indicates whether the software update EULA exists.

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

Indicates that the cmdlet does not automatically refresh lazy properties.Lazy properties contain values that are relatively inefficient to retrieve which can cause additional network traffic and decrease cmdlet performance. If lazy properties are not used, this parameter should be specified.

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

Indicates that wildcard handling is enabled.

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

Indicates that upgrades are included in the software update.

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

Indicates whether the software update is downloaded.

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

Indicates whether the software update is deployed.

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

Indicates whether the software update has expired.

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

Indicates whether the software update is the latest version.

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

Indicates whether the software update is offline-serviceable.

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

Indicates whether the software update is superseded.

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

Indicates whether the software update is user-defined.

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

Specifies the name of a software update.

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

Indicates that the cmdlet only searches for expired software updates.

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

Specifies the severity of software update. Valid values are:- None

  • Low
  • Moderate
  • Important
  • Critical
Type:CustomSeverityType
Parameter Sets:None, Low, Moderate, Important, Critical
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False