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
段階的デプロイのアプリケーション オブジェクトを指定します。
| 型: | IResultObject |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ApplicationId
段階的デプロイのアプリケーション ID を指定します。
| 型: | String |
| Aliases: | CIId, CI_ID |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ApplicationName
段階的なデプロイのアプリケーション名を指定します。
| 型: | String |
| Aliases: | ApplicationLocalizedDisplayName |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | 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 |
-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 |
-ThrottlingDays
このソフトウェアを徐々に使用できるようにする日数の整数値を指定します。 このパラメーターは、コンソールの [段階的な展開の作成] ウィザードの [設定] ページの設定と同じです。この期間 (日数) にわたってこのソフトウェアを段階的に使用できるようにします。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject