Edit

Set-CMSoftwareUpdate

  • Reference
Module:
ConfigurationManager

Sets a software update.

Syntax

Set-CMSoftwareUpdate
   [-CustomSeverity <CustomSeverityType>]
   -Id <String>
   [-MaximumExecutionMins <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdate
   [-CustomSeverity <CustomSeverityType>]
   [-MaximumExecutionMins <Int32>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdate
   [-CustomSeverity <CustomSeverityType>]
   -InputObject <IResultObject>
   [-MaximumExecutionMins <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<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 Configuration Manager applies to a collection of computers.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get a software update and change its settings

PS XYZ:\> 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 XYZ:\> 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.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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
Accepted values:None, Low, Moderate, Important, Critical
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-Id

Specifies the ID of software updates.

Type:String
Aliases:CIId, CI_ID
Position:Named
Default value:None
Required:True
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
Required:True
Accept pipeline input:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the name of a software update.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

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

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object