New-CMSoftwareUpdateAutoPhasedDeployment

模組:

ConfigurationManager

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

Syntax

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 會自動為指定的兩個集合建立兩個階段。 您也可以使用此參數來新增更多階段。 指定階段的陣列。 使用 CMSoftwareUpdatePhase 來建立階段。

Type:	Phase[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-BeginCondition

指定在第一個階段成功後開始第二階段部署的選項：

• AfterPeriod：此參數與下列設定相同：在主控台中建立分階段部署嚮導的 [設定] 頁面上，[**自動于此階段開始]。延遲期間 (天數) **。 如果您指定此值，請使用 DaysAfterPreviousPhaseSuccess 來設定時間週期。

• Manually：此參數與下列設定相同：在主控台中建立分段部署嚮導的 [設定] 頁面上：手動開始第二階段部署。

Type:	BeginConditionType
Accepted values:	AfterPeriod, Manually
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

執行 Cmdlet 之前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaOption

指定選項，以選擇第一個階段成功的準則：

• Compliance：此參數與下列設定相同：在主控台中建立分段部署嚮導的 [設定] 頁面上：部署成功百分比。 使用 CriteriaValue 參數指定百分比值。

• Number：此參數與下列設定相同：在主控台中建立分段部署嚮導的 [設定] 頁面上：已成功部署的裝置數目。 使用 CriteriaValue 參數指定裝置的數目。

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaValue

這個整數值取決於您為 CriteriaOption指定的值：

• Compliance：指定百分比

• Number：指定裝置數目

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysAfterPreviousPhaseSuccess

指定第一個階段成功之後第二個階段開始的天數的整數值。 此參數與下列設定相同：在主控台中建立分階段部署嚮導的 [設定] 頁面上，自動在延遲期間 (天數) 中開始此階段。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineUnit

指定期限期限的類型。 請將此參數與 DeadlineValue搭配使用。

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineValue

只有在您 AfterPeriod 使用 InstallationChoice 參數指定時，才會使用此參數。

為期限指定時間週期的整數值。 使用 DeadlineUnit 參數可指定週期類型： Hours ，， Days Weeks ， Months 。 此參數與下列設定相同：在主控台中建立分段部署嚮導的 [設定] 頁面上：這段時間後需要安裝。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

指定軟體更新階段性部署的描述。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-FirstCollection

指定第一個階段的集合物件。

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-FirstCollectionId

指定第一個階段的集合識別碼。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-FirstCollectionName

指定第一個階段的集合名稱。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

這個參數會處理萬用字元，而且可能會造成意想不到的行為。 建議您不要使用此選項。 您無法將它與 DisableWildcardHandling合併。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InsertAtOrder

如果您使用 AddPhases 參數，請使用此參數來決定要插入其他階段的階段順序。 使用訂單編號指定整數。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallationChoice

指定當軟體可用時，其行為的選項：

• AsSoonAsPossible：此參數與下列設定相同：在主控台中建立分段部署嚮導的 [設定] 頁面上：您必須儘快安裝。

• AfterPeriod：此參數與下列設定相同：在主控台中建立分段部署嚮導的 [設定] 頁面上：這段時間後需要安裝。 如果您指定此值，請使用 DeadlineUnit 和 DeadlineValue 來設定時間週期。

Type:	InstallationChoiceType
Accepted values:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondCollection

指定第二個階段的集合物件。

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondCollectionId

指定第二個階段的集合識別碼。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondCollectionName

指定第二個階段的集合名稱。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdateGroup

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

Type:	IResultObject
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SoftwareUpdateGroupId

依識別碼指定軟體更新群組。

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdateGroupName

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

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdateIds

指定軟體更新 IDs 陣列。

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdateNames

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

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdates

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

Type:	IResultObject[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ThrottlingDays

指定此軟體可供使用的天數的整數值。 這個參數與下列設定相同：在主控台中建立分階段部署嚮導的 [設定] 頁面上，逐步使此軟體可供在此期間內 () 天內。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-名稱

指定應用程式階段性部署的名稱。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

ConfigurationManagement IResultObject

ConfigurationManagement [ManagementProvider]

輸出

IResultObject