New-CMSoftwareUpdateManualPhasedDeployment

模块:

ConfigurationManager

为软件更新创建分阶段部署。

语法

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 类。

相关链接

• Get-CMSoftwareUpdatePhasedDeployment
• Remove-CMSoftwareUpdatePhasedDeployment
• Set-CMSoftwareUpdatePhasedDeployment
• Get-CMPhasedDeploymentStatus
• Move-CMPhasedDeploymentToNext
• Resume-CMPhasedDeployment
• Suspend-CMPhasedDeployment
• 使用 Configuration Manager 创建分阶段部署