New-CMSoftwareUpdateManualPhasedDeployment    
为软件更新创建分阶段部署。
语法
New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdateGroup] <IResultObject>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]    New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdateGroupId] <String>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]    New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdateGroupName] <String>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]    New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdateIds] <String[]>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]    New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdateNames] <String[]>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]    New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdates] <IResultObject[]>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]    说明
使用此 cmdlet 为软件更新创建分阶段部署。 使用此 cmdlet 之前,请使用 cmdlet New-CMSoftwareUpdatePhase 添加新的自定义部署阶段。
有关详细信息,请参阅 使用 Configuration Manager 创建分阶段部署。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门。
示例
示例 1:按名称创建软件更新部署
此示例为两个软件更新创建名为 myPhaseDeployment 的 两阶段部署。
$phase1 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotificationOption DisplaySoftwareCenterOnly
$phase2 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateNames ("myUpdateA", "myUpdateB") -Name "myPhaseDeployment" -AddPhases ($phase1, $phase2)示例 2:按名称为软件更新组创建部署
此示例为软件更新组myGroup 创建名为 myPhaseDeploymentForGroup 的两阶段部署。
$phase3 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotificationOption DisplaySoftwareCenterOnly
$phase4 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateGroupName "myGroup" -Name "myPhaseDeploymentForGroup" -AddPhases ($phase3, $phase4)参数
-AddPhases
指定相位数组。 使用 New-CMSoftwareUpdatePhase 创建阶段。
| 类型: | Phase[] | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter | 
| 别名: | cf | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Description
指定软件更新分阶段部署的说明。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Name
指定软件更新分阶段部署的名称。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-SoftwareUpdateGroup
为软件更新组指定对象。 若要获取此对象,请使用 Get-CMSoftwareUpdateGroup cmdlet。
| 类型: | 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
指定软件更新对象的数组。 若要获取此对象,请使用 Get-CMSoftwareUpdate cmdlet。
| 类型: | IResultObject[] | 
| Position: | 0 | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | True | 
| 接受通配符: | False | 
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter | 
| 别名: | wi | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
输出
IResultObject
备注
返回对象是 SMS_PhasedDeployment 服务器 WMI 类。