Set-CMSoftwareUpdatePhase

模組:

ConfigurationManager

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

語法

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 參數。

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

-AlertThresholdPercentage

此參數與控制台中 [新增階段精靈] 的 [警示] 頁面上的下列設定相同：客戶端合規性低於下列 (百分比) 。 指定百分比的整數值。 若要設定此值，您必須使用 EnableAlert 參數。

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

-AlertUnit

指定句點的類型。 使用此參數搭配 AlertDelta。

類型:	TimeUnitType
接受的值:	Hours, Days, Weeks, Months
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowMeteredConnection

此參數與控制台中 [新增階段精靈] 之 [下載設定] 頁面上的下列設定相同：允許計量付費因特網連線上的用戶端在安裝期限之後下載內容，這可能會產生額外成本。

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

-AllowSystemRestart

此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同：如果需要，系統會重新啟動 () 完成安裝。 此設定會在達到安裝期限時套用，以允許在維護期間外執行此活動。

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

-AllowWumuFallback

此參數與控制台中 [新增階段精靈] 之 [下載設定] 頁面上的下列設定相同：如果目前、鄰近或月臺界限群組的發佈點上無法使用軟體更新，請從Microsoft更新下載內容。

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

-BeginCondition

指定在上一個階段成功之後開始此部署階段的選項：

• AfterPeriod：此參數與控制台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同：在延遲期間之後自動開始此階段， (天) 。 如果您指定此值，請使用 DaysAfterPreviousPhaseSuccess 來設定一段時間。

• Manually：此參數與控制台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同：手動開始此部署階段。

類型:	BeginConditionType
接受的值:	AfterPeriod, Manually
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Collection

指定目標集合的物件。

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

-CollectionId

依標識元指定目標集合。

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

-CollectionName

依名稱指定目標集合。

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

-DisableScomAlert

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

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

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

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

-EnableAlert

此參數與控制台中 [新增階段精靈] 之 [警示] 頁面上的下列設定相同：符合下列條件時產生警示。 當您將此參數設定為 $true時，也請設定下列參數：

• AlertThresholdPercentage
• AlertDelta

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

-EnableWakeOnLan

此參數與控制台中 [新增階段精靈] 之 [部署設定] 頁面上的下列設定相同：使用網络喚醒來喚醒需要部署的用戶端。

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

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為。 不建議這麼做。 您無法將其與 DisableWildcardHandling 結合。

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

-GenerateScomAlertOnFailure

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

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

-Id

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

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

-InputObject

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

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

-InstallationChoice

針對軟體可供使用時的相對行為指定選項：

• AsSoonAsPossible：此參數與控制台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同：需要儘快安裝。

• AfterPeriod：此參數與控制台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同：在這段期間之後需要安裝。 如果您指定此值，請使用 DeadlineUnit 和 DeadlineValue 來設定一段時間。

類型:	InstallationChoiceType
接受的值:	AsSoonAsPossible, AfterPeriod
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MovePhase

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

類型:	ReorderType
接受的值:	MoveUp, MoveDown, MoveToOrder
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MoveToOrder

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

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

-Name

指定要設定的階段名稱。

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

-NewCollection

指定集合物件做為所選階段的新目標。

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

-NewCollectionId

依標識元指定集合，以做為所選階段的新目標。

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

-NewCollectionName

依名稱指定集合，以做為所選階段的新目標。

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

-NewPhaseName

使用此參數來重新命名選取的階段。

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

-Order

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

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

-PhasedDeploymentId

依標識符選取階段式部署。 然後使用其他參數來選取該部署中的特定階段。

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

-PhasedDeploymentName

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

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

-PhaseDescription

指定階段的描述。

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

-RequirePostRebootFullScan

此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同：如果此部署中有任何更新需要系統重新啟動，請在重新啟動後執行更新部署評估週期。

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

-ServerRestartSuppression

此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同。 隱藏下列裝置上的系統重新啟動： 伺服器。

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

-SoftwareInstallation

此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同：[軟體安裝]。 此設定會在達到安裝期限時套用，以允許在維護期間外執行此活動。

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

-StateMessageVerbosity

此參數與控制台中 [新增階段精靈] 之 [部署設定] 頁面上的下列設定相同：狀態消息詳細數據層級，具有下列值：

• AllMessages：所有訊息
• OnlySuccessAndErrorMessages：只有成功和錯誤訊息
• OnlyErrorMessages：僅限錯誤訊息

類型:	VerbosityLevelType
接受的值:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ThrottlingDays

針對逐漸提供此軟體的天數指定整數值。 此參數與控制台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同：在) 的天數內，逐漸將此軟體 (一段時間內提供。

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

-UseNeighborDP

此參數與控制台中 [新增階段精靈] 之 [下載設定] 頁面上的下列設定相同：當用戶端使用鄰近界限群組或預設月臺界限群組的發佈點時，請選取要使用的部署選項。 指定下列值：

• $true：從發佈點下載軟體更新並安裝
• $false：不要安裝軟體更新

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

-UserNotificationOption

此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同：使用下列值指定此部署的使用者體驗設定：

• DisplayAll：在軟體中心顯示並顯示所有通知
• DisplaySoftwareCenterOnly：顯示在軟體中心，只顯示計算機重新啟動的通知
• HideAll：在軟體中心和所有通知中隱藏

類型:	UserNotificationType
接受的值:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UseSiteDefaultDP

此參數與控制台中 [新增階段精靈] 之 [下載設定] 頁面上的下列設定相同：當目前或鄰近界限群組中的任何發佈點上都無法使用軟體更新時，用戶端可以從站台預設界限群組中的發佈點下載並安裝軟體更新。 指定下列值：

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

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

-WhatIf

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

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

-WorkstationRestartSuppression

此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同。 隱藏下列裝置上的系統重新啟動： 工作站。

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

-WriteFilterCommit

此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同：在期限或維護期間認可變更 (需要重新啟動) 。 此設定適用於 Windows Embedded 裝置的寫入篩選處理。

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject

相關連結

• Get-CMPhase
• New-CMSoftwareUpdatePhase
• Get-CMSoftwareUpdatePhasedDeployment
• New-CMSoftwareUpdateAutoPhasedDeployment
• New-CMSoftwareUpdateManualPhasedDeployment
• Remove-CMSoftwareUpdatePhasedDeployment
• Set-CMSoftwareUpdatePhasedDeployment
• Get-CMPhasedDeploymentStatus
• Move-CMPhasedDeploymentToNext
• Resume-CMPhasedDeployment
• Suspend-CMPhasedDeployment
• 建立階段式部署