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 を使用してフェーズを作成します。
| Type: | Phase[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BeginCondition
第 1 フェーズの成功後に展開の第 2 フェーズを開始するオプションを指定します。
AfterPeriod: このパラメーターは、コンソールの [段階的展開の作成] ウィザードの**** 設定 ページの次の設定と同じです。このフェーズは、延期期間 (日) 後に自動的に開始します。 この値を指定する場合は 、DaysAfterPreviousPhaseSuccess を使用して期間を構成します。Manually: このパラメーターは、コンソールのフェーズ展開の作成ウィザードの 設定 ページの**** 次の設定と同じです。手動で第 2 フェーズ展開を開始します。
| Type: | BeginConditionType |
| Accepted values: | AfterPeriod, Manually |
| 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
第 2 フェーズを開始する最初のフェーズが成功した後の日数の整数値を指定します。 このパラメーターは、コンソールのフェーズド展開の作成ウィザードの 設定 ページの**** 次の設定と同じです。このフェーズは、延期期間 (日) 後に自動的に開始します。
| 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 |
-Description
タスク シーケンスの段階的展開の説明を指定します。
| Type: | String |
| 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 |
-FirstCollection
最初のフェーズのコレクション オブジェクトを指定します。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FirstCollectionId
最初のフェーズのコレクション ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FirstCollectionName
最初のフェーズのコレクション名を指定します。
| Type: | String |
| 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 |
-InsertAtOrder
AddPhases パラメーターを使用する場合は、このパラメーターを使用して、フェーズの順序で追加フェーズを挿入する場所を決定します。 注文番号を持つ整数を指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| 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 |
-Name
タスク シーケンスの段階的展開の名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SecondCollection
2 番目のフェーズのコレクション オブジェクトを指定します。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SecondCollectionId
2 番目のフェーズのコレクション ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SecondCollectionName
2 番目のフェーズのコレクション名を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskSequence
タスク シーケンス オブジェクトを指定します。
| Type: | IResultObject |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TaskSequenceId
タスク シーケンスを ID で指定します。
| Type: | String |
| Aliases: | TaskSequencePackageId |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskSequenceName
タスク シーケンスを名前で指定します。
| Type: | String |
| Position: | 0 |
| 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 |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject