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