New-​CM​Task​Sequence​Deployment

Creates a task sequence deployment

Syntax

New-CMTaskSequenceDeployment
   [-InputObject] <IResultObject>
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Availability <MakeAvailableToType>]
   [-AvailableDateTime <DateTime>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Comment <String>]
   [-Confirm]
   [-DeadlineDateTime <DateTime>]
   [-DeployPurpose <DeployPurposeType>]
   [-DeploymentOption <DeploymentOptionType>]
   [-DisableWildcardHandling]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-ForceWildcardHandling]
   [-InternetOption <Boolean>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
New-CMTaskSequenceDeployment
   [-TaskSequencePackageId] <String>
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Availability <MakeAvailableToType>]
   [-AvailableDateTime <DateTime>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Comment <String>]
   [-Confirm]
   [-DeadlineDateTime <DateTime>]
   [-DeployPurpose <DeployPurposeType>]
   [-DeploymentOption <DeploymentOptionType>]
   [-DisableWildcardHandling]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-ForceWildcardHandling]
   [-InternetOption <Boolean>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

{{Fill in the Description}}

Examples

Example 1

PS C:\> {{ Add example code here }}

{{ Add example description here }}

Required Parameters

-InputObject

{{Fill InputObject Description}}

Type:IResultObject
Aliases:TaskSequence
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-TaskSequencePackageId

{{Fill TaskSequencePackageId Description}}

Type:String
Aliases:PackageId, TaskSequenceId
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AlertDateTime

{{Fill AlertDateTime Description}}

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

{{Fill AllowFallback Description}}

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

{{Fill AllowSharedContent Description}}

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

{{Fill Availability Description}}

Type:MakeAvailableToType
Aliases:MakeAvailableTo
Parameter Sets:Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AvailableDateTime

{{Fill AvailableDateTime Description}}

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

{{Fill Collection Description}}

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

{{Fill CollectionId Description}}

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

{{Fill CollectionName Description}}

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

{{Fill Comment Description}}

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:None
Accept pipeline input:False
Accept wildcard characters:False
-DeadlineDateTime

{{Fill DeadlineDateTime Description}}

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

{{Fill DeployPurpose Description}}

Type:DeployPurposeType
Parameter Sets:Available, Required
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentOption

{{Fill DeploymentOption Description}}

Type:DeploymentOptionType
Parameter Sets:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
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
-DistributeCollectionName

{{Fill DistributeCollectionName Description}}

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

{{Fill DistributeContent Description}}

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

{{Fill DistributionPointGroupName Description}}

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

{{Fill DistributionPointName Description}}

Type:String
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
-InternetOption

{{Fill InternetOption Description}}

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

{{Fill PercentFailure Description}}

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

{{Fill PercentSuccess Description}}

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

{{Fill PersistOnWriteFilterDevice Description}}

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

{{Fill RerunBehavior Description}}

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

{{Fill RunFromSoftwareCenter Description}}

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

{{Fill Schedule Description}}

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

{{Fill ScheduleEvent Description}}

Type:ScheduleEventType[]
Parameter Sets:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SendWakeupPacket

{{Fill SendWakeupPacket Description}}

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

{{Fill ShowTaskSequenceProgress Description}}

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

{{Fill SoftwareInstallation Description}}

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

{{Fill SystemRestart Description}}

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

{{Fill UseMeteredNetwork Description}}

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

{{Fill UseUtcForAvailableSchedule Description}}

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

{{Fill UseUtcForExpireSchedule Description}}

Type:Boolean
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:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject#SMS_Advertisement