Set-CMTaskSequencePhase
使用此 Cmdlet 來設定工作順序的部署階段。
語法
Set-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-Comments <String>]
[-DeploymentOption <DeploymentOptionType>]
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-UserNotification <UserNotificationType>]
[-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-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-Comments <String>]
[-DeploymentOption <DeploymentOptionType>]
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-UserNotification <UserNotificationType>]
[-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-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-Comments <String>]
[-DeploymentOption <DeploymentOptionType>]
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-UserNotification <UserNotificationType>]
[-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-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"
$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"範例 2：向上移動階段
本範例會依順序將階段向上移動。 它會依標識符選取階段式部署，並依相關聯的集合標識碼選取階段。
Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp範例 3：設定階段設定
此範例會變更所選階段的組態設定。
Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12參數
-AllowFallback
此參數與控制台中 [新增階段精靈] 之 [發佈點] 頁面上的下列設定相同：允許用戶端使用預設月臺界限群組中的發佈點。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AllowRemoteDP
此參數與控制台中 [新增階段精靈] 之 [發佈點] 頁面上的下列設定相同：沒有本機發佈點可用時，請使用遠端發佈點。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AllowSystemRestart
此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同：如果需要，系統會重新啟動 () 完成安裝。 此設定會在達到安裝期限時套用，以允許在維護期間外執行此活動。
| 類型: | 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 |
-Comments
指定此階段的選擇性批注。 最大長度為 512 個字元。
| 類型: | 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 |
-DeploymentOption
此參數與控制台中 [新增階段精靈] 之 [發佈點] 頁面上的下列設定相同：當用戶端使用鄰近界限群組或預設月臺界限群組的發佈點時，請選取要使用的部署選項。 它接受下列值：
-
DownloadContentLocallyWhenNeededByRunningTaskSequence：在執行中工作順序需要時，於本機下載內容 -
DownloadAllContentLocallyBeforeStartingTaskSequence：啟動工作順序之前，先在本機下載所有內容
| 類型: | DeploymentOptionType |
| 接受的值: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為。 不建議這麼做。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| 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 |
-PreDownload
此參數與控制台中 [新增階段精靈] 的 [一般] 頁面上的下列設定相同：預先下載此工作順序的內容。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SoftwareInstallation
此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同：[軟體安裝]。 此設定會在達到安裝期限時套用，以允許在維護期間外執行此活動。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ThrottlingDays
針對逐漸提供此軟體的天數指定整數值。 此參數與控制台中 [新增階段精靈] 之 [階段設定] 頁面上的下列設定相同：在) 的天數內，逐漸將此軟體 (一段時間內提供。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UserNotification
此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同：使用下列值指定此部署的使用者體驗設定：
-
DisplayAll：在軟體中心顯示並顯示所有通知 -
HideAll：在軟體中心和所有通知中隱藏
| 類型: | UserNotificationType |
| 接受的值: | DisplayAll, HideAll |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WriteFilterCommit
此參數與控制台中 [新增階段精靈] 之 [用戶體驗] 頁面上的下列設定相同：在期限或維護期間認可變更 (需要重新啟動) 。 此設定適用於 Windows Embedded 裝置的寫入篩選處理。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
IResultObject
相關連結
- Get-CMPhase
- New-CMTaskSequencePhase
- Get-CMTaskSequencePhasedDeployment
- New-CMTaskSequenceAutoPhasedDeployment
- New-CMTaskSequenceManualPhasedDeployment
- Remove-CMTaskSequencePhasedDeployment
- Set-CMTaskSequencePhasedDeployment
- Get-CMPhasedDeploymentStatus
- Move-CMPhasedDeploymentToNext
- Resume-CMPhasedDeployment
- Suspend-CMPhasedDeployment
- 建立階段式部署