New-CMSoftwareUpdateAutoDeploymentRule

Creates Configuration Manager deployment rules for automatic software updates.

Syntax

New-CMSoftwareUpdateAutoDeploymentRule
   -Name <String>
   [-Description <String>]
   -Collection <IResultObject>
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-DeployWithoutLicense <Boolean>]
   [-ArticleId <String[]>]
   [-BulletinId <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-UpdateDescription <String[]>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Severity <SeverityType[]>]
   [-Superseded <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-Product <String[]>]
   [-MicrosoftAsVendor <Boolean>]
   [-Vendor <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackageName <String>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-IsServicingPlan]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
   -Name <String>
   [-Description <String>]
   -CollectionId <String>
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-DeployWithoutLicense <Boolean>]
   [-ArticleId <String[]>]
   [-BulletinId <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-UpdateDescription <String[]>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Severity <SeverityType[]>]
   [-Superseded <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-Product <String[]>]
   [-MicrosoftAsVendor <Boolean>]
   [-Vendor <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackageName <String>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-IsServicingPlan]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
   -Name <String>
   [-Description <String>]
   -CollectionName <String>
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-DeployWithoutLicense <Boolean>]
   [-ArticleId <String[]>]
   [-BulletinId <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-UpdateDescription <String[]>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Severity <SeverityType[]>]
   [-Superseded <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-Product <String[]>]
   [-MicrosoftAsVendor <Boolean>]
   [-Vendor <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackageName <String>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-IsServicingPlan]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-CMSoftwareUpdateAutoDeploymentRule cmdlet creates Microsoft System Center Configuration Manager deployment rules for automatic software updates.

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

Examples

Example 1: Create an automatic deployment rule

PS C:\> New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Desktops" -DeploymentPackageName "Updates123" -Name "DeploymentRule07" -ArticleId "117"

This command creates a deployment rule named DeploymentRule07 for the collection named Desktops and the deployment package named Updates123. The rule deploys updates that have an article ID that contains 117.

Example 2: Create an automatic deployment rule that uses a schedule

PS C:\> $Schedule = New-CMSchedule -DayOfWeek Wednesday
PS C:\> New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Laptops" -DeploymentPackageName "Updates235" -Name "DeploymentRule22" -AddToExistingSoftwareUpdateGroup $False -AlertTime 4 -AlertTimeUnit Weeks -AllowRestart $True -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowUseMeteredNetwork $True -ArticleId "test" -AvailableImmediately $False -AvailableTime 5 -AvailableTimeUnit Months -CustomSeverity Critical -DateReleasedOrRevised Last1day -DeadlineImmediately $False -DeadlineTime $True -DeadlineTimeUnit Hours -DeployWithoutLicense $True -Description "Standard updates for our laptop systems." -DisableOperationManager $True -DownloadFromInternet $False -DownloadFromMicrosoftUpdate $True -EnabledAfterCreate $False -GenerateOperationManagerAlert $True -GenerateSuccessAlert $True -Language "Catalan" -LanguageSelection "English" -Location "\\k\aS_O15_Client_Dev_1" -MicrosoftAsVendor $True -NoInstallOnRemote $False -NoInstallOnUnprotected $True -RunType RunTheRuleOnSchedule -Schedule $Schedule -SendWakeUpPacket $True -SuccessPercent 99 -Superseded $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -UpdateClassification "Critical Updates" -UseBranchCache $False -UserNotification DisplayAll -UseUtc $True -VerboseLevel AllMessages -WriteFilterHandling $True

This example creates an automatic deployment rule that uses a defined schedule. Deployment occurs according to the schedule.

The first command creates a schedule for the Wednesday day of the week, and stores the schedule object in the $Schedule variable. For more information, see help for New-CMSchedule.

The second command creates an automatic deployment rule for updates that uses the schedule object stored in the $Schedule variable. This command specifies values for many parameters.

Required Parameters

-Collection
Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CollectionId
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CollectionName

Specifies the name of device collection or user collection.

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

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

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

Optional Parameters

-AddToExistingSoftwareUpdateGroup

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.

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

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.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AlertTimeUnit

Specifies a unit of time for the AlertTime parameter. Valid values are:

  • Days
  • Hours
  • Months
  • Weeks
Type:TimeUnitType
Parameter Sets:Hours, Days, Weeks, Months
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowRestart

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, Configuration Manager restarts the computer, if necessary, to complete the update. If this value is $False, Configuration Manager does not restart the computer.

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

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, 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.

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

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

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

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.

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

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.

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

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.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AvailableTimeUnit

Specifies a unit of time for the AvailableTime parameter. Valid values are:

  • Days
  • Hours
  • Months
  • Weeks
Type:TimeUnitType
Parameter Sets:Hours, Days, Weeks, Months
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BulletinId

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.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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 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. Valid values are:

  • Critical
  • Important
  • Low
  • Moderate
  • None
Type:SeverityType[]
Parameter Sets:None, Low, Moderate, Important, Critical
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DateReleasedOrRevised

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. Valid values 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
Type:DateReleasedOrRevisedType
Parameter Sets:Any, Last1Hour, LastHour, Last2Hours, Last3Hours, Last4Hours, Last8Hours, Last12Hours, Last16Hours, Last20Hours, Last1Day, LastDay, Last2Days, Last3Days, Last4Days, Last5Days, Last6Days, Last7Days, Last14Days, Last21Days, Last28Days, LastMonth, Last1Month, Last2Months, Last3Months, Last4Months, Last5Months, Last6Months, Last7Months, Last8Months, Last9Months, Last10Months, Last11Months, Last1Year, LastYear, Last12Months
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeadlineImmediately

Indicates whether to impose the deadline is 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.

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

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.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeadlineTimeUnit

Specifies a unit of time for the DeadlineTime parameter. Valid values are:

  • Days
  • Hours
  • Months
  • Weeks
Type:TimeUnitType
Parameter Sets:Hours, Days, Weeks, Months
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeployWithoutLicense

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentPackage
Type:IResultObject
Aliases:InputObject
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-DeploymentPackageName

Specifies the name of a software update deployment package.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentRing
Type:DeploymentRing
Parameter Sets:CB, Release, BusinessMainstream, Cbb, Ltsb
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

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

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

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

Type:Boolean
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
-DownloadFromInternet

Indicates whether computers download software updates from the Internet. If you specify a value of $False, specify an alternative location where computers can download updates by using the Location parameter.

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

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Enable
Type:Boolean
Aliases:Enabled, EnableDeployment
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnabledAfterCreate

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.

Type:Boolean
Aliases:EnableAfterCreate
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
-GenerateFailureAlert
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-GenerateOperationManagerAlert

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

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

Indicates whether to generate an alert for successful deployment.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IsServicingPlan
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Language

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.

Type:String[]
Aliases:Languages, UpdateLocales, UpdateLocale
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LanguageSelection

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

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

Specifies a location in your network where computers can download software updates. In order to use this location, specify a value of $False for the DownloadFromInternet parameter.

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

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

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

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.

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

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.

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

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.

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

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.

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

Specifies the mode in which an update runs on the client computer. Valid values are:

  • DoNotRunThisRuleAutomatically
  • RunTheRuleAfterAnySoftwareUpdatePointSynchronization
  • RunTheRuleOnSchedule

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

Type:RunType
Parameter Sets:DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Schedule

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.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SendWakeupPacket

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.

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

Specifies an array of severity levels for software updates. The rule adds software updates for specified severity types to the software update group. Valid values are:

  • Critical
  • Important
  • Low
  • Moderate
  • None
Type:SeverityType[]
Aliases:Severities
Parameter Sets:None, Low, Moderate, Important, Critical
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SuccessPercentage

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Superseded

Indicates whether the rule adds updates superseded by other updates.

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

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

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

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

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

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.

Type:String[]
Aliases:Titles
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpdateClassification

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.

Type:String[]
Aliases:UpdateClassifications
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpdateDeploymentWaitDay
Type:Int32
Aliases:UpdateDeploymentWaitDays
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpdateDescription

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.

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

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.

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

Indicates whether to use Coordinated Universal Time (UTC), 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.

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

Specifies the type of user notification. Valid values 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.
Type:UserNotificationType
Parameter Sets:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Vendor
Type:String[]
Aliases:Vendors
Parameter Sets:Microsoft, Local Publisher
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VerboseLevel

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

  • AllMessages
  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
Type:VerboseLevelType
Parameter Sets:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
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
-WriteFilterHandling

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.

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