New-CMTaskSequenceManualPhasedDeployment

タスク シーケンスの段階的なデプロイを作成します。

構文

New-CMTaskSequenceManualPhasedDeployment
   [-TaskSequence] <IResultObject>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceManualPhasedDeployment
   [-TaskSequenceId] <String>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceManualPhasedDeployment
   [-TaskSequenceName] <String>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、タスク シーケンスの段階的なデプロイを作成します。 このコマンドレットを使用する前に、 New-CMTaskSequencePhase コマンドレットを使用して、新しいカスタマイズされたデプロイ フェーズを追加します。

詳細については、「 Configuration Manager を使用して段階的なデプロイを作成する」を参照してください。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例 1: 名前でタスク シーケンスのデプロイを作成する

この例では、タスク シーケンス myTaskSequencephaseDeployment という名前の 2 フェーズデプロイを作成します。

$phase1 = New-CMTaskSequencePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotification DisplayAll
$phase2 = New-CMTaskSequencePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotification HideAll
New-CMTaskSequenceManualPhasedDeployment -TaskSequenceName "myTaskSequence" -Name "phasedDeployment" -AddPhases ($phase1, $phase2)

例 2: タスク シーケンス オブジェクトのデプロイを作成する

この例では、パイプされたタスク シーケンス オブジェクトの phasedDeployment という名前の 2 フェーズデプロイを作成します。

$phase3 = New-CMTaskSequencePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotification DisplayAll
$phase4 = New-CMTaskSequencePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotification HideAll
$myTaskSequence | New-CMTaskSequenceManualPhasedDeployment -Name "phasedDeployment" -AddPhases ($phase3, $phase4)

パラメーター

-AddPhases

フェーズの配列を指定します。 New-CMTaskSequencePhase を使用してフェーズを作成します。

型:Phase[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る: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

-Name

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

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

-TaskSequence

タスク シーケンス オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMTaskSequence コマンドレットを使用します。

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

-TaskSequenceId

ID でタスク シーケンスを指定します。

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

-TaskSequenceName

名前でタスク シーケンスを指定します。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

return オブジェクトは、 SMS_PhasedDeployment サーバー WMI クラスです。