Set-​CM​Software​Update

Sets a software update.

Syntax

Set-CMSoftwareUpdate
   [-Confirm]
   [-CustomSeverity <CustomSeverityType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Id <String>
   [-MaximumExecutionMins <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMSoftwareUpdate
   [-Confirm]
   [-CustomSeverity <CustomSeverityType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -InputObject <IResultObject>
   [-MaximumExecutionMins <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMSoftwareUpdate
   [-Confirm]
   [-CustomSeverity <CustomSeverityType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-MaximumExecutionMins <Int32>]
   -Name <String>
   [-WhatIf]
   [<CommonParameters>]

Description

The Set-CMSoftwareUpdate cmdlet changes configuration settings for a software update. You can use this cmdlet to set the severity and the maximum run time for an update. A software update is an update to Windows or other software that Microsoft System Center Configuration Manager applies to a collection of computers.

Examples

Example 1: Get a software update and change its settings

PS C:\> Get-CMSoftwareUpdate -Name "Update for Windows 10 (KB3106932)" | Set-CMSoftwareUpdate -MaximumExecutionMins 10 -CustomSeverity Critical

This command gets the software update object named Update for Windows 10 (KB3106932) and uses the pipeline operator to pass the object to Set-CMSoftwareUpdate, which sets the severity of the update to Critical and the maximum installation time to 10 minutes.

Example 2: Modify software update settings

PS C:\> Set-CMSoftwareUpdate -Id 16777979 -MaximumExecutionMins 10 -CustomSeverity Critical

This command gets the software update with the ID of 16777979 and sets the severity of the update to Critical and the maximum installation time to 10 minutes.

Required Parameters

-Id

Specifies the ID of software updates.

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

Specifies a software update object. To obtain a software update object, use the Get-CMSoftwareUpdate cmdlet.

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

Specifies the name of a software update.

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

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-CustomSeverity

Specifies the severity for the software update. Valid values are:- Critical

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

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

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

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

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

Specifies, in minutes, the maximum amount of time that a software update has to complete installation on client computers.

Type:Int32
Aliases:MaximumExecutionMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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