Set-CMTaskSequencePhase

モジュール:

ConfigurationManager

このコマンドレットを使用して、タスク シーケンスの展開フェーズを構成します。

構文

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-InputObject] <IResultObject>
   [-Name <String>]
   [-Order <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentId] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentName] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

バージョン 2006 以降に適用されます。 このコマンドレットを使用して、タスク シーケンスの展開フェーズを構成します。 詳細については、「Create phased deployments 」を参照してください。

例

例 1: コレクションを変更する

次の使用例は、コマンド ラインで渡されるタスク シーケンス段階的展開の 2 番目のフェーズのコレクションを変更します。

$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"

例 2: フェーズを上に移動する

次の使用例は、フェーズを順番に上に移動します。 フェーズ展開を ID で選択し、関連付けられたコレクション ID でフェーズを選択します。

Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp

例 3: フェーズ設定の構成

次の使用例は、選択したフェーズの構成設定を変更します。

Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12

パラメーター

-AllowFallback

このパラメーターは、コンソールのフェーズの追加ウィザードの****[配布ポイント]**** ページの [既定のサイト境界グループからの配布ポイントの使用をクライアントに許可する] の設定と同じです。

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

-AllowRemoteDP

このパラメーターは、コンソールのフェーズの追加ウィザードの****[配布ポイント]**** ページの次の設定と同じです。ローカル配布ポイントが利用できない場合は、リモート配布ポイントを使用します。

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

-AllowSystemRestart

このパラメーターは、コンソールのフェーズの追加ウィザードの****[ユーザー エクスペリエンス****] ページの [システムの再起動 ] (インストールを完了するために必要な場合) の設定と同じです。 この設定は、インストール期限に達した場合に適用されます。このアクティビティをメンテナンス ウィンドウの外で実行できます。

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

-BeginCondition

前のフェーズの成功後にこの展開フェーズを開始するオプションを指定します。

• AfterPeriod: このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ設定] **** ページの次の設定と同じです。このフェーズは、延期期間 (日) の後に自動的に開始します。 この値を指定する場合は 、DaysAfterPreviousPhaseSuccess を使用して期間を構成します。

• Manually: このパラメーターは、コンソールのフェーズの追加ウィザード設定ページの次の設定と同**** じです。この展開のこのフェーズを手動で開始します。

Type:	BeginConditionType
Accepted values:	AfterPeriod, Manually
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

ターゲット コレクションのオブジェクトを指定する

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

-CollectionId

ID でターゲット コレクションを指定します。

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

-CollectionName

名前でターゲット コレクションを指定します。

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

-Comments

このフェーズのオプションのコメントを指定します。 最大長は 512 文字です。

Type:	String
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

-CriteriaOption

前のフェーズの成功の条件を選択するオプションを指定します。

• Compliance: このパラメーターは、コンソールの [フェーズの**** 追加ウィザード] 設定 [展開**** の成功率] ページの次の設定と同じです。 CriteriaValue パラメーターでパーセンテージ値 を指定 します。

• Number: このパラメーターは、コンソールのフェーズの追加ウィザード**** の [フェーズ 設定]**** ページの次の設定と同じです。正常に展開されたデバイスの数です。 CriteriaValue パラメーターを使用してデバイス の数を指定 します。

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaValue

この整数値は 、CriteriaOption に指定する値によって異なります。

• Compliance: パーセンテージを指定します。

• Number: デバイスの数を指定する

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

-DaysAfterPreviousPhaseSuccess

このフェーズを開始する前のフェーズが成功した後の日数の整数値を指定します。 このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ設定] ページ**** の次の設定と同じです。このフェーズは、延期期間 (日) の後に自動的に開始します。

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

-DeadlineUnit

期限期間の種類を指定します。 DeadlineValue でこのパラメーター を使用します。

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineValue

このパラメーターは AfterPeriod 、InstallationChoice パラメーターで指定した場合にのみ使用 されます。

期限の期間の整数値を指定します。 DeadlineUnit パラメーターを使用して、ピリオドの種類を指定 Hours します。 Days Weeks Months このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ 設定] ページ**** の次の設定と同じです。この期間以降はインストールが必要です。

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

-DeploymentOption

このパラメーターは、コンソールのフェーズの追加ウィザードの****[配布ポイント]**** ページの次の設定と同じです。クライアントが隣接境界グループまたは既定のサイト境界グループから配布ポイントを使用する場合に使用する展開オプションを選択します。 次の値を受け入れる。

