Set-CMTaskSequenceDeployment

Creates a task sequence deployment in Configuration Manager.

Syntax

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AlertDay <DateTime>]
   [-AlertTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-CollectionName <String>]
   [-Comment <String>]
   [-Confirm]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentAvailableDay <DateTime>]
   [-DeploymentAvailableTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentExpireDay <DateTime>]
   [-DeploymentExpireTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -InputObject <IResultObject>
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PassThru]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMTaskSequenceDeployment [-AlertDateTime ] [-AlertDay ] [-AlertTime ]
 [-AllowFallback ] [-AllowSharedContent ] [-AllowUsersRunIndependently ]
 -CollectionName  [-Comment ] [-Confirm] [-CreateAlertOnFailure ]
 [-CreateAlertOnSuccess ] [-DeploymentAvailableDateTime ]
 [-DeploymentAvailableDay ] [-DeploymentAvailableTime ]
 [-DeploymentExpireDateTime ] [-DeploymentExpireDay ] [-DeploymentExpireTime ]
 [-DeploymentOption ] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-InternetOption ] [-MakeAvailableTo ] [-PassThru] [-PercentFailure ]
 [-PercentSuccess ] [-PersistOnWriteFilterDevice ] [-RerunBehavior ]
 [-Schedule ] [-ScheduleEvent ] [-SendWakeupPacket ]
 [-ShowTaskSequenceProgress ] [-SoftwareInstallation ] [-SystemRestart ]
 -TaskSequenceName  [-UseMeteredNetwork ] [-UseUtcForAvailableSchedule ]
 [-UseUtcForExpireSchedule ] [-WhatIf] []
Set-CMTaskSequenceDeployment [-AlertDateTime ] [-AlertDay ] [-AlertTime ]
 [-AllowFallback ] [-AllowSharedContent ] [-AllowUsersRunIndependently ]
 -CollectionName  [-Comment ] [-Confirm] [-CreateAlertOnFailure ]
 [-CreateAlertOnSuccess ] [-DeploymentAvailableDateTime ]
 [-DeploymentAvailableDay ] [-DeploymentAvailableTime ]
 [-DeploymentExpireDateTime ] [-DeploymentExpireDay ] [-DeploymentExpireTime ]
 [-DeploymentOption ] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-InternetOption ] [-MakeAvailableTo ] [-PassThru] [-PercentFailure ]
 [-PercentSuccess ] [-PersistOnWriteFilterDevice ] [-RerunBehavior ]
 [-Schedule ] [-ScheduleEvent ] [-SendWakeupPacket ]
 [-ShowTaskSequenceProgress ] [-SoftwareInstallation ] [-SystemRestart ]
 -TaskSequencePackageId  [-UseMeteredNetwork ] [-UseUtcForAvailableSchedule ]
 [-UseUtcForExpireSchedule ] [-WhatIf] []
Set-CMTaskSequenceDeployment [-AlertDateTime ] [-AlertDay ] [-AlertTime ]
 [-AllowFallback ] [-AllowSharedContent ] [-AllowUsersRunIndependently ]
 [-Comment ] [-Confirm] [-CreateAlertOnFailure ] [-CreateAlertOnSuccess ]
 [-DeploymentAvailableDateTime ] [-DeploymentAvailableDay ]
 [-DeploymentAvailableTime ] [-DeploymentExpireDateTime ] [-DeploymentExpireDay ]
 [-DeploymentExpireTime ] [-DeploymentOption ] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-InternetOption ] [-MakeAvailableTo ] [-PassThru]
 [-PercentFailure ] [-PercentSuccess ] [-PersistOnWriteFilterDevice ]
 [-RerunBehavior ] [-Schedule ] [-ScheduleEvent ]
 [-SendWakeupPacket ] [-ShowTaskSequenceProgress ] [-SoftwareInstallation ]
 [-SystemRestart ] -TaskSequenceDeploymentId  [-UseMeteredNetwork ]
 [-UseUtcForAvailableSchedule ] [-UseUtcForExpireSchedule ] [-WhatIf] []

Description

The Set-CMTaskSequenceDeployment cmdlet creates a task sequence deployment. A task sequence deployment assigns a task sequence to a collection of computers.

Examples

Example 1: Create a task sequence deployment

PS C:\> Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Systems" -Comment "Task sequence test" -ShowTaskSequenceProgress $True

This command creates the task sequence deployment by using the task sequence name and collection name.

Example 2: Create a task sequence deployment with a task sequence name

PS C:\> Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Desktop and Server Clients" -Comment "Task sequence test" -SendWakeUpPacket $True -UseMeteredNetwork $True -DeploymentExpireDay 2014/12/30 -DeploymentExpireTime 15:52 -UseUtcForExpireSchedule $True -ScheduleEvent LogOff -RerunBehavior NeverRerunDeployedProgram -AllowUsersRunIndependently $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -InternetOption $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowFallback $True -AllowSharedContent $True -CreatAlertBaseOnPercentSuccess $True -CreatAlertBaseOnPercentFailure $True

This command creates the task sequence deployment by using the task sequence name and collection name.

Required Parameters

-InputObject

Specifies an task sequence deployment object. To obtain a task sequence object, use the Get-CMTaskSequenceDeployment cmdlet.

Type:IResultObject
Aliases:Deployment, TaskSequence
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-TaskSequenceDeploymentId

Specifies an ID for a task sequence deployment.

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

Specifies a name for a task sequence.

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

Specifies an ID for a task sequence package.

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

Optional Parameters

-AlertDateTime
Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AlertDay

Specifies a day, in MM/DD/YYYY format, to trigger alerts. If you configure a percent success or failure rate for a deployment, alerts appear after this date.

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

Specifies a time, in HH:MM format, to trigger alerts. If you configure a percent success or failure rate for a deployment, alerts appear after this time.

Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowFallback

Indicates whether to allow clients to use a fallback source location for content.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowSharedContent
Type:Boolean
Aliases:AllowUseRemoteDistributionPoint
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowUsersRunIndependently

Indicates whether to allow users to independently run the program, regardless of its assignment status.

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

Specifies a name of a collection designated to receive a task sequence deployment. A collection is a group of client computers.

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

Specifies a comment for the task sequence deployment.

Type:String
Required:False
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-CreateAlertOnFailure
Type:Boolean
Aliases:CreateAlertBaseOnPercentFailure
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CreateAlertOnSuccess
Type:Boolean
Aliases:CreateAlertBaseOnPercentSuccess
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentAvailableDateTime
Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentAvailableDay

Specifies a day, in MM/DD/YYYY format, when a deployment becomes available to clients. By default, the deployment becomes available immediately.

Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentAvailableTime

Specifies a time, in HH:MM format, when a deployment becomes available to clients. By default, the deployment becomes available immediately.

Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentExpireDateTime
Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentExpireDay

Specifies a day, in MM/DD/YYYY format, when a deployment expires. By default, a deployment never expires. To expire a deployment on a certain day, set this parameter. You may use this parameter in conjunction with the DeploymentExpireTime parameter.

Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentExpireTime

Specifies a time, in HH:MM format, when the deployment expires. By default, a deployment never expires. To expire a deployment at a certain time, set this parameter. You may use this parameter in conjunction with the DeploymentExpireDay parameter.

Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentOption

Specifies if clients download all content before starting the task sequence, or download content as needed by the running task sequence. By default, clients download content as needed. The acceptable values for this parameter are:- DownloadAllContentLocallyBeforeStartingTaskSequence

  • DownloadContentLocallyWhenNeededByRunningTaskSequence
Type:DeploymentOptionType
Parameter Sets:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

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

Indicates that wildcard handling is enabled.

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

Indicates whether the task sequence runs on clients connecting over the Internet.

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

Specifies whether to make this task sequence available to Configuration Manager clients, and whether to make it available when you deploy an operating system by using boot media, prestaged media, or PXE. The acceptable values for this parameter are:- Clients

  • ClientsMediaAndPxe
  • MediaAndPxe
  • MediaAndPxeHidden
Type:MakeAvailableToType
Parameter Sets:Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

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

Specifies a threshold percentage for failed task sequence deployment.

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

Specifies a threshold percentage for successful task sequence deployment.

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

Indicates whether to install a task sequence on the temporary overlay and commit changes later, or commit the changes at an installation deadline or a maintenance window.

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

Specifies that a task sequence will be rerun on a computer if it has previously been run before the scheduled mandatory time. By default, the task sequence is always rerun. The acceptable values for this parameter are:- AlwaysRerunProgram

  • NeverRerunDeployedProgram
  • RerunIfFailedPreviousAttempt
  • RerunIfSucceededOnPreviousAttempt
Type:RerunBehaviorType
Parameter Sets:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Schedule

Specifies an array of CMSchedule objects. A CMSchedule object defines the mandatory assignment schedule for a deployment. To create a CMSchedule object, use the New-CMSchedule cmdlet.

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

Specifies an array of events that determine when the task sequence deployment runs. The acceptable values for this parameter are:- AsSoonAsPossible

  • LogOff
  • LogOn
Type:ScheduleEventType[]
Parameter Sets:AsSoonAsPossible, LogOn, LogOff
Required:False
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ShowTaskSequenceProgress

Indicates whether to show a process dialog for a task sequence.

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

Indicates whether to allow the application to install, even if the installation occurs outside of a maintenance window.

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

Indicates whether to allow an advertised program to restart the system, even if the restart occurs outside of a maintenance window.

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

Indicates whether to allow clients on a metered Internet connection to download content after the installation deadline, which might incur additional costs.

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

Indicates whether client computers use UTC time to determine the availability of a program. UTC time makes the task sequence available at the same time for all computers.

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

Indicates whether client computers use UTC time to determine the expiration of a program. UTC time makes the task sequence available at the same time for all computers.

Type:Boolean
Required:False
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False