New-CMSoftwareUpdateAutoPhasedDeployment
使用此 cmdlet 通过生成具有相同设置的两个阶段，为软件更新创建分阶段部署。
语法
New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateGroup] <IResultObject>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateGroupId] <String>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateGroupName] <String>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateIds] <String[]>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateNames] <String[]>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdates] <IResultObject[]>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
使用此 cmdlet 通过生成具有相同设置的两个阶段，为软件更新创建分阶段部署。 选择“自动创建默认的两 个阶段部署 ”选项时，此 cmdlet 的行为与软件更新上的“ 创建分阶段部署”向导相同。
注意
在创建分阶段部署之前，请确保将软件更新内容分发到分发点。
示例
示例 1：按更新名称创建部署
此示例为软件更新 myUpdateName 创建名为 myDPName 的新软件更新分阶段部署。
New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"示例 2：通过输入更新对象创建部署
本示例为管道软件更新对象创建名为 myPDName 的新软件更新分阶段部署。
$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"参数
-AddPhases
此 cmdlet 会自动为指定的两个集合创建两个阶段。 还可以使用此参数添加更多阶段。 指定相位数组。 使用 New-CMSoftwareUpdatePhase 创建阶段。
| 类型: | Phase[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-BeginCondition
指定用于在第一阶段成功后开始第二阶段部署的选项：
AfterPeriod：此参数与控制台中“创建分阶段部署”向导的“设置”页上的以下设置相同：在延迟期后自动开始此阶段， (天) 。 如果指定此值，请使用 DaysAfterPreviousPhaseSuccess 配置时间段。Manually：此参数与控制台中“创建分阶段部署”向导的“设置”页上的以下设置相同：手动开始第二阶段部署。
| 类型: | BeginConditionType |
| 接受的值: | AfterPeriod, Manually |
| 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 |
-Description
指定软件更新分阶段部署的说明。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-FirstCollection
为第一阶段指定集合对象。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-FirstCollectionId
为第一阶段指定集合 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-FirstCollectionName
为第一阶段指定集合名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为。 不建议这样做。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InsertAtOrder
如果使用 AddPhases 参数，则使用此参数可确定按阶段顺序插入其他阶段的位置。 使用订单号指定一个整数。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InstallationChoice
指定相对于软件可用时的行为的选项：
AsSoonAsPossible：此参数与控制台中“创建分阶段部署”向导的“设置”页上的以下设置相同：需要尽快安装。AfterPeriod：此参数与控制台中“创建分阶段部署”向导的“设置”页上的以下设置相同：在此时间段后需要安装。 如果指定此值，请使用 DeadlineUnit 和 DeadlineValue 配置时间段。
| 类型: | InstallationChoiceType |
| 接受的值: | AsSoonAsPossible, AfterPeriod |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定应用程序分阶段部署的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SecondCollection
为第二阶段指定集合对象。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SecondCollectionId
为第二阶段指定集合 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SecondCollectionName
为第二阶段指定集合名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SoftwareUpdateGroup
为软件更新组指定对象。
| 类型: | IResultObject |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-SoftwareUpdateGroupId
按 ID 指定软件更新组。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SoftwareUpdateGroupName
按名称指定软件更新组。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SoftwareUpdateIds
指定软件更新 ID 的数组。
| 类型: | String[] |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SoftwareUpdateNames
指定软件更新名称的数组。
| 类型: | String[] |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SoftwareUpdates
指定软件更新对象的数组。
| 类型: | IResultObject[] |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ThrottlingDays
指定天数的整数值，以便逐渐使此软件可用。 此参数与控制台中“创建分阶段部署”向导的“设置”页上的以下设置相同：逐步使该软件在此时间段内可用， (天) 。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
输出
IResultObject