New-CMTaskSequencePhase

参考

模块:: ConfigurationManager

使用此 cmdlet 为任务序列创建部署阶段。

语法

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 为任务序列创建部署阶段。

示例

示例 1：创建任务序列阶段

此示例为名为 MyCollection 的集合创建名为 MyTSPhase 的任务序列阶段。

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

参数

-AllowFallback

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

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

-AllowRemoteDP

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

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

-AllowSystemRestart

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

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

-BeginCondition

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

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

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

-Collection

为目标集合指定对象

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

-CollectionId

按 ID 指定目标集合。

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

-CollectionName

按名称指定目标集合。

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

-Comments

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

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:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaOption

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

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

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

-CriteriaValue

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

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

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

-DaysAfterPreviousPhaseSuccess

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

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

-DeadlineUnit

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

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

-DeadlineValue

仅当使用 InstallationChoice 参数指定AfterPeriod时，才使用此参数。

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

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

-DeploymentOption

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

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

Type:	DeploymentOptionType
Accepted values:	DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
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

-InstallationChoice

指定相对于软件可用时的行为的选项：

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

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

-PhaseName

指定阶段的名称。

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

-PreDownload

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

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

-SoftwareInstallation

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

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

-ThrottlingDays

指定天数的整数值，以便逐渐使此软件可用。此参数与控制台中“添加阶段向导”的“阶段设置”页上的以下设置相同：逐步使该软件在此时间段内可用， (天) 。

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

-UserNotification

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

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

Type:	UserNotificationType
Accepted values:	DisplayAll, HideAll
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:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WriteFilterCommit

此参数与控制台中“添加阶段向导”的“用户体验”页上的以下设置相同：在截止时间或维护时段内提交更改 (需要重启) 。此设置适用于 Windows Embedded 设备的写入筛选器处理。

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

输入

None

输出

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase