New-CMApplicationAutoPhasedDeployment
このコマンドレットを使用して、同じ設定で 2 つのフェーズを生成して、アプリケーションの段階的な展開を作成します。
構文
New-CMApplicationAutoPhasedDeployment
[-Application] <IResultObject>
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMApplicationAutoPhasedDeployment
[-ApplicationId] <String>
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMApplicationAutoPhasedDeployment
[-ApplicationName] <String>
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、同じ設定で 2 つのフェーズを生成して、アプリケーションの段階的な展開を作成します。 このコマンドレットの動作は、既定の 2 フェーズ展開を自動的に作成するオプションを選択した場合、アプリケーションのフェーズ展開の作成ウィザードと同じです。 ****
注意
段階的な展開を作成する前に、アプリケーションのコンテンツを配布ポイントに配布してください。
例
例 1: アプリ名で展開を作成する
この例では、myApp アプリケーションの myDPName という名前の新しいアプリケーション 段階的展開 を作成します。
New-CMApplicationAutoPhasedDeployment -ApplicationName "myApp" -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 という名前の新しいアプリケーション 段階的展開を作成します。
$myApp | New-CMApplicationAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
パラメーター
-Application
段階的展開のアプリケーション オブジェクトを指定します。
Type: | IResultObject |
Position: | 1 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationId
段階的展開のアプリケーション ID を指定します。
Type: | String |
Aliases: | CIId, CI_ID |
Position: | 1 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationName
段階的展開のアプリケーション名を指定します。
Type: | String |
Aliases: | ApplicationLocalizedDisplayName |
Position: | 1 |
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 |
-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 |
-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