New-CMTaskSequenceAutoPhasedDeployment
このコマンドレットを使用して、同じ設定で 2 つのフェーズを生成することで、タスク シーケンスの段階的な展開を作成します。
構文
New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequence] <IResultObject>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequenceId] <String>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequenceName] <String>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットを使用して、同じ設定で 2 つのフェーズを生成することで、タスク シーケンスの段階的な展開を作成します。 このコマンドレットの動作は、タスク シーケンスの [フェーズ展開の作成 ] ウィザードと同じです。既定の 2 フェーズ展開を自動的に作成するオプションを選択するとします。
注:
段階的な展開を作成する前に、タスク シーケンスの内容を配布ポイントに配布してください。
例
例 1: タスク シーケンス名でデプロイを作成する
この例では、タスク シーケンス myTaskSequenceName の myDPName という名前の新しいタスク シーケンス段階的デプロイを作成します。
New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"例 2: 入力タスク シーケンス オブジェクトによるデプロイの作成
この例では、パイプされたタスク シーケンス オブジェクトの myPDName という名前の新しいタスク シーケンス段階的デプロイを作成します。
$myTS | New-CMTaskSequenceAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"パラメーター
-AddPhases
このコマンドレットは、指定した 2 つのコレクションに対して 2 つのフェーズを自動的に作成します。 このパラメーターを使用して、さらにフェーズを追加することもできます。 フェーズの配列を指定します。 New-CMTaskSequencePhase を使用してフェーズを作成します。
| 型: | Phase[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-BeginCondition
最初のフェーズが成功した後、デプロイの 2 番目のフェーズを開始するためのオプションを指定します。
AfterPeriod: このパラメーターは、コンソールの [フェーズ展開の作成] ウィザードの [設定] ページの設定と同じです。遅延期間 (日数) 後にこのフェーズを自動的に開始します。 この値を指定する場合は、 DaysAfterPreviousPhaseSuccess を使用して期間を構成します。Manually: このパラメーターは、コンソールの [フェーズ展開の作成] ウィザードの [設定] ページの [手動で 2 番目のフェーズの展開を開始する] の設定と同じです。
| 型: | BeginConditionType |
| 指定可能な値: | AfterPeriod, Manually |
| 配置: | 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
最初のフェーズが成功してから 2 番目のフェーズを開始する日数の整数値を指定します。 このパラメーターは、コンソールの [フェーズ展開の作成] ウィザードの [設定] ページの設定と同じです。遅延期間 (日数) 後にこのフェーズを自動的に開始します。
| 型: | 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 |
-Description
タスク シーケンスの段階的デプロイの説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FirstCollection
最初のフェーズのコレクション オブジェクトを指定します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FirstCollectionId
最初のフェーズのコレクション ID を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FirstCollectionName
最初のフェーズのコレクション名を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作につながる可能性があります。 これはお勧めしません。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InsertAtOrder
AddPhases パラメーターを使用する場合は、このパラメーターを使用して、フェーズの順序で追加のフェーズを挿入する場所を決定します。 順序番号を持つ整数を指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InstallationChoice
ソフトウェアが使用可能になったときに相対的な動作のオプションを指定します。
AsSoonAsPossible: このパラメーターは、コンソールの [フェーズ展開の作成] ウィザードの [設定] ページの設定と同じです。インストールはできるだけ早く必要です。AfterPeriod: このパラメーターは、コンソールの [フェーズ展開の作成] ウィザードの [設定] ページの設定と同じです。この期間を過ぎるとインストールが必要です。 この値を指定する場合は、 DeadlineUnit と DeadlineValue を使用して期間を構成します。
| 型: | InstallationChoiceType |
| 指定可能な値: | AsSoonAsPossible, AfterPeriod |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
タスク シーケンスの段階的デプロイの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SecondCollection
2 番目のフェーズのコレクション オブジェクトを指定します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SecondCollectionId
2 番目のフェーズのコレクション ID を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SecondCollectionName
2 番目のフェーズのコレクション名を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TaskSequence
タスク シーケンス オブジェクトを指定します。
| 型: | IResultObject |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-TaskSequenceId
ID でタスク シーケンスを指定します。
| 型: | String |
| Aliases: | TaskSequencePackageId |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TaskSequenceName
名前でタスク シーケンスを指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ThrottlingDays
このソフトウェアを徐々に使用できるようにする日数の整数値を指定します。 このパラメーターは、コンソールの [段階的な展開の作成] ウィザードの [設定] ページの設定と同じです。この期間 (日数) にわたってこのソフトウェアを段階的に使用できるようにします。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject