Set-CMSoftwareUpdatePhasedDeployment
为软件更新配置分阶段部署。
语法
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 创建新的阶段对象。
Type: | Phase[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符,并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
指定要配置的软件更新分阶段部署的 ID。 此值的格式为 GUID。
Type: | String |
Aliases: | PhasedDeploymentId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定要配置的软件更新分阶段部署的对象。 例如,使用 Get-CMSoftwareUpdatePhasedDeployment cmdlet 获取此对象。
Type: | IResultObject |
Aliases: | PhasedDeployment |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NewName
使用此参数可重命名软件更新分阶段部署。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
返回一个对象,该对象代表正在处理的项目。 默认情况下,此 cmdlet 可能不会生成任何输出。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemovePhaseIds
删除其 ID 指定的一个或多个阶段。
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemovePhaseOrders
删除按其顺序在分阶段部署中指定的一个或多个阶段。
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemovePhases
从软件更新分阶段部署中删除一个或多个阶段。 使用 Get-CMPhase cmdlet 可标识要删除的阶段。
Type: | Phase[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名称
指定要配置的软件更新分阶段部署的名称。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-描述
指定可选说明以更好地标识此软件更新分阶段部署。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject
相关链接
- Get-CMSoftwareUpdatePhasedDeployment
- New-CMSoftwareUpdateAutoPhasedDeployment
- New-CMSoftwareUpdateManualPhasedDeployment
- Remove-CMSoftwareUpdatePhasedDeployment
- Get-CMPhase
- New-CMSoftwareUpdatePhase
- Set-CMSoftwareUpdatePhase
- Get-CMPhasedDeploymentStatus
- Move-CMPhasedDeploymentToNext
- Resume-CMPhasedDeployment
- Suspend-CMPhasedDeployment
- 创建分阶段部署