New-CMTaskSequenceDeployment

参考

模块:: ConfigurationManager

创建任务序列部署。

语法

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

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

说明

New-CMTaskSequenceDeployment cmdlet 创建任务序列部署。任务序列部署将任务序列分配给计算机的集合。

注意

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

示例

示例 1：部署具有许多常见参数的任务序列

此示例执行以下操作：

使用 Get-CMTaskSequence cmdlet 获取要部署的任务序列对象，并将其保存在 $DeployTS 变量中
在变量中将集合定义为部署的目标 $DeployCollection
在变量中定义 2025 年 11 月 25 日晚上 8：00 的部署可用 时间$DeployAvailableTime
在变量中定义 2026 年 1 月 25 日晚上 8：00 的部署过期时间 $DeployExpireTime
在变量中定义 2025 年 12 月 25 日晚上 8：00 的部署 截止时间$ScheduleDateTime
使用 New-CMSchedule cmdlet 创建具有每日重复计划的截止时间的计划对象。
部署任务序列

$DeployTS = Get-CMTaskSequence -TaskSequencePackageId 'PS104823'
$DeployCollection = 'PS11B7C4'
$DeployAvailableTime = [datetime]::ParseExact("20251125-200000", "yyyyMMdd-HHmmss", $null)
$DeployExpireTime = [datetime]::ParseExact("20260125-200000", "yyyyMMdd-HHmmss", $null)
$ScheduleDateTime = [datetime]::ParseExact("20251225-200000", "yyyyMMdd-HHmmss", $null)
$DeploySchedule = New-CMSchedule -DurationInterval Days -RecurInterval Days -RecurCount 1 -DurationCount 0 -Start $ScheduleDateTime
New-CMTaskSequenceDeployment -InputObject $DeployTS -DeployPurpose Required -AvailableDateTime $DeployAvailableTime -Availability Clients -RerunBehavior AlwaysRerunProgram -Schedule $DeploySchedule -CollectionId $DeployCollection -ShowTaskSequenceProgress $true -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -RunFromSoftwareCenter $true -DeadlineDateTime $DeployExpireTime

参数

-AlertDateTime

如果启用部署警报，请使用此参数指定警报的时间。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AllowFallback

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AllowSharedContent

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

类型:	Boolean
别名:	AllowUseRemoteDistributionPoint
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Availability

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

类型:	MakeAvailableToType
别名:	MakeAvailableTo
接受的值:	Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AvailableDateTime

指定此部署 何时可用。

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

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Collection

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

类型:	IResultObject
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CollectionId

指定集合 ID 作为此任务序列部署的目标。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CollectionName

指定集合名称作为此任务序列部署的目标。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-Comment

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeadlineDateTime

使用此参数可指定部署 何时过期。

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

类型:	DateTime
别名:	DeploymentExpireDateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeploymentOption

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

类型:	DeploymentOptionType
接受的值:	DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeployPurpose

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

类型:	DeployPurposeType
接受的值:	Available, Required
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DistributeCollectionName

站点将内容分发到与此集合名称关联的分发点组。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DistributeContent

添加此参数以在创建此部署时分发任务序列内容。在将内容分发到客户端可以访问的分发点之前，客户端无法安装任务序列。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DistributionPointGroupName

站点将内容分发到此分发点组。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DistributionPointName

站点将内容分发到此分发点。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

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

类型:	IResultObject
别名:	TaskSequence
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-InternetOption

允许任务序列为 Internet 上的客户端运行。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PercentFailure

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

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PercentSuccess

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

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PersistOnWriteFilterDevice

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

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RerunBehavior

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

类型:	RerunBehaviorType
接受的值:	NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RunFromSoftwareCenter

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

类型:	Boolean
别名:	AllowUsersRunIndependently
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Schedule

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

使用 -AvailableDateTime 指定部署 何时可用，使用 -DeadlineDateTime 指定部署 到期时间。

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

类型:	IResultObject[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ScheduleEvent

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

类型:	ScheduleEventType[]
接受的值:	AsSoonAsPossible, LogOn, LogOff
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SendWakeupPacket

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ShowTaskSequenceProgress

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SoftwareInstallation

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SystemRestart

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TaskSequencePackageId

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

类型:	String
别名:	PackageId, TaskSequenceId
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-UseMeteredNetwork

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseUtcForAvailableSchedule

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseUtcForExpireSchedule

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

请确保正确使用计划参数：

-AvailableDateTime：指定此部署 何时可用。
-DeadlineDateTime：指定部署 过期的时间。
-Schedule：指定部署分配或 截止时间。

反馈

此页面是否有帮助？