Set-CMSoftwareUpdatePhase

模組:

ConfigurationManager

使用此 Cmdlet 可設定軟體更新的部署階段。

Syntax

Set-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-PhaseDescription <String>]
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-InputObject] <IResultObject>
   [-Name <String>]
   [-Order <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-PhaseDescription <String>]
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentId] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-PhaseDescription <String>]
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentName] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

適用于版本2006和更新版本。 使用此 Cmdlet 可設定軟體更新的部署階段。 如需詳細資訊，請參閱 建立階段性部署。

範例

範例1：變更集合

此範例會變更在命令列上傳遞的軟體更新分階段部署中第二個階段的集合。

$phasedDeployment = Get-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeployment"

$phasedDeployment | Set-CMSoftwareUpdatePhase -Order 2 -NewCollectionId "XYZ00227"

範例2：上移階段

本範例會以順序向上移動階段。 它會依識別碼選取分階段的部署，並依相關聯的集合識別碼選取階段。

Set-CMSoftwareUpdatePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp

範例3：設定階段設定

本範例會變更所選階段的設定設定。

Set-CMSoftwareUpdatePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -EnableWakeOnLan $true -PhaseDescription "this is phase 1" -StateMessageVerbosity AllMessages -ServerRestartSuppression $true -WorkstationRestartSuppression $true -RequirePostRebootFullScan $true -EnableAlert $true -AlertThresholdPercentage 90 -AlertDelta 12 -AlertUnit Hours -DisableSCOMAlert $true -GenerateSCOMAlertOnFailure $true -UseNeighborDP $true -UseSiteDefaultDP $true -AllowWUMUFallback $true -AllowMeteredConnection $true -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12

參數

-AlertDelta

此參數與主控台中 [新增階段] 嚮導的 [提醒] 頁面上的下列設定相同：自期限時間的位移。 指定位移的整數值，然後使用 AlertUnit 參數指定句點類型。

若要設定此值，您必須使用 EnableAlert 參數。

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

-AlertThresholdPercentage

此參數與主控台中 [新增階段] 嚮導之 [警示] 頁面上的下列設定相同：「**用戶端規範」低於下列 (百分比) **。 指定百分比的整數值。 若要設定此值，您必須使用 EnableAlert 參數。

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

-AlertUnit

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

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

-AllowMeteredConnection

此參數與下列設定相同：在主控台中的 [新增階段] 嚮導的 [下載設定] 頁面上，允許用戶端在設定期限內下載內容，這可能會導致額外的成本。

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

-AllowSystemRestart

此參數與主控台中 [新增階段] 嚮導的 [使用者經驗] 頁面上的下列設定相同： [**系統重新開機 (] （如果需要）才能完成安裝) **。 當達到安裝期限時，即會套用此設定，以允許在維護時段外執行此活動。

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

-AllowWumuFallback

此參數與主控台中 [新增階段] 嚮導的 [下載設定] 頁面上的下列設定相同：如果在目前、鄰居或網站邊界群組中的發佈點上無法使用軟體更新，請從 Microsoft 更新下載內容。

Type:	Boolean
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

-CollectionId

依識別碼指定目標集合。

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

-CollectionName

依名稱指定目標集合。

Type:	String
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

-DisableScomAlert

此參數與主控台中 [新增階段] 嚮導之 [警示] 頁面上的下列設定相同：在軟體更新執行時停用 Operations Manager 警示。

Type:	Boolean
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

-EnableAlert

此參數與主控台中 [新增階段] 嚮導的 [警示] 頁面上的下列設定相同：在符合下列條件時產生警示。 當您將此參數設定為時 $true ，也必須設定下列參數：

• AlertThresholdPercentage
• AlertDelta

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

-EnableWakeOnLan

在主控台中，[新增階段] 嚮導的 [部署設定] 頁面上，此參數與下列設定相同：使用 [以LAN 喚醒] 來喚醒用戶端以進行必要的部署。

Type:	Boolean
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

-GenerateScomAlertOnFailure

此參數與主控台中 [新增階段] 嚮導的 [提醒] 頁面上的下列設定相同：軟體更新安裝失敗時產生 Operations Manager 警示。

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

-InputObject

指定分階段的部署物件，其中包含要設定的階段。

Type:	IResultObject
Aliases:	PhasedDeployment
Position:	0
Default value:	None
Accept pipeline input:	True
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

-MovePhase

變更所選取階段的順序。 您可以將它向上移動，將它向下移動，或是移至指定的索引。 如果您指定 MoveToOrder ，請使用 -MoveToOrder 參數來設定特定的索引。

Type:	ReorderType
Accepted values:	MoveUp, MoveDown, MoveToOrder
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MoveToOrder

當您將 -MovePhase 參數設定為時 MoveToOrder ，請使用此參數來設定特定的索引。

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

-NewCollection

指定集合物件，以當作選取階段的新目標。

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

-NewCollectionId

指定依識別碼的集合，用作選取階段的新目標。

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

-NewCollectionName

依名稱指定集合，以當作選取階段的新目標。

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

-NewPhaseName

使用此參數可重新命名所選的階段。

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

-PhasedDeploymentId

依識別碼選取分階段部署。 然後使用其他參數選取該部署中的特定階段。

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

-PhasedDeploymentName

依名稱選取分階段部署。 然後使用其他參數選取該部署中的特定階段。

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

-PhaseDescription

指定階段的描述。

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

-RequirePostRebootFullScan

此參數與主控台中 [新增階段] 嚮導的 [使用者經驗] 頁面上的下列設定相同：如果此部署中的任何更新需要重新開機系統，請在重新開機後執行更新部署評估週期。

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

-ServerRestartSuppression

此參數與主控台中 [新增階段] 嚮導的 [使用者經驗] 頁面上的下列設定相同。 在下列裝置上抑制系統重新開機： Servers。

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

-SoftwareInstallation

在 [主控台：軟體安裝] 中的 [新增階段] 嚮導的 [使用者經驗] 頁面上，此參數與下列設定相同。 當達到安裝期限時，即會套用此設定，以允許在維護時段外執行此活動。

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

-StateMessageVerbosity

在主控台中，[新增階段] 嚮導的 [部署設定] 頁面上，此參數與下列設定相同： [ State message detail level ]，具有下列值：

• AllMessages：所有郵件
• OnlySuccessAndErrorMessages：只有成功和錯誤訊息
• OnlyErrorMessages：只有錯誤訊息

Type:	VerbosityLevelType
Accepted values:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ThrottlingDays

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

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

-UseNeighborDP

此參數與下列設定設定相同：當用戶端使用鄰居邊界群組或預設網站邊界群組中的發行點時，可使用 [部署] 選項，以供您選取要使用的部署選項。 **** 指定下列值：

• $true：從發佈點和安裝下載軟體更新
• $false：請勿安裝軟體更新

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

-UserNotificationOption

這個參數與下列設定相同：在主控台中 [新增階段] 嚮導的 [使用者經驗] 頁面上，使用下列值指定此部署的使用者經驗設定：

• DisplayAll：在軟體中心顯示並顯示所有通知
• DisplaySoftwareCenterOnly：在軟體中心中顯示，只顯示電腦重新開機的通知
• HideAll：在軟體中心和所有通知中隱藏

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSiteDefaultDP

這個參數與下列設定相同：在主控台中 [新增階段] 嚮導的 [下載設定] 頁面上 ，用戶端可以從網站預設界限群組中的發佈點下載並安裝軟體更新（如果不提供）。 指定下列值：

• $true：從網站預設界限群組中的發佈點下載並安裝軟體更新
• $false：請勿安裝軟體更新

Type:	Boolean
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

-WorkstationRestartSuppression

此參數與主控台中 [新增階段] 嚮導的 [使用者經驗] 頁面上的下列設定相同。 在下列裝置上抑制系統重新開機： 工作站。

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

-WriteFilterCommit

此參數與主控台中 [新增階段] 嚮導的 [使用者經驗] 頁面上的下列設定相同：**認可變更的期限或維護時段 (需要重新開機) **。 此設定適用于 Windows 內嵌裝置的寫入篩選器處理。

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

-名稱

指定要設定之階段的名稱。

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

-識別碼

指定要設定之階段的識別碼。

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

-集合

指定目標集合的物件。

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

-順序

指定要設定之階段的索引。

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

輸入

ConfigurationManagement IResultObject

輸出

IResultObject

相關連結

• CMPhase
• 新 CMSoftwareUpdatePhase
• CMSoftwareUpdatePhasedDeployment
• 新 CMSoftwareUpdateAutoPhasedDeployment
• 新 CMSoftwareUpdateManualPhasedDeployment
• Remove-CMSoftwareUpdatePhasedDeployment
• CMSoftwareUpdatePhasedDeployment
• CMPhasedDeploymentStatus
• 移動-CMPhasedDeploymentToNext
• Resume-CMPhasedDeployment
• 暫掛-CMPhasedDeployment
• 建立分階段的部署