共用方式為


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、、DaysWeeksMonths。 此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同:需要在這段時間內安裝

類型: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:此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同:需要在這段時間內安裝。 如果您指定此值,請使用 DeadlineUnitDeadlineValue 來設定一段時間。

類型: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