• DownloadContentLocallyWhenNeededByRunningTaskSequence: 実行中のタスク シーケンスで必要に応じてローカルでコンテンツをダウンロードする
• DownloadAllContentLocallyBeforeStartingTaskSequence: タスク シーケンスを開始する前に、すべてのコンテンツをローカルでダウンロードする

Type:	DeploymentOptionType
Accepted values:	DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
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 を指定します。

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

-InputObject

構成するフェーズを含むフェーズ展開オブジェクトを指定します。

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

-InstallationChoice

ソフトウェアを使用できる場合の動作に対するオプションを指定します。

• AsSoonAsPossible: このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ 設定]**** ページの次の設定と同じです。できるだけ早くインストールが必要です。

• AfterPeriod: このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ 設定]**** ページの次の設定と同じです。この期間以降はインストールが必要です。 この値を指定する場合は 、DeadlineUnit と DeadlineValue を使用して期間を構成します。

Type:	InstallationChoiceType
Accepted values:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MovePhase

選択したフェーズの順序を変更します。 1 つ上に移動したり、1 つ下に移動したり、特定のインデックスに移動することができます。 指定する場合 MoveToOrder は 、-MoveToOrder パラメーターを使用して特定のインデックスを設定します。

Type:	ReorderType
Accepted values:	MoveUp, MoveDown, MoveToOrder
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MoveToOrder

-MovePhase パラメーターをに設定する場合は、 MoveToOrder このパラメーターを使用して特定のインデックスを設定します。

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

-Name

構成するフェーズの名前を指定します。

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

-NewCollection

選択したフェーズの新しいターゲットとして使用するコレクション オブジェクトを指定します。

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

-NewCollectionId

選択したフェーズの新しいターゲットとして使用するコレクションを ID で指定します。

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

-NewCollectionName

選択したフェーズの新しいターゲットとして使用するコレクションを名前で指定します。

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

-NewPhaseName

選択したフェーズの名前を変更するには、このパラメーターを使用します。

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

-Order

構成するフェーズのインデックスを指定します。

Type:	Int32
Aliases:	PhaseOrder
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PhasedDeploymentId

ID で段階的な展開を選択します。 その後、他のパラメーターを使用して、その展開の特定のフェーズを選択します。

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

-PhasedDeploymentName

名前で段階的な展開を選択します。 その後、他のパラメーターを使用して、その展開の特定のフェーズを選択します。

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

-PreDownload

このパラメーターは、コンソールのフェーズの追加ウィザードの****[全般]**** ページの [このタスク シーケンスのコンテンツを事前にダウンロードする] の設定と同じです。

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

-SoftwareInstallation

このパラメーターは、コンソールのフェーズの追加ウィザードの****[ユーザー エクスペリエンス****] ページの [ソフトウェアのインストール] の設定と同じです。 この設定は、インストール期限に達した場合に適用されます。このアクティビティをメンテナンス ウィンドウの外で実行できます。

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

-ThrottlingDays

このソフトウェアを段階的に使用するには、日数の整数値を指定します。 このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ設定] ページ**** の次の設定と同じです。このソフトウェアをこの期間 (日) の間に徐々に使用できます。

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

-UserNotification

このパラメーターは、コンソールのフェーズの追加ウィザードの [ユーザー エクスペリエンス****] ページの次の設定**** と同じです。この展開のユーザー エクスペリエンス設定を次の値で指定します。 ****

• DisplayAll: ソフトウェア センターに表示し、すべての通知を表示する
• HideAll: ソフトウェア センターとすべての通知で非表示にする

Type:	UserNotificationType
Accepted values:	DisplayAll, HideAll
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

-WriteFilterCommit

このパラメーターは、コンソールのフェーズの追加ウィザードの****[ユーザー エクスペリエンス****] ページの設定と同じです。期限またはメンテナンス 期間中に変更をコミットします (再起動が必要です)。 この設定は、埋め込みデバイスの書き込みWindows適用されます。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

関連リンク

• Get-CMPhase
• New-CMTaskSequencePhase
• Get-CMTaskSequencePhasedDeployment
• New-CMTaskSequenceAutoPhasedDeployment
• New-CMTaskSequenceManualPhasedDeployment
• Remove-CMTaskSequencePhasedDeployment
• Set-CMTaskSequencePhasedDeployment
• Get-CMPhasedDeploymentStatus
• Move-CMPhasedDeploymentToNext
• Resume-CMPhasedDeployment
• Suspend-CMPhasedDeployment
• 段階的な展開の作成