New-CMTaskSequencePhase
使用此 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
此参数与控制台中“添加阶段向导”的“分发点”页上的以下设置相同：允许客户端使用默认站点边界组中的分发点。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowRemoteDP
此参数与控制台中“添加阶段向导”的“分发点”页上的以下设置相同：如果没有可用的本地分发点，请使用远程分发点。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowSystemRestart
此参数与控制台中“添加阶段向导”的“用户体验”页上的以下设置相同：如果需要) 完成安装， (系统重启。 此设置在达到安装截止时间时适用，以允许在维护时段外执行此活动。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-BeginCondition
指定在上一阶段成功后开始此部署阶段的选项：
AfterPeriod：此参数与控制台中“添加阶段向导”的“阶段设置”页上的以下设置相同：在延迟期后自动开始此阶段， (天) 。 如果指定此值，请使用 DaysAfterPreviousPhaseSuccess 配置时间段。Manually：此参数与控制台中“添加阶段向导”的“阶段设置”页上的以下设置相同：手动开始此部署阶段。
| 类型: | BeginConditionType |
| 接受的值: | AfterPeriod, Manually |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Collection
为目标集合指定对象
| 类型: | IResultObject |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-CollectionId
按 ID 指定目标集合。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-CollectionName
按名称指定目标集合。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Comments
为此阶段指定可选注释。 最大长度为 512 个字符。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CriteriaOption
指定选项以选择上一阶段的成功条件：
Compliance：此参数与控制台中“添加阶段向导”的“阶段设置”页上的以下设置相同：部署成功百分比。 使用 CriteriaValue 参数指定百分比值。Number：此参数与控制台中“添加阶段向导”的“阶段设置”页上的以下设置相同：成功部署的设备数。 使用 CriteriaValue 参数指定设备数。
| 类型: | CriteriaType |
| 接受的值: | Compliance, Number |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CriteriaValue
此整数值取决于为 CriteriaOption 指定的值：
Compliance：指定百分比Number：指定设备数
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DaysAfterPreviousPhaseSuccess
指定上一阶段成功后开始此阶段的天数的整数值。 此参数与控制台中“添加阶段向导”的“阶段设置”页上的以下设置相同：在延迟期后自动开始此阶段， (天) 。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeadlineUnit
指定截止时间的类型。 将此参数与 DeadlineValue 一起使用。
| 类型: | TimeUnitType |
| 接受的值: | Hours, Days, Weeks, Months |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeadlineValue
仅当使用 InstallationChoice 参数指定AfterPeriod时，才使用此参数。
指定截止时间时间段的整数值。 使用 DeadlineUnit 参数指定句点的类型： Hours、 Days、 Weeks、 Months。 此参数与控制台中“添加阶段向导”的“阶段设置”页上的以下设置相同：在此时间段后需要安装。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeploymentOption
此参数与控制台中“添加阶段向导”的“分发点”页上的以下设置相同：选择客户端使用相邻边界组或默认站点边界组中的分发点时要使用的部署选项。 它接受以下值：
-
DownloadContentLocallyWhenNeededByRunningTaskSequence：运行中的任务序列需要时在本地下载内容 -
DownloadAllContentLocallyBeforeStartingTaskSequence：在启动任务序列之前在本地下载所有内容
| 类型: | DeploymentOptionType |
| 接受的值: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为。 不建议这样做。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InstallationChoice
指定相对于软件可用时的行为的选项：
AsSoonAsPossible：此参数与控制台中“添加阶段向导”的“阶段设置”页上的以下设置相同：需要尽快安装。AfterPeriod：此参数与控制台中“添加阶段向导”的“阶段设置”页上的以下设置相同：在此时间段后需要安装。 如果指定此值，请使用 DeadlineUnit 和 DeadlineValue 配置时间段。
| 类型: | InstallationChoiceType |
| 接受的值: | AsSoonAsPossible, AfterPeriod |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PhaseName
指定阶段的名称。
| 类型: | String |
| 别名: | Name |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-PreDownload
此参数与控制台中“添加阶段向导”的“常规”页上的以下设置相同：此任务序列的预下载内容。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SoftwareInstallation
此参数与控制台中“添加阶段向导”的“用户体验”页上的以下设置相同：软件安装。 此设置在达到安装截止时间时适用，以允许在维护时段外执行此活动。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ThrottlingDays
指定天数的整数值，以便逐渐使此软件可用。 此参数与控制台中“添加阶段向导”的“阶段设置”页上的以下设置相同：逐步使该软件在此时间段内可用， (天) 。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UserNotification
此参数与控制台中“添加阶段向导”的“用户体验”页上的以下设置相同：使用以下值指定此部署的用户体验设置：
-
DisplayAll：在软件中心显示并显示所有通知 -
HideAll：在软件中心和所有通知中隐藏
| 类型: | UserNotificationType |
| 接受的值: | DisplayAll, HideAll |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WriteFilterCommit
此参数与控制台中“添加阶段向导”的“用户体验”页上的以下设置相同：在截止时间或维护时段内提交更改 (需要重启) 。 此设置适用于 Windows Embedded 设备的写入筛选器处理。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase