Set-CMSoftwareUpdatePhasedDeployment

参考

模块:: ConfigurationManager

为软件更新配置分阶段部署。

语法

Set-CMSoftwareUpdatePhasedDeployment
   [-AddPhases <Phase[]>]
   [-Description <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemovePhaseIds <String[]>]
   [-RemovePhaseOrders <Int32[]>]
   [-RemovePhases <Phase[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMSoftwareUpdatePhasedDeployment
   [-AddPhases <Phase[]>]
   [-Description <String>]
   [-NewName <String>]
   [-PassThru]
   [-RemovePhaseIds <String[]>]
   [-RemovePhaseOrders <Int32[]>]
   [-RemovePhases <Phase[]>]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMSoftwareUpdatePhasedDeployment
   [-AddPhases <Phase[]>]
   [-Description <String>]
   [-NewName <String>]
   [-PassThru]
   [-RemovePhaseIds <String[]>]
   [-RemovePhaseOrders <Int32[]>]
   [-RemovePhases <Phase[]>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

适用于版本 2006 及更高版本。为软件更新配置分阶段部署。有关详细信息，请参阅创建分阶段部署。

示例

示例 1：重命名分阶段部署

此示例重命名在命令行上传递的软件更新分阶段部署。

$suPhasedDeployment = Get-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeployment"

$suPhasedDeployment | Set-CMSoftwareUpdatePhasedDeployment -NewName "New SU phased deployment" -Description "New description" -PassThru

示例 2：添加阶段

本示例将阶段添加到按其 ID 为目标的软件更新分阶段部署。

$newPhase = New-CMSoftwareUpdatePhase -CollectionName "MyCollection" -PhaseName "MySUPhase" -UserNotificationOption DisplaySoftwareCenterOnly

Set-CMSoftwareUpdatePhasedDeployment -Id "da0a01a3-b7ea-4d4b-8392-94b39ecabf8b" -AddPhases ($newPhase)

参数

-AddPhases

使用此参数可向软件更新分阶段部署添加一个或多个阶段。使用 New-CMSoftwareUpdatePhase cmdlet 创建新的阶段对象。

类型:	Phase[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	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

-Id

指定要配置的软件更新分阶段部署的 ID。此值的格式为 GUID。

类型:	String
别名:	PhasedDeploymentId
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InputObject

指定要配置的软件更新分阶段部署的对象。例如，使用 Get-CMSoftwareUpdatePhasedDeployment cmdlet 获取此对象。

类型:	IResultObject
别名:	PhasedDeployment
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

指定要配置的软件更新分阶段部署的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NewName

使用此参数重命名软件更新分阶段部署。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PassThru

返回一个对象，该对象表示正在使用的项。默认情况下，此 cmdlet 可能不会生成任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemovePhaseIds

删除由其 ID 指定的一个或多个阶段。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemovePhaseOrders

删除在分阶段部署中按顺序指定的一个或多个阶段。

类型:	Int32[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemovePhases

从软件更新分阶段部署中删除一个或多个阶段。使用 Get-CMPhase cmdlet 标识要删除的阶段。

类型:	Phase[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

反馈

此页面是否有帮助？