Set-CMTaskSequenceDeployment

配置任务序列部署。

语法

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   -InputObject <IResultObject>
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequenceDeploymentId <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequenceName <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequencePackageId <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

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

注意

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

示例

示例 1:配置部署以显示进度

此命令使用任务序列名称和集合名称配置任务序列部署。 它设置注释并使客户端能够显示任务序列进度。

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Systems" -Comment "Task sequence test" -ShowTaskSequenceProgress $True

示例 2:重新配置任务序列部署

此命令将重新配置任务序列部署的大部分设置。

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Desktop and Server Clients" -Comment "Task sequence test" -SendWakeupPacket $True -UseMeteredNetwork $True -DeploymentExpireDateTime $(Get-Date) -ScheduleEvent LogOff -RerunBehavior NeverRerunDeployedProgram -AllowUsersRunIndependently $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -InternetOption $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowFallback $True -AllowSharedContent $True

参数

-AddSchedule

指定要添加到部署的计划令牌对象。 若要创建计划对象,请使用 New-CMSchedule cmdlet。

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

-AddScheduleEvent

指定要添加到部署的接受计划事件之一。

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

-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

-AllowUsersRunIndependently

指示是否允许用户独立运行程序,而不考虑其分配状态。

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

-ClearSchedule

添加此参数以从部署中删除所有计划。

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

-ClearScheduleEvent

添加此参数可从部署中删除所有计划事件。

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

-Collection

指定集合对象作为部署的目标。

类型: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
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-CreateAlertOnFailure

指示是否在失败时创建警报。

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

-CreateAlertOnSuccess

指示是否创建成功警报。

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

-DeploymentAvailableDateTime

指定部署可用日期时间。

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

-DeploymentExpireDateTime

指定部署到期日期时间。

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

-DeploymentOption

指定客户端是先下载所有内容然后再启动任务序列,还是根据正在运行的任务序列的需要下载内容。

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

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

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

-InternetOption

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

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

-MakeAvailableTo

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

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

-PassThru

返回当前工作对象。 默认情况下,此 cmdlet 不会生成任何输出。

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

-PercentFailure

指定任务序列部署失败的阈值百分比。

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

-PercentSuccess

指定成功部署任务序列的阈值百分比。

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

-PersistOnWriteFilterDevice

指示是在临时覆盖上安装任务序列并稍后提交更改,还是在安装截止时间或维护时段提交更改。 此设置适用于运行具有写入筛选器的 Windows 嵌入式版本的设备。

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

-RemoveSchedule

指定要从部署中删除的计划令牌对象。 若要创建计划对象,请使用 New-CMSchedule cmdlet。

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

-RemoveScheduleEvent

指定要从部署中删除的接受计划事件之一。

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

-RerunBehavior

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

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

-Schedule

指定 CMSchedule 对象的数组。 CMSchedule 对象定义部署的强制分配计划。 若要创建 CMSchedule 对象,请使用 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

指示是否允许应用程序安装,即使安装发生在维护时段之外。

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

-SystemRestart

指示是否允许播发的程序重启系统,即使重启发生在维护时段外也是如此。

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

-TaskSequenceDeploymentId

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

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

-TaskSequenceName

指定要部署的任务序列的名称。

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

-TaskSequencePackageId

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

类型:String
Position:Named
默认值: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
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject