Start-CMTaskSequenceDeployment

模块:

ConfigurationManager

(已弃用) 启动任务序列部署。

语法

Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InputObject] <IResultObject>
     [-InternetOption <Boolean>]
     [-PassThru]
     [-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>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-TaskSequencePackageId] <String>
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

重要

[!注释] 不推荐使用此 cmdlet。 请改用 New-CMTaskSequenceDeployment 。

使用此 cmdlet 启动任务序列部署。 任务序列部署将任务序列分配给计算机的集合。 有关详细信息，请参阅在 Configuration Manager 中部署任务序列。

注意

从Configuration Manager站点驱动器运行Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：使用默认选项启动任务序列部署

此命令使用任务序列部署的名称和集合的名称启动任务序列部署。

Get-CMTaskSequence -Name "Upgrade Windows 10" | Start-CMTaskSequenceDeployment -CollectionName "Collection 01"

示例 2：使用配置的选项启动任务序列部署

此命令使用多个配置的选项启动任务序列部署。

Start-CMTaskSequenceDeployment -TaskSequencePackageId "XYZ00003" -CollectionName "Collection 02" -Comment "Task sequence test" -DeployPurpose Required -SendWakeUpPacket $True -UseMeteredNetwork $True -ScheduleEvent AsSoonAsPossible -RerunBehavior NeverRerunDeployedProgram -RunFromSoftwareCenter $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -AllowFallback $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowSharedContent $True -InternetOption $True

参数

-AlertDateTime

配置部署以创建成功部署的警报时，请使用此参数指定 DateTime 对象。 Configuration Manager在此日期之后的阈值低于 PercentSuccess 时创建部署警报。

若要获取此对象，请使用 Get-Date 内置 cmdlet。

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

-AlertDay

此参数已弃用。 使用 AlertDateTime。

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

-AlertTime

此参数已弃用。 使用 AlertDateTime。

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

-AllowFallback

允许客户端使用默认站点边界组中的分发点。

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

-AllowSharedContent

允许客户端使用相邻边界组中的分发点。

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

-Availability

指定是否使此任务序列可用于Configuration Manager客户端，以及它是否可用于使用启动媒体、预留媒体或 PXE 部署 OS 时运行。

如果指定 Clients，则 DeploymentOption 参数的默认值为 DownloadAllContentLocallyBeforeStartingTaskSequence。 如果指定 ClientsMediaAndPxe、 MediaAndPxe或 MediaAndPxeHidden，则 DeploymentOption 参数的默认值为 DownloadContentLocallyWhenNeededByRunningTaskSequence。

Type:	MakeAvailableToType
Aliases:	MakeAvailableTo
Accepted values:	Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

指定将此任务序列部署到的集合对象。 若要获取此对象，请使用 Get-CMCollection cmdlet。

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

-CollectionId

指定此任务序列部署到的集合的 ID。

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

-CollectionName

指定此任务序列部署到的集合的名称。

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

-Comment

为任务序列部署指定可选注释。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentAvailableDateTime

指定此部署可用的DateTime 对象。 若要获取此对象，请使用 Get-Date 内置 cmdlet。

使用 DeploymentExpireDateTime 指定部署 过期时间，使用 Schedule 指定部署分配或 截止时间。

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

-DeploymentAvailableDay

此参数已弃用。 使用 DeploymentAvailableDateTime。

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

-DeploymentAvailableTime

此参数已弃用。 使用 DeploymentAvailableDateTime。

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

-DeploymentExpireDateTime

指定此部署过期时的 DateTime 对象。 若要获取此对象，请使用 Get-Date 内置 cmdlet。

使用 DeploymentAvailableDateTime 指定部署 何时可用，使用 Schedule 指定部署分配或 截止时间。

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

-DeploymentExpireDay

此参数已弃用。 使用 DeploymentExpireDateTime。

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

-DeploymentExpireTime

