Share via

Set-CMTaskSequencePhasedDeployment

  • 参考
模块:
ConfigurationManager

为任务序列配置分阶段部署。

语法

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

说明

适用于版本 2006 和更高版本。 为任务序列配置分阶段部署。 有关详细信息，请参阅创建 分阶段部署。

示例

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

此示例重命名在命令行上传递的任务序列分阶段部署。

$tsPhasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

$tsPhasedDeployment | Set-CMTaskSequencePhasedDeployment -NewName "New TS phased deployment" -Description "New description" -PassThru

示例 2：添加阶段

此示例将一个阶段添加到按其 ID 确定的任务序列分阶段部署。

$newPhase = New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

Set-CMTaskSequencePhasedDeployment -Id "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -AddPhases ($newPhase)

参数

-AddPhases

使用此参数向任务序列分阶段部署添加一个或多个阶段。 使用 New-CMTaskSequencePhase 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-CMTaskSequencePhasedDeployment 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