Set-CMSoftwareUpdateAutoDeploymentRule

Set-CMSoftwareUpdateAutoDeploymentRule

Modifies Configuration Manager deployment rules for automatic software updates.

Syntax

Parameter Set: SearchByNameMandatory
Set-CMSoftwareUpdateAutoDeploymentRule -Name <String> [-AddToExistingSoftwareUpdateGroup <Boolean> ] [-AlertTime <Int32> ] [-AlertTimeUnit <TimeUnitType> {Days | Hours | Months | Weeks} ] [-AllowRestart <Boolean> ] [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean> ] [-AllowUseMeteredNetwork <Boolean> ] [-ArticleId <String[]> ] [-AvailableImmediately <Boolean> ] [-AvailableTime <Int32> ] [-AvailableTimeUnit <TimeUnitType> {Days | Hours | Months | Weeks} ] [-BulletinId <String[]> ] [-CollectionName <String> ] [-CustomSeverity {Critical | Important | Low | Moderate | None}[] ] [-DateReleasedOrRevised <DateReleasedOrRevisedType> {Last10months | Last11months | Last12hours | Last14days | Last16hours | Last1day | Last1hour | Last1month | Last1year | Last20hours | Last21days | Last28days | Last2days | Last2hours | Last2months | Last3days | Last3hours | Last3months | Last4days | Last4hours | Last4months | Last5days | Last5months | Last6days | Last6months | Last7days | Last7months | Last8hours | Last8months | Last9months} ] [-DeadlineImmediately <Boolean> ] [-DeadlineTime <Int32> ] [-DeadlineTimeUnit <TimeUnitType> {Days | Hours | Months | Weeks} ] [-DeployWithoutLicense <Boolean> ] [-Description <String> ] [-DisableOperationManager <Boolean> ] [-DownloadFromMicrosoftUpdate <Boolean> ] [-EnabledAfterCreate <Boolean> ] [-Force] [-GenerateOperationManagerAlert <Boolean> ] [-GenerateSuccessAlert <Boolean> ] [-Language <String[]> ] [-LanguageSelection <String[]> ] [-MicrosoftAsVendor <Boolean> ] [-NewName <String> ] [-NoInstallOnRemote <Boolean> ] [-NoInstallOnUnprotected <Boolean> ] [-Product <String[]> ] [-Required <String[]> ] [-RunType <RunType> {DoNotRunThisRuleAutomatically | RunTheRuleAfterAnySoftwareUpdatePointSynchronization | RunTheRuleOnSchedule} ] [-Schedule <IResultObject> ] [-SendWakeUpPacket <Boolean> ] [-Severity {Critical | Important | Low | Moderate | None}[] ] [-SuccessPercentage <Int32> ] [-Superseded <Boolean> ] [-SuppressRestartServer <Boolean> ] [-SuppressRestartWorkstation <Boolean> ] [-Title <String[]> ] [-UpdateClassification <String[]> ] [-UpdateDescription <String[]> ] [-UseBranchCache <Boolean> ] [-UserNotification <UserNotificationType> {DisplayAll | DisplaySoftwareCenterOnly | HideAll} ] [-UseUtc <Boolean> ] [-VerboseLevel <VerboseLevelType> {AllMessages | OnlyErrorMessages | OnlySuccessAndErrorMessages} ] [-WriteFilterHandling <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Set-CMSoftwareUpdateAutoDeploymentRule -Id <String[]> [-AddToExistingSoftwareUpdateGroup <Boolean> ] [-AlertTime <Int32> ] [-AlertTimeUnit <TimeUnitType> {Days | Hours | Months | Weeks} ] [-AllowRestart <Boolean> ] [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean> ] [-AllowUseMeteredNetwork <Boolean> ] [-ArticleId <String[]> ] [-AvailableImmediately <Boolean> ] [-AvailableTime <Int32> ] [-AvailableTimeUnit <TimeUnitType> {Days | Hours | Months | Weeks} ] [-BulletinId <String[]> ] [-CollectionName <String> ] [-CustomSeverity {Critical | Important | Low | Moderate | None}[] ] [-DateReleasedOrRevised <DateReleasedOrRevisedType> {Last10months | Last11months | Last12hours | Last14days | Last16hours | Last1day | Last1hour | Last1month | Last1year | Last20hours | Last21days | Last28days | Last2days | Last2hours | Last2months | Last3days | Last3hours | Last3months | Last4days | Last4hours | Last4months | Last5days | Last5months | Last6days | Last6months | Last7days | Last7months | Last8hours | Last8months | Last9months} ] [-DeadlineImmediately <Boolean> ] [-DeadlineTime <Int32> ] [-DeadlineTimeUnit <TimeUnitType> {Days | Hours | Months | Weeks} ] [-DeployWithoutLicense <Boolean> ] [-Description <String> ] [-DisableOperationManager <Boolean> ] [-DownloadFromMicrosoftUpdate <Boolean> ] [-EnabledAfterCreate <Boolean> ] [-Force] [-GenerateOperationManagerAlert <Boolean> ] [-GenerateSuccessAlert <Boolean> ] [-Language <String[]> ] [-LanguageSelection <String[]> ] [-MicrosoftAsVendor <Boolean> ] [-NewName <String> ] [-NoInstallOnRemote <Boolean> ] [-NoInstallOnUnprotected <Boolean> ] [-Product <String[]> ] [-Required <String[]> ] [-RunType <RunType> {DoNotRunThisRuleAutomatically | RunTheRuleAfterAnySoftwareUpdatePointSynchronization | RunTheRuleOnSchedule} ] [-Schedule <IResultObject> ] [-SendWakeUpPacket <Boolean> ] [-Severity {Critical | Important | Low | Moderate | None}[] ] [-SuccessPercentage <Int32> ] [-Superseded <Boolean> ] [-SuppressRestartServer <Boolean> ] [-SuppressRestartWorkstation <Boolean> ] [-Title <String[]> ] [-UpdateClassification <String[]> ] [-UpdateDescription <String[]> ] [-UseBranchCache <Boolean> ] [-UserNotification <UserNotificationType> {DisplayAll | DisplaySoftwareCenterOnly | HideAll} ] [-UseUtc <Boolean> ] [-VerboseLevel <VerboseLevelType> {AllMessages | OnlyErrorMessages | OnlySuccessAndErrorMessages} ] [-WriteFilterHandling <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Set-CMSoftwareUpdateAutoDeploymentRule -InputObject <IResultObject> [-AddToExistingSoftwareUpdateGroup <Boolean> ] [-AlertTime <Int32> ] [-AlertTimeUnit <TimeUnitType> {Days | Hours | Months | Weeks} ] [-AllowRestart <Boolean> ] [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean> ] [-AllowUseMeteredNetwork <Boolean> ] [-ArticleId <String[]> ] [-AvailableImmediately <Boolean> ] [-AvailableTime <Int32> ] [-AvailableTimeUnit <TimeUnitType> {Days | Hours | Months | Weeks} ] [-BulletinId <String[]> ] [-CollectionName <String> ] [-CustomSeverity {Critical | Important | Low | Moderate | None}[] ] [-DateReleasedOrRevised <DateReleasedOrRevisedType> {Last10months | Last11months | Last12hours | Last14days | Last16hours | Last1day | Last1hour | Last1month | Last1year | Last20hours | Last21days | Last28days | Last2days | Last2hours | Last2months | Last3days | Last3hours | Last3months | Last4days | Last4hours | Last4months | Last5days | Last5months | Last6days | Last6months | Last7days | Last7months | Last8hours | Last8months | Last9months} ] [-DeadlineImmediately <Boolean> ] [-DeadlineTime <Int32> ] [-DeadlineTimeUnit <TimeUnitType> {Days | Hours | Months | Weeks} ] [-DeployWithoutLicense <Boolean> ] [-Description <String> ] [-DisableOperationManager <Boolean> ] [-DownloadFromMicrosoftUpdate <Boolean> ] [-EnabledAfterCreate <Boolean> ] [-Force] [-GenerateOperationManagerAlert <Boolean> ] [-GenerateSuccessAlert <Boolean> ] [-Language <String[]> ] [-LanguageSelection <String[]> ] [-MicrosoftAsVendor <Boolean> ] [-NewName <String> ] [-NoInstallOnRemote <Boolean> ] [-NoInstallOnUnprotected <Boolean> ] [-Product <String[]> ] [-Required <String[]> ] [-RunType <RunType> {DoNotRunThisRuleAutomatically | RunTheRuleAfterAnySoftwareUpdatePointSynchronization | RunTheRuleOnSchedule} ] [-Schedule <IResultObject> ] [-SendWakeUpPacket <Boolean> ] [-Severity {Critical | Important | Low | Moderate | None}[] ] [-SuccessPercentage <Int32> ] [-Superseded <Boolean> ] [-SuppressRestartServer <Boolean> ] [-SuppressRestartWorkstation <Boolean> ] [-Title <String[]> ] [-UpdateClassification <String[]> ] [-UpdateDescription <String[]> ] [-UseBranchCache <Boolean> ] [-UserNotification <UserNotificationType> {DisplayAll | DisplaySoftwareCenterOnly | HideAll} ] [-UseUtc <Boolean> ] [-VerboseLevel <VerboseLevelType> {AllMessages | OnlyErrorMessages | OnlySuccessAndErrorMessages} ] [-WriteFilterHandling <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Set-CMSoftwareUpdateAutoDeploymentRule cmdlet modifies Microsoft System Center 2012 Configuration Manager deployment rules for automatic software updates. To create a rule, use the Get-CMSoftwareUpdateAutoDeploymentRule cmdlet.

System Center 2012 Configuration Manager uses rules to manage automatic deployment of software updates. When a rule runs, System Center 2012 Configuration Manager adds updates that qualify for the rule to a software update group. The System Center 2012 Configuration Manager server downloads content files and copies them to distribution points, and then updates client computers.

Parameters

-AddToExistingSoftwareUpdateGroup<Boolean>

Indicates whether the rule adds to an existing update group. If this value is $True, each time the rule runs and finds new updates, it adds them to an existing update group. If this value is $False, it creates a new update group. Specify the existing update group or assign a name for the new update group by using the DeploymentPackageName parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AlertTime<Int32>

Specifies an integer offset from an update deployment deadline. The rule uses this value to specify when the rule generates alerts. Specify a time unit by using the AlertTimeUnit parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AlertTimeUnit<TimeUnitType>

Specifies a unit of time for the AlertTime parameter. The acceptable values for this parameter are:

-- Days
-- Hours
-- Months
-- Weeks

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AllowRestart<Boolean>

Indicates whether to allow a computer to restart if the update deployment takes place outside of a maintenance window. A maintenance window is a specified period of time used for computer maintenance and updates. If this value is $True, this Configuration Manager restarts the computer, if necessary to complete the update. If this value is $False, Configuration Manager does not restart the computer.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AllowSoftwareInstallationOutsideMaintenanceWindow<Boolean>

Indicates whether the update deployment takes place even if scheduled outside of a maintenance window. A maintenance window is a specified period of time used for computer maintenance and updates. If this value is $True, this Configuration Manager deploys the update even the scheduled time falls outside the service window. If this value is $False, Configuration Manager does not deploy the update outside the service window, but Configuration Manager waits until it can deploy in a service window.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AllowUseMeteredNetwork<Boolean>

Indicates whether to allow clients to download content over a metered Internet connection after the deadline, which may incur additional expense.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ArticleId<String[]>

Specifies an array of criteria, as strings, for software updates. The rule adds software updates that have article IDs that meet specified criteria to the software update group.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AvailableImmediately<Boolean>

Indicates whether this rule deploys updates as soon as the updates become available. If you select a value of $False, use the AvailableTime and AvailableTimeUnit parameters to specify how long after the rule runs to deploy the updates.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AvailableTime<Int32>

Specifies a period of time as an integer. Configuration Manager deploys the updates this long after the rule runs. Specify a time unit by using the AvailableTimeUnit parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AvailableTimeUnit<TimeUnitType>

Specifies a unit of time for the AvailableTime parameter. The acceptable values for this parameter are:

-- Days
-- Hours
-- Months
-- Weeks

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-BulletinId<String[]>

Specifies an array of criteria, as strings, for software updates. The rule adds software updates that have bulletin IDs that meet specified criteria to the software update group.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CollectionName<String>

Specifies the name of device collection or user collection.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CustomSeverity<SeverityType[]>

Specifies an array of custom severity types for software updates. The rule adds software updates that have custom severity levels that meet specified criteria to the software update group. 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

-DateReleasedOrRevised<DateReleasedOrRevisedType>

Specifies a date released or revised for software updates. The rule adds software updates that have a date that meets specified criteria to the software update group. The acceptable values for this parameter are:

-- Last10months
-- Last11months
-- Last12hours
-- Last14days
-- Last16hours
-- Last1day
-- Last1hour
-- Last1month
-- Last1year
-- Last20hours
-- Last21days
-- Last28days
-- Last2days
-- Last2hours
-- Last2months
-- Last3days
-- Last3hours
-- Last3months
-- Last4days
-- Last4hours
-- Last4months
-- Last5days
-- Last5months
-- Last6days
-- Last6months
-- Last7days
-- Last7months
-- Last8hours
-- Last8months
-- Last9months

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeadlineImmediately<Boolean>

Indicates whether to impose the deadline as soon as the rule runs. If you specify a value of $False, use the DeadlineTime and DeadlineTimeUnit parameters to specify how long after the rule runs to set the deadline. After the deadline, Configuration Manager installs required updates.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeadlineTime<Int32>

Specifies a period of time as an integer. The deadline for updates is this long after the rule runs. Specify a time unit by using the DeadlineTimeUnit parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeadlineTimeUnit<TimeUnitType>

Specifies a unit of time for the DeadlineTime parameter. The acceptable values for this parameter are:

-- Days
-- Hours
-- Months
-- Weeks

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeployWithoutLicense<Boolean>

Indicates whether the rule deploys updates without licenses. If you specify a value of $True, Configuration Manager deploys all updates for this rule and approves any license agreements. If this value is $False, Configuration Manager deploys only updates that do not include a license or for which the license agreement has been approved.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Description<String>

Specifies a description for the automatic deployment rule for software updates.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DisableOperationManager<Boolean>

Indicates whether to disable System Center 2012 – Operations Manager alerts during software updates.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DownloadFromMicrosoftUpdate<Boolean>

Indicates whether computers download content from Microsoft Update if that content is unavailable on a preferred distribution point of remote distribution point.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnabledAfterCreate<Boolean>

Indicates whether to enable software deployment for the associated software update group after this rule runs. If this value is $False, deploy the software update group manually.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Force

Forces the command to run without asking for user confirmation.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-GenerateOperationManagerAlert<Boolean>

Indicates whether to generate Operations Manager alerts during a software update.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-GenerateSuccessAlert<Boolean>

Indicates whether to generate an alert for successful deployment.

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 automatic deployment rules for software updates.

Aliases

AutoDeploymentId

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

Specifies an object representing an automatic deployment rule for software updates. To obtain an object representing a rule, use the Get-CMSoftwareUpdateAutoDeploymentRule cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Language<String[]>

Specifies an array of criteria, as strings, for software updates. The rule adds software updates that have languages that meet specified criteria to the software update group.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-LanguageSelection<String[]>

Specifies an array of languages, as strings. Computers download software updates available in the specified languages, in addition to non-language-specific updates.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MicrosoftAsVendor<Boolean>

Indicates whether the rule includes only updates that have Microsoft as the vendor.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

Specifies a name for the automatic deployment rule for software updates.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-NewName<String>

Specifies a new name for the automatic deployment rule for software updates.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-NoInstallOnRemote<Boolean>

Indicates whether to disallow installation of updates on remote systems. If you specify a value of $True, if the client is within a slow or unreliable network boundary, or when the client uses a fallback source location for content, then Configuration Manager does not install software updates. If you specify a value of $False, installation proceeds.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-NoInstallOnUnprotected<Boolean>

Indicates whether to disallow installation of updates on unprotected systems. If you specify a value of $True, if software updates are not available on any preferred distribution points, Configuration Manager does not download and install software updates. If you specify a value of $False, installation proceeds.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Product<String[]>

Specifies an array of criteria, as strings, for software updates. The rule adds software updates for products that meet specified criteria to the software update group.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Required<String[]>

Specifies an array of criteria, as strings, for software updates. The rule adds software updates identified by required that meet specified criteria to the software update group.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-RunType<RunType>

Specifies the mode in which an update runs on the client computer. The acceptable values for this parameter are:

-- DoNotRunThisRuleAutomatically
-- RunTheRuleAfterAnySoftwareUpdatePointSynchronization
-- RunTheRuleOnSchedule

If you specify RunTheRuleOnSchedule, specify a schedule by using the Schedule parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Schedule<IResultObject>

Specifies a schedule object for the deployment. To obtain a schedule object, use the New-CMSchedule cmdlet. Specify a schedule for this parameter if you specify a value of RunTheRuleOnSchedule for the RunType parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SendWakeUpPacket<Boolean>

Indicates whether to send a wake up packet to computers before the deployment begins. If this value is $True, Configuration Manager wakes a computer from sleep. If this value is $False, it does not wake computers from sleep. For computers to wake, you must first configure Wake On LAN.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Severity<SeverityType[]>

Specifies an array of severity levels for software updates. The rule adds software updates for specified severity types to the software update group. 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

-SuccessPercentage<Int32>

Specifies a percentage for client compliance as an integer from 0 to 99. If compliance falls below this percentage, Configuration Manager produces optional alerts.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Superseded<Boolean>

Indicates whether the rule adds updates superseded by other updates.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SuppressRestartServer<Boolean>

Indicates whether to suppress a required update for a server. Some software updates require a system restart to complete the installation process.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SuppressRestartWorkstation<Boolean>

Indicates whether to suppress a required update for a workstation. Some software updates require a system restart to complete the installation process.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Title<String[]>

Specifies an array of criteria, as strings, for software updates. The rule adds software updates that have titles that meet specified criteria to the software update group.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UpdateClassification<String[]>

Specifies an array of criteria, as strings, for software updates. The rule adds software updates that have update classifications that meet specified criteria to the software update group.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UpdateDescription<String[]>

Specifies an array of criteria, as strings, for software updates. The rule adds software updates that have update descriptions that meet specified criteria to the software update group.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UseBranchCache<Boolean>

Indicates whether to use a branch cache for this update deployment. If you specify a value of $True, clients share content on the same subnet.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserNotification<UserNotificationType>

Specifies the type of user notification. The acceptable values for this parameter are:

-- DisplayAll. Display in Software Center and show all notifications.
-- DisplaySoftwareCenterOnly. Display in Software Center, and only show notifications of computer restarts.
-- HideAll. Hide in Software Center and all notifications.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UseUtc<Boolean>

Indicates whether to use UTC (Coordinated Universal Time), also known as Greenwich Mean Time. If this value is $True, Configuration Manager uses UTC for this deployment. If this value is $False, Configuration Manager uses local time.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-VerboseLevel<VerboseLevelType>

Specifies the level of detail you want clients to report for deployments that this rule creates. The acceptable values for this parameter are:

-- AllMessages
-- OnlyErrorMessages
-- OnlySuccessAndErrorMessages

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-WriteFilterHandling<Boolean>

Indicates whether to enable write filters for embedded devices. For a value of $True, the device commits changes during a maintenance window. This action requires a restart. For a value of $False, the device saves changes in an overlay and commits them later.

Aliases

none

Required?

false

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: Modify the language selection and name of a rule

This command modifies the automatic deployment rule named DeploymentRule07. The command specifies Portuguese (Brazil) as the language selection. The command also changes the name of the rule to DeploymentRule07Revised.

PS C:\> Set-CMSoftwareUpdateAutoDeploymentRule -Name "DeploymentRule07" -NewName "DeploymentRule07Revised" -Description "Update rule to use Portuguese (Brazil)." -LanguageSelection "Portuguese (Brazil)"

Disable-CMSoftwareUpdateAutoDeploymentRule

Enable-CMSoftwareUpdateAutoDeploymentRule

Get-CMSoftwareUpdateAutoDeploymentRule

Invoke-CMSoftwareUpdateAutoDeploymentRule

New-CMSoftwareUpdateAutoDeploymentRule

Remove-CMSoftwareUpdateAutoDeploymentRule