此参数已弃用。 使用 DeploymentExpireDateTime。

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

-DeploymentOption

指定客户端如何与分发点交互以获取任务序列的内容。 并非所有选项都在特定方案中可用。 有关详细信息，请参阅 部署任务序列 - 部署选项。

如果为可用性参数指定Clients，则此参数的默认值为 。DownloadAllContentLocallyBeforeStartingTaskSequence 如果为 Availability 参数指定 ClientsMediaAndPxe、 MediaAndPxe或 MediaAndPxeHidden ，则此参数的默认值为 DownloadContentLocallyWhenNeededByRunningTaskSequence。

Type:	DeploymentOptionType
Accepted values:	DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeployPurpose

指定此部署是可供用户安装，还是需要在截止时间安装。

Type:	DeployPurposeType
Accepted values:	Available, Required
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

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

-InputObject

指定任务序列部署对象。 若要获取此对象，请使用 Get-CMTaskSequenceDeployment cmdlet。

Type:	IResultObject
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InternetOption

指示任务序列是否在通过 Internet 连接的客户端上运行。

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

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

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

-PercentFailure

如果为失败的部署创建警报，则当失败的部署百分比高于此数字时，站点将生成警报。

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

-PercentSuccess

如果为成功的部署创建警报，则当成功部署的百分比低于此数字时，站点将生成警报。

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

-PersistOnWriteFilterDevice

配置客户端在 Windows Embedded 设备上处理写入筛选器的方式。

• $true：在截止时间或维护时段内提交更改。 需要重启。
• $false：在覆盖层上应用内容，稍后提交。

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

-RerunBehavior

指定如果任务序列以前在计划的强制时间之前运行，则是否在计算机上重新运行。 默认情况下，任务序列始终重新运行。

Type:	RerunBehaviorType
Accepted values:	NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunFromSoftwareCenter

允许用户独立于分配运行程序。

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

-Schedule

使用此参数可以指定部署分配或 截止时间。

使用 AvailableDateTime 指定部署 何时可用，使用 DeadlineDateTime 指定部署 何时过期。

指定计划对象的数组。 计划对象定义部署的强制分配计划。 若要创建计划对象，请使用 New-CMSchedule cmdlet。

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

-ScheduleEvent

指定确定任务序列部署何时运行的事件数组。

Type:	ScheduleEventType[]
Accepted values:	AsSoonAsPossible, LogOn, LogOff
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SendWakeupPacket

指示是否在部署开始前将唤醒数据包发送到计算机。 如果此值为 $True，Configuration Manager将计算机从睡眠状态唤醒。 如果此值为 $False，则不会将计算机从睡眠状态唤醒。 对于要唤醒的计算机，请先配置 LAN 唤醒。

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

-ShowTaskSequenceProgress

指示是否显示任务序列的进程对话框。

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

-SoftwareInstallation

达到安装截止时间时，将此参数设置为 $true 以允许任务序列在维护时段外安装。

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

-SystemRestart

达到安装截止时间时，将此参数设置为 以 $true 允许系统在维护时段外重新启动（如有必要）。

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

-TaskSequencePackageId

指定要部署的任务序列的 ID。

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

-UseMeteredNetwork

指示是否允许使用按流量计费的 Internet 连接的客户端在安装截止时间后下载内容，这可能会产生额外的成本。

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

-UseUtcForAvailableSchedule

指示客户端计算机是否使用 UTC 时间来确定程序的可用性。 UTC 时间使任务序列同时可供所有计算机使用。

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

-UseUtcForExpireSchedule

指示客户端计算机是否使用 UTC 时间来确定程序的过期时间。 UTC 时间使任务序列同时可供所有计算机使用。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

相关链接

• New-CMTaskSequenceDeployment
• Get-CMTaskSequenceDeployment
• Set-CMTaskSequenceDeployment
• Remove-CMTaskSequenceDeployment
• 在 Configuration Manager 中部署任务序列