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

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

型:Phase[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

このタスク シーケンスの段階的なデプロイをより適切に識別するには、省略可能な説明を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

構成するタスク シーケンス段階的デプロイの ID を指定します。 この値の形式は GUID です。

型:String
Aliases:PhasedDeploymentId
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

構成するタスク シーケンス段階的デプロイのオブジェクトを指定します。 たとえば、 Get-CMTaskSequencePhasedDeployment コマンドレットを使用して、このオブジェクトを取得します。

型:IResultObject
Aliases:PhasedDeployment
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

構成するタスク シーケンス段階的デプロイの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NewName

タスク シーケンス段階的デプロイの名前を変更するには、このパラメーターを使用します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemovePhaseIds

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

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemovePhaseOrders

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

型:Int32[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemovePhases

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

型:Phase[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject