Set-CMTaskSequencePhase

参考

模块:: ConfigurationManager

使用此 cmdlet 配置任务序列的部署阶段。

语法

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-InputObject] <IResultObject>
   [-Name <String>]
   [-Order <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentId] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentName] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

适用于版本 2006 和更高版本。使用此 cmdlet 配置任务序列的部署阶段。有关详细信息，请参阅创建分阶段部署。

示例

示例 1：更改集合

此示例更改通过命令行传递的任务序列分阶段部署中第二阶段的集合。

$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"

示例 2：上移一个阶段

本示例将一个阶段按序上移。它按 ID 选择分阶段部署，然后按关联的集合 ID 选择阶段。

Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp

示例 3：配置阶段设置

本示例更改选定阶段的配置设置。

Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12

参数

-AllowFallback

此参数与控制台中"添加阶段向导"的****"分发点"页上的**** 以下设置相同：允许客户端使用默认站点边界组的分发点。

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

-AllowRemoteDP

此参数与控制台中"添加阶段向导"的****"分发点"页上的**** 以下设置相同：当没有可用的本地分发点时，请使用远程分发点。

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

-AllowSystemRestart

此参数与控制台中"添加阶段向导"的****"用户体验"页上的**** 以下设置相同：如果需要完成安装 (请**重新启动) 。 ** 当达到安装截止时间时，此设置适用，以允许在维护时段外执行此活动。

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

-BeginCondition

指定在上一阶段成功后开始此部署阶段的选项：

AfterPeriod：此参数与控制台中"添加阶段向导"的"阶段设置" 页上的以下**** 设置相同：在延迟期 (（以天) ）后自动开始此阶段。如果指定此值，请使用 DaysAfterPreviousPhaseSuccess 配置时间段。
Manually：此参数与控制台中"添加阶段向导"的****"阶段设置"页上的以下设置****相同：手动开始此部署阶段。

Type:	BeginConditionType
Accepted values:	AfterPeriod, Manually
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

指定目标集合的对象

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

-CollectionId

按 ID 指定目标集合。

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

-CollectionName

按名称指定目标集合。

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

-Comments

为此阶段指定可选注释。最大长度为 512 个字符。

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

-Confirm

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

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

-CriteriaOption

指定一个选项以选择上一阶段是否成功的条件：

Compliance：此参数与控制台中"添加阶段向导"的****"阶段设置"页上的以下设置**** 相同：部署成功百分比。使用 CriteriaValue 参数指定百分比值。
Number：此参数与控制台中"添加阶段向导"的****"阶段设置"页上的以下设置**** 相同：已成功部署的设备数。使用 CriteriaValue 参数指定设备数。

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaValue

此整数值取决于为 CriteriaOption 指定的值：

Compliance：指定百分比
Number：指定设备数

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

-DaysAfterPreviousPhaseSuccess

指定上一阶段成功后天数的整数值以开始此阶段。此参数与控制台中"添加阶段向导"的"阶段设置" 页上的以下**** 设置相同：在延迟期 (（以天) ）后自动开始此阶段。

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

-DeadlineUnit

指定截止时间的类型。此参数与 DeadlineValue 一起使用。

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineValue

此参数仅在使用 AfterPeriod InstallationChoice 参数指定时使用。

指定截止时间时间段的整数值。使用DeadlineUnit参数指定时间段的类型 Hours Days Weeks ：、、、。 Months 此参数与控制台中"添加阶段向导"的****"阶段设置"页上的以下**** 设置相同：在此时间段后需要安装。

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

-DeploymentOption

此参数与控制台中"添加阶段向导"的****"分发点"页上的**** 以下设置相同：选择客户端使用相邻边界组或默认站点边界组的分发点时使用的部署选项。它接受以下值：

DownloadContentLocallyWhenNeededByRunningTaskSequence：在运行的任务序列需要时本地下载内容
DownloadAllContentLocallyBeforeStartingTaskSequence：在启动任务序列之前在本地下载所有内容

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-Id

指定要配置的阶段的 ID。

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

-InputObject

指定包含要配置的阶段的分阶段部署对象。

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

-InstallationChoice

指定与软件可用时间相关的行为选项：

AsSoonAsPossible：此参数与控制台中"添加阶段向导"的****"阶段设置"页上的**** 以下设置相同：尽快需要安装。
AfterPeriod：此参数与控制台中"添加阶段向导"的****"阶段设置"页上的以下**** 设置相同：在此时间段后需要安装。如果指定此值，请使用 DeadlineUnit 和 DeadlineValue 配置时间段。

Type:	InstallationChoiceType
Accepted values:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MovePhase

更改选定阶段的顺序。您可以将其向上移动一个索引，向下移动一个索引，或移动到特定索引。如果指定 MoveToOrder ，请使用 -MoveToOrder 参数设置特定索引。

Type:	ReorderType
Accepted values:	MoveUp, MoveDown, MoveToOrder
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MoveToOrder

将 -MovePhase 参数设置为 MoveToOrder 时，使用此参数设置特定索引。

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

-NewCollection

指定要用作选定阶段的新目标的集合对象。

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

-NewCollectionId

按 ID 指定要用作选定阶段的新目标的集合。

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

-NewCollectionName

按名称指定要用作选定阶段的新目标的集合。

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

-NewPhaseName

使用此参数可重命名所选阶段。

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

-Order

指定要配置的阶段的索引。

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

-PhasedDeploymentId

按 ID 选择分阶段部署。然后，使用其他参数选择该部署中的特定阶段。

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

-PhasedDeploymentName

按名称选择分阶段部署。然后，使用其他参数选择该部署中的特定阶段。

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

-PreDownload

此参数与控制台中"添加阶段向导"的****"常规"页上**** 的以下设置相同：预下载此任务序列的内容。

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

-SoftwareInstallation

此参数与控制台中"添加阶段向导"的****"用户体验"页上的**** 以下设置相同：软件安装。当达到安装截止时间时，此设置适用，以允许在维护时段外执行此活动。

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

-ThrottlingDays

指定一个整数值，用于逐步提供该软件的天数。此参数与控制台中"添加阶段向导"的"阶段设置" 页上的以下**** 设置相同：逐步使此软件在此时段内可用 (天数 **) 。 **

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

-UserNotification

此参数与控制台中"添加阶段向导"的"用户体验"页上的**** 以下设置相同：使用下列值**** 指定此部署的用户体验设置： ****

DisplayAll：在软件中心中显示并显示所有通知
HideAll：在软件中心中隐藏以及所有通知

Type:	UserNotificationType
Accepted values:	DisplayAll, HideAll
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

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

-WriteFilterCommit

此参数与控制台中"添加阶段向导"的****"用户体验"页上的**** 以下设置相同：在截止时间或维护窗口期间提交更改 (需要重新启动) 。此设置适用于嵌入式设备的Windows处理。

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

-名称

指定要配置的阶段的名称。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject