New-CMApplicationAutoPhasedDeployment
使用此 Cmdlet，藉由產生具有相同設定的兩個階段，為應用程式建立階段式部署。
語法
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>] Description
使用此 Cmdlet，藉由產生具有相同設定的兩個階段，為應用程式建立階段式部署。 當您選取 [自動建立預設的兩階段部署] 選項時，此 Cmdlet 的行為與應用程式上的 [建立階段式部署精靈] 相同。
注意事項
建立階段式部署之前，請務必將應用程式的內容發佈至發佈點。
範例
範例 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 |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ApplicationId
指定階段式部署的應用程式識別碼。
| 類型: | String |
| 別名: | CIId, CI_ID |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ApplicationName
指定階段式部署的應用程式名稱。
| 類型: | String |
| 別名: | ApplicationLocalizedDisplayName |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-BeginCondition
指定在第一個階段成功之後開始第二個部署階段的選項：
AfterPeriod：此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同：在延遲期間之後自動開始此階段， (天) 。 如果您指定此值，請使用 DaysAfterPreviousPhaseSuccess 來設定一段時間。Manually：此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同：手動開始第二階段部署。
| 類型: | BeginConditionType |
| 接受的值: | AfterPeriod, Manually |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CriteriaOption
指定選項以選擇第一個階段的成功準則：
Compliance：此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同：部署成功百分比。 使用 CriteriaValue 參數指定百分比值。Number：此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同：成功部署的裝置數目。 使用 CriteriaValue 參數指定裝置數目。
| 類型: | CriteriaType |
| 接受的值: | Compliance, Number |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CriteriaValue
這個整數值取決於您為 CriteriaOption 指定的值：
Compliance：指定百分比Number：指定裝置數目
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DaysAfterPreviousPhaseSuccess
針對第一個階段成功后開始第二個階段的天數指定整數值。 此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同：在延遲期間之後自動開始此階段， (天) 。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DeadlineUnit
指定期限的類型。 搭配 DeadlineValue 使用此參數。
| 類型: | TimeUnitType |
| 接受的值: | Hours, Days, Weeks, Months |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DeadlineValue
只有當您使用 InstallationChoice 參數指定 AfterPeriod 時，才會使用此參數。
指定期限期間的整數值。 使用 DeadlineUnit 參數來指定期間的類型：Hours、、Days、WeeksMonths。 此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同：需要在這段時間內安裝。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定應用程式階段式部署的描述。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FirstCollection
指定第一個階段的集合物件。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FirstCollectionId
指定第一個階段的集合標識碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FirstCollectionName
指定第一個階段的集合名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為。 不建議這麼做。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InstallationChoice
針對軟體可供使用時的相對行為指定選項：
AsSoonAsPossible：此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同：需要儘快安裝。AfterPeriod：此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同：需要在這段時間內安裝。 如果您指定此值，請使用 DeadlineUnit 和 DeadlineValue 來設定一段時間。
| 類型: | InstallationChoiceType |
| 接受的值: | AsSoonAsPossible, AfterPeriod |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定應用程式階段式部署的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SecondCollection
指定第二個階段的集合物件。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SecondCollectionId
指定第二個階段的集合標識碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SecondCollectionName
指定第二個階段的集合名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ThrottlingDays
針對逐漸提供此軟體的天數指定整數值。 此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同：在) 天 (，逐漸讓此軟體在這段期間內可供使用。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
IResultObject