New-CMSoftwareUpdatePhase
使用此 Cmdlet 建立軟體更新的部署階段。
Syntax
New-CMSoftwareUpdatePhase
[-AlertDelta <Int32>]
[-AlertThresholdPercentage <Int32>]
[-AlertUnit <TimeUnitType>]
[-AllowMeteredConnection <Boolean>]
[-AllowSystemRestart <Boolean>]
[-AllowWumuFallback <Boolean>]
[-BeginCondition <BeginConditionType>]
[-Collection] <IResultObject>
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DisableScomAlert <Boolean>]
[-EnableAlert <Boolean>]
[-EnableWakeOnLan <Boolean>]
[-GenerateScomAlertOnFailure <Boolean>]
[-InstallationChoice <InstallationChoiceType>]
[-PhaseDescription <String>]
-PhaseName <String>
[-RequirePostRebootFullScan <Boolean>]
[-ServerRestartSuppression <Boolean>]
[-SoftwareInstallation <Boolean>]
[-StateMessageVerbosity <VerbosityLevelType>]
[-ThrottlingDays <Int32>]
[-UseNeighborDP <Boolean>]
[-UserNotificationOption <UserNotificationType>]
[-UseSiteDefaultDP <Boolean>]
[-WorkstationRestartSuppression <Boolean>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdatePhase
[-AlertDelta <Int32>]
[-AlertThresholdPercentage <Int32>]
[-AlertUnit <TimeUnitType>]
[-AllowMeteredConnection <Boolean>]
[-AllowSystemRestart <Boolean>]
[-AllowWumuFallback <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CollectionId] <String>
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DisableScomAlert <Boolean>]
[-EnableAlert <Boolean>]
[-EnableWakeOnLan <Boolean>]
[-GenerateScomAlertOnFailure <Boolean>]
[-InstallationChoice <InstallationChoiceType>]
[-PhaseDescription <String>]
-PhaseName <String>
[-RequirePostRebootFullScan <Boolean>]
[-ServerRestartSuppression <Boolean>]
[-SoftwareInstallation <Boolean>]
[-StateMessageVerbosity <VerbosityLevelType>]
[-ThrottlingDays <Int32>]
[-UseNeighborDP <Boolean>]
[-UserNotificationOption <UserNotificationType>]
[-UseSiteDefaultDP <Boolean>]
[-WorkstationRestartSuppression <Boolean>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdatePhase
[-AlertDelta <Int32>]
[-AlertThresholdPercentage <Int32>]
[-AlertUnit <TimeUnitType>]
[-AllowMeteredConnection <Boolean>]
[-AllowSystemRestart <Boolean>]
[-AllowWumuFallback <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CollectionName] <String>
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DisableScomAlert <Boolean>]
[-EnableAlert <Boolean>]
[-EnableWakeOnLan <Boolean>]
[-GenerateScomAlertOnFailure <Boolean>]
[-InstallationChoice <InstallationChoiceType>]
[-PhaseDescription <String>]
-PhaseName <String>
[-RequirePostRebootFullScan <Boolean>]
[-ServerRestartSuppression <Boolean>]
[-SoftwareInstallation <Boolean>]
[-StateMessageVerbosity <VerbosityLevelType>]
[-ThrottlingDays <Int32>]
[-UseNeighborDP <Boolean>]
[-UserNotificationOption <UserNotificationType>]
[-UseSiteDefaultDP <Boolean>]
[-WorkstationRestartSuppression <Boolean>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 建立軟體更新的部署階段。
範例
範例 1:建立軟體更新階段
此範例會為名為MyCollection的集合建立名為MySUPhase的軟體更新階段,該集合只會顯示在軟體中心內。
New-CMSoftwareUpdatePhase `
-CollectionName "MyCollection" `
-PhaseName "MySUPhase" `
-UserNotificationOption DisplaySoftwareCenterOnly
參數
-AlertDelta
此參數與主控台中 [新增階段精靈] 的 [警示] 頁面上的下列設定相同:從期限時間位移。 指定位移的整數值,然後使用 AlertUnit 參數指定句點類型。
若要設定此值,您必須使用 EnableAlert 參數。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertThresholdPercentage
此參數與主控台中 [新增階段精靈] 的 [警示] 頁面上的下列設定相同:用戶端合規性低於下列 (百分比) 。 指定百分比的整數值。 若要設定此值,您必須使用 EnableAlert 參數。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertUnit
指定句點的類型。 使用此參數搭配 AlertDelta。
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowMeteredConnection
此參數與主控台中 [新增階段精靈] 之 [下載設定] 頁面上的下列設定相同:允許計量付費網際網路連線上的用戶端在安裝期限之後下載內容,這可能會產生額外成本。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSystemRestart
此參數與主控台中 [新增階段精靈] 之 [使用者體驗] 頁面上的下列設定相同:如果需要,系統會重新開機 () 完成安裝。 此設定會在達到安裝期限時套用,以允許在維護期間外執行此活動。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowWumuFallback
此參數與主控台中 [新增階段精靈] 之 [下載設定] 頁面上的下列設定相同:如果目前、鄰近或月臺界限群組的發佈點上無法使用軟體更新,請從 Microsoft 更新 下載內容。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BeginCondition
指定在上一個階段成功之後開始此部署階段的選項:
AfterPeriod
:此參數與主控台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同:在延遲期間之後自動開始此階段, (天) 。 如果您指定此值,請使用 DaysAfterPreviousPhaseSuccess 來設定一段時間。Manually
:此參數與主控台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同:手動開始此部署階段。
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
指定目標集合的 物件。
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
依識別碼指定目標集合。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
依名稱指定目標集合。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaOption
指定選項,以選擇上一個階段的成功準則:
Compliance
:此參數與主控台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同:部署成功百分比。 使用 CriteriaValue 參數指定百分比值。Number
:此參數與主控台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同:成功部署的裝置數目。 使用 CriteriaValue 參數指定裝置數目。
Type: | CriteriaType |
Accepted values: | Compliance, Number |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaValue
這個整數值取決於您為 CriteriaOption 指定的值:
Compliance
:指定百分比Number
:指定裝置數目
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
針對上一個階段成功之後的天數指定整數值,以開始此階段。 此參數與主控台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同:在延遲期間之後自動開始此階段, (天) 。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineUnit
指定期限的類型。 搭配 DeadlineValue使用此參數。
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineValue
只有當您使用InstallationChoice參數指定 AfterPeriod
時,才會使用此參數。
指定期限期間的整數值。 使用 DeadlineUnit 參數來指定期間的類型: Hours
、、 Days
、 Weeks
Months
。 此參數與主控台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同:在這段期間之後需要安裝。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableScomAlert
此參數與主控台中 [新增階段精靈] 的 [警示] 頁面上的下列設定相同:軟體更新執行時停用 Operations Manager 警示。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAlert
此參數與主控台中 [新增階段精靈] 之 [警示] 頁面上的下列設定相同:符合下列條件時產生警示。 當您將此參數設定為 $true
時,也請設定下列參數:
- AlertThresholdPercentage
- AlertDelta
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableWakeOnLan
此參數與主控台中 [新增階段精靈] 之 [部署設定] 頁面上的下列設定相同:使用網路喚醒來喚醒需要部署的用戶端。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此參數會處理萬用字元,並可能導致非預期的行為。 不建議這麼做。 您無法將其與 DisableWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateScomAlertOnFailure
此參數與主控台中 [新增階段精靈] 的 [警示] 頁面上的下列設定相同:軟體更新安裝失敗時產生 Operations Manager 警示。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallationChoice
針對軟體可供使用時的相對行為指定選項:
AsSoonAsPossible
:此參數與主控台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同:需要儘快安裝。AfterPeriod
:此參數與主控台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同:在這段期間之後需要安裝。 如果您指定此值,請使用 DeadlineUnit 和 DeadlineValue 來設定一段時間。
Type: | InstallationChoiceType |
Accepted values: | AsSoonAsPossible, AfterPeriod |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhaseDescription
指定階段的描述。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhaseName
指定描述的名稱。
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequirePostRebootFullScan
此參數與主控台中 [新增階段精靈] 之 [使用者體驗] 頁面上的下列設定相同:如果此部署中有任何更新需要系統重新開機,請在重新開機後執行更新部署評估週期。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerRestartSuppression
此參數與主控台中 [新增階段精靈] 之 [使用者體驗] 頁面上的下列設定相同。 隱藏下列裝置上的系統重新開機: 伺服器。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
此參數與主控台中 [新增階段精靈] 之 [使用者體驗] 頁面上的下列設定相同:[軟體安裝]。 此設定會在達到安裝期限時套用,以允許在維護期間外執行此活動。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StateMessageVerbosity
此參數與主控台中 [新增階段精靈] 之 [部署設定] 頁面上的下列設定相同:狀態訊息詳細資料層級,具有下列值:
AllMessages
:所有訊息OnlySuccessAndErrorMessages
:只有成功和錯誤訊息OnlyErrorMessages
:僅限錯誤訊息
Type: | VerbosityLevelType |
Accepted values: | AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottlingDays
針對逐漸提供此軟體的天數指定整數值。 此參數與主控台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同:) 天數 (,逐漸讓此軟體在這段期間內可供使用。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseNeighborDP
此參數與主控台中 [新增階段精靈] 之 [下載設定] 頁面上的下列設定相同:當用戶端使用鄰近界限群組或預設月臺界限群組的發佈點時,請選取要使用的部署選項。 指定下列值:
$true
:從發佈點下載軟體更新並安裝$false
:不要安裝軟體更新
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotificationOption
此參數與主控台中 [新增階段精靈] 之 [使用者體驗] 頁面上的下列設定相同:使用下列值指定此部署的使用者體驗設定:
DisplayAll
:在軟體中心顯示並顯示所有通知DisplaySoftwareCenterOnly
:顯示在軟體中心,只顯示電腦重新開機的通知HideAll
:在軟體中心和所有通知中隱藏
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSiteDefaultDP
此參數與主控台中 [新增階段精靈] 之 [下載設定] 頁面上的下列設定相同:當目前或鄰近界限群組中的任何發佈點上都無法使用軟體更新時,用戶端可以從月臺預設界限群組中的發佈點下載並安裝軟體更新。 指定下列值:
$true
:從月臺預設界限群組中的發佈點下載並安裝軟體更新$false
:不要安裝軟體更新
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkstationRestartSuppression
此參數與主控台中 [新增階段精靈] 之 [使用者體驗] 頁面上的下列設定相同。 隱藏下列裝置上的系統重新開機: 工作站。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WriteFilterCommit
此參數與主控台中 [新增階段精靈] 之 [使用者體驗] 頁面上的下列設定相同:在期限或維護期間認可變更 (需要重新開機) 。 此設定適用于 Windows Embedded 裝置的寫入篩選處理。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
None
輸出
Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應