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 以降に適用されます。タスクシーケンスの段階的な展開を構成します。詳細については、「Create phased deployments 」を参照してください。

例

例 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

このパラメーターを使用して、1 つ以上のフェーズをタスクシーケンス段階的展開に追加します。 New-CMTaskSequencePhaseコマンドレットを使用して、新しいフェーズオブジェクトを作成します。

Type:	Phase[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

オプションの説明を指定して、このタスクシーケンスの段階的展開をより適切に識別します。

Type:	String
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 コマンドレットを使用して、このオブジェクトを取得します。

Type:	IResultObject
Aliases:	PhasedDeployment
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

構成するタスクシーケンス段階的展開の名前を指定します。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

このパラメーターを使用して、タスクシーケンスの段階的展開の名前を変更します。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

作業しているアイテムを表すオブジェクトを返します。既定では、このコマンドレットは出力を生成しない場合があります。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemovePhaseIds

ID で指定された 1 つ以上のフェーズを削除します。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemovePhaseOrders

段階的な展開で順序で指定された 1 つ以上のフェーズを削除します。

Type:	Int32[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemovePhases

タスクシーケンス段階的展開から 1 つ以上のフェーズを削除します。 Get-CMPhase コマンドレットを使用して、削除するフェーズを特定します。

Type:	Phase[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。コマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject