New-CMSoftwareUpdateAutoPhasedDeployment

參考

模組:: ConfigurationManager

使用此 Cmdlet 來建立軟體更新的階段式部署，方法是產生具有相同設定的兩個階段。

語法

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>]

Description

使用此 Cmdlet 來建立軟體更新的階段式部署，方法是產生具有相同設定的兩個階段。當您選取 [自動建立預設的兩階段部署] 選項時，此 Cmdlet 的行為與軟體更新上的 [建立階段式部署精靈] 相同。

注意事項

建立階段式部署之前，請務必將軟體更新內容發佈至發佈點。

範例

範例 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

此 Cmdlet 會自動為指定的兩個集合建立兩個階段。您也可以使用此參數新增更多階段。指定階段陣列。使用 New-CMSoftwareUpdatePhase 建立階段。

類型:	Phase[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	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

-InsertAtOrder

如果您使用 AddPhases 參數，請使用此參數來判斷階段順序中插入其他階段的位置。指定具有訂單編號的整數。

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

-SoftwareUpdateGroup

指定軟體更新群組的物件。

類型:	IResultObject
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-SoftwareUpdateGroupId

依標識子指定軟體更新群組。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SoftwareUpdateGroupName

依名稱指定軟體更新群組。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SoftwareUpdateIds

指定軟體更新識別碼的陣列。

類型:	String[]
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SoftwareUpdateNames

指定軟體更新名稱的陣列。

類型:	String[]
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SoftwareUpdates

指定軟體更新物件的陣列。

類型:	IResultObject[]
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ThrottlingDays

針對逐漸提供此軟體的天數指定整數值。此參數與控制台中 [建立階段式部署精靈] 之 [設定] 頁面上的下列設定相同：在) 天 (，逐漸讓此軟體在這段期間內可供使用。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

輸出

IResultObject

共用方式為