New-CMApplicationAutoPhasedDeployment

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

このコマンドレットを使用して、同じ設定で 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