New-CMTaskSequencePhase
このコマンドレットを使用して、タスク シーケンスの展開フェーズを作成します。
構文
New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-Collection] <IResultObject>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CollectionId] <String>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CollectionName] <String>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットを使用して、タスク シーケンスの展開フェーズを作成します。
例
例 1: タスク シーケンス フェーズの作成
この例では 、MyCollection という名前のコレクションの MyTSPhase という 名前のタスク シーケンス フェーズを作成します。
New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $trueパラメーター
このパラメーターは、コンソールのフェーズの追加ウィザードの****[配布ポイント]**** ページの [既定のサイト境界グループからの配布ポイントの使用をクライアントに許可する] の設定と同じです。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、コンソールのフェーズの追加ウィザードの****[配布ポイント]**** ページの次の設定と同じです。ローカル配布ポイントが利用できない場合は、リモート配布ポイントを使用します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、コンソールのフェーズの追加ウィザードの****[ユーザー エクスペリエンス****] ページの [システムの再起動 ] (インストールを完了するために必要な場合) の設定と同じです。 この設定は、インストール期限に達した場合に適用されます。このアクティビティをメンテナンス ウィンドウの外で実行できます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
前のフェーズの成功後にこの展開フェーズを開始するオプションを指定します。
AfterPeriod: このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ設定] **** ページの次の設定と同じです。このフェーズは、延期期間 (日) の後に自動的に開始します。 この値を指定する場合は 、DaysAfterPreviousPhaseSuccess を使用して期間を構成します。Manually: このパラメーターは、コンソールのフェーズの追加ウィザード設定ページの次の設定と同**** じです。この展開のこのフェーズを手動で開始します。
| Type: | BeginConditionType |
| Accepted values: | AfterPeriod, Manually |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
ターゲット コレクションのオブジェクトを指定する
| Type: | IResultObject |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
ID でターゲット コレクションを指定します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
名前でターゲット コレクションを指定します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このフェーズのオプションのコメントを指定します。 最大長は 512 文字です。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットを実行する前に確認メッセージを表示します。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
前のフェーズの成功の条件を選択するオプションを指定します。
Compliance: このパラメーターは、コンソールの [フェーズの**** 追加ウィザード] 設定 [展開**** の成功率] ページの次の設定と同じです。 CriteriaValue パラメーターでパーセンテージ値 を指定 します。Number: このパラメーターは、コンソールのフェーズの追加ウィザード**** の [フェーズ 設定]**** ページの次の設定と同じです。正常に展開されたデバイスの数です。 CriteriaValue パラメーターを使用してデバイス の数を指定 します。
| Type: | CriteriaType |
| Accepted values: | Compliance, Number |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
この整数値は 、CriteriaOption に指定する値によって異なります。
Compliance: パーセンテージを指定します。Number: デバイスの数を指定する
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このフェーズを開始する前のフェーズが成功した後の日数の整数値を指定します。 このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ設定] ページ**** の次の設定と同じです。このフェーズは、延期期間 (日) の後に自動的に開始します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
期限期間の種類を指定します。 DeadlineValue でこのパラメーター を使用します。
| Type: | TimeUnitType |
| Accepted values: | Hours, Days, Weeks, Months |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは AfterPeriod 、InstallationChoice パラメーターで指定した場合にのみ使用 されます。
期限の期間の整数値を指定します。 DeadlineUnit パラメーターを使用して、ピリオドの種類を指定 Hours します。 Days Weeks Months このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ 設定] ページ**** の次の設定と同じです。この期間以降はインストールが必要です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、コンソールのフェーズの追加ウィザードの****[配布ポイント]**** ページの次の設定と同じです。クライアントが隣接境界グループまたは既定のサイト境界グループから配布ポイントを使用する場合に使用する展開オプションを選択します。 次の値を受け入れる。
DownloadContentLocallyWhenNeededByRunningTaskSequence: 実行中のタスク シーケンスで必要に応じてローカルでコンテンツをダウンロードするDownloadAllContentLocallyBeforeStartingTaskSequence: タスク シーケンスを開始する前に、すべてのコンテンツをローカルでダウンロードする
| Type: | DeploymentOptionType |
| Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします。 お勧めできません。 DisableWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
ソフトウェアを使用できる場合の動作に対するオプションを指定します。
AsSoonAsPossible: このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ 設定]**** ページの次の設定と同じです。できるだけ早くインストールが必要です。AfterPeriod: このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ 設定]**** ページの次の設定と同じです。この期間以降はインストールが必要です。 この値を指定する場合は 、DeadlineUnit と DeadlineValue を使用して期間を構成します。
| Type: | InstallationChoiceType |
| Accepted values: | AsSoonAsPossible, AfterPeriod |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
フェーズの名前を指定します。
| Type: | String |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、コンソールのフェーズの追加ウィザードの****[全般]**** ページの [このタスク シーケンスのコンテンツを事前にダウンロードする] の設定と同じです。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、コンソールのフェーズの追加ウィザードの****[ユーザー エクスペリエンス****] ページの [ソフトウェアのインストール] の設定と同じです。 この設定は、インストール期限に達した場合に適用されます。このアクティビティをメンテナンス ウィンドウの外で実行できます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このソフトウェアを段階的に使用するには、日数の整数値を指定します。 このパラメーターは、コンソールのフェーズの追加ウィザードの [フェーズ設定] ページ**** の次の設定と同じです。このソフトウェアをこの期間 (日) の間に徐々に使用できます。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、コンソールのフェーズの追加ウィザードの [ユーザー エクスペリエンス****] ページの次の設定**** と同じです。この展開のユーザー エクスペリエンス設定を次の値で指定します。 ****
DisplayAll: ソフトウェア センターに表示し、すべての通知を表示するHideAll: ソフトウェア センターとすべての通知で非表示にする
| Type: | UserNotificationType |
| Accepted values: | DisplayAll, HideAll |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、コンソールのフェーズの追加ウィザードの****[ユーザー エクスペリエンス****] ページの設定と同じです。期限またはメンテナンス 期間中に変更をコミットします (再起動が必要です)。 この設定は、埋め込みデバイスの書き込みWindows適用されます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None
出力
Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase