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