New-CMSoftwareUpdateAutoPhasedDeployment
このコマンドレットを使用して、同じ設定で 2 つのフェーズを生成することで、ソフトウェア更新プログラムの段階的な展開を作成します。
構文
New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateGroup] <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-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateGroupId] <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-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateGroupName] <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-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateIds] <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-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateNames] <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-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdates] <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>] 説明
このコマンドレットを使用して、同じ設定で 2 つのフェーズを生成することで、ソフトウェア更新プログラムの段階的な展開を作成します。 このコマンドレットの動作は、[既定の 2 フェーズ展開 を 自動的に作成する] オプションを選択すると、ソフトウェア更新プログラムの段階的展開の作成ウィザードと同じです。
注:
段階的な展開を作成する前に、ソフトウェア更新プログラムのコンテンツを配布ポイントに配布してください。
例
例 1: 更新プログラム名でデプロイを作成する
この例では、ソフトウェア更新プログラム myUpdateName の myDPName という名前の新しいソフトウェア更新プログラム段階的展開を作成します。
New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -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 という名前の新しいソフトウェア更新プログラム段階的展開を作成します。
$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -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-CMSoftwareUpdatePhase を使用してフェーズを作成します。
| 型: | 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 |
-SoftwareUpdateGroup
ソフトウェア更新グループのオブジェクトを指定します。
| 型: | IResultObject |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdateGroupId
ソフトウェア更新プログラム グループを ID で指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdateGroupName
ソフトウェア更新プログラム グループを名前で指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdateIds
ソフトウェア更新プログラム ID の配列を指定します。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdateNames
ソフトウェア更新プログラム名の配列を指定します。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdates
ソフトウェア更新オブジェクトの配列を指定します。
| 型: | IResultObject[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ThrottlingDays
このソフトウェアを徐々に使用できるようにする日数の整数値を指定します。 このパラメーターは、コンソールの [段階的な展開の作成] ウィザードの [設定] ページの設定と同じです。この期間 (日数) にわたってこのソフトウェアを段階的に使用できるようにします。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
出力
IResultObject