Set-CMSoftwareUpdate
Set-CMSoftwareUpdate
Changes configuration settings for software updates.
Syntax
Parameter Set: SetById
Set-CMSoftwareUpdate -Id <String[]> [-CustomSeverity <CustomSeverityType> {Critical | Important | Low | Moderate | None} ] [-MaximumExecutionMinutes <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByName
Set-CMSoftwareUpdate -Name <String[]> [-CustomSeverity <CustomSeverityType> {Critical | Important | Low | Moderate | None} ] [-MaximumExecutionMinutes <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByValue
Set-CMSoftwareUpdate -InputObject <IResultObject> [-CustomSeverity <CustomSeverityType> {Critical | Important | Low | Moderate | None} ] [-MaximumExecutionMinutes <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-CMSoftwareUpdate cmdlet changes configuration settings for one or more software updates. You can use this cmdlet to set the severity and the maximum run time for an update. A software update is an update to the Windows operating system or other software that Microsoft System Center 2012 SP1 Configuration Manager applies to a collection of computers.
Parameters
-CustomSeverity<CustomSeverityType>
Specifies the severity for the software update. The acceptable values for this parameter are:
-- Critical
-- Important
-- Low
-- Moderate
-- None
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Id<String[]>
Specifies an array of IDs of software updates.
Aliases |
CIId |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-InputObject<IResultObject>
Specifies a CMSoftwareUpdate object. To obtain the CMSoftwareUpdate object, use the Get-CMSoftwareUpdate cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-MaximumExecutionMinutes<Int32>
Specifies the maximum amount of time, in minutes, that a software update has to complete installation on client computers.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String[]>
Specifies an array of names of software updates.
Aliases |
LocalizedDisplayName |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Change settings of a software update
This command changes the severity and maximum run time settings for the software update named Cumulative Security Update for ActiveX Killbits for Windows 7 for x64-based Systems (KB2618451).
PS C:\> Set-CMSoftwareUpdate -Name "Cumulative Security Update for ActiveX Killbits for Windows 7 for x64-based Systems (KB2618451)" -MaximumExecutionMinutes 60 -CustomSeverity None