次の方法で共有

New-CMTaskSequencePhase

  • リファレンス
モジュール:
ConfigurationManager

このコマンドレットを使用して、タスク シーケンスのデプロイ フェーズを作成します。

構文

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

パラメーター

-AllowFallback

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

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

-AllowRemoteDP

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

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

-AllowSystemRestart

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

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

-BeginCondition

前のフェーズの成功後に、このデプロイフェーズを開始するためのオプションを指定します。

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

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

型:BeginConditionType
指定可能な値:AfterPeriod, Manually
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Collection

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

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

-CollectionId

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

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

-CollectionName

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

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

-Comments

このフェーズの省略可能なコメントを指定します。 最大長は 512 文字です。

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

-Confirm

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

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

-CriteriaOption

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

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

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

型:CriteriaType
指定可能な値:Compliance, Number
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CriteriaValue

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

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

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

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

-DaysAfterPreviousPhaseSuccess

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

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

-DeadlineUnit

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

型:TimeUnitType
指定可能な値:Hours, Days, Weeks, Months
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DeadlineValue

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

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

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

-DeploymentOption

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

  • DownloadContentLocallyWhenNeededByRunningTaskSequence: 実行中のタスク シーケンスで必要なときにコンテンツをローカルにダウンロードする
  • DownloadAllContentLocallyBeforeStartingTaskSequence: タスク シーケンスを開始する前にすべてのコンテンツをローカルにダウンロードします
型:DeploymentOptionType
指定可能な値:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

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

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作につながる可能性があります。 これはお勧めしません。 DisableWildcardHandling と組み合わせることはできません。

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

-InstallationChoice

ソフトウェアが使用可能になったときに相対的な動作のオプションを指定します。

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

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

型:InstallationChoiceType
指定可能な値:AsSoonAsPossible, AfterPeriod
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PhaseName

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

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

-PreDownload

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

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

-SoftwareInstallation

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

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

-ThrottlingDays

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

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

-UserNotification

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

  • DisplayAll: ソフトウェア センターに表示し、すべての通知を表示する
  • HideAll: ソフトウェア センターとすべての通知で非表示にする
型:UserNotificationType
指定可能な値:DisplayAll, HideAll
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

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

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

-WriteFilterCommit

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

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

入力

None

出力

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase