Set-CMTaskSequencePhase
使用此 Cmdlet 可設定任務順序的部署階段。
Syntax
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
此參數與主控台中 [新增階段] 嚮導之 [發佈點] 頁面上的下列設定相同:允許用戶端使用來自預設網站邊界群組的發佈點。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRemoteDP
此參數與主控台中 [新增階段] 嚮導之 [發佈點] 頁面上的下列設定相同:當沒有本機發佈點可用時,請使用遠端發佈點。
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 |
-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 |
-DeploymentOption
這個參數與下列設定相同:當用戶端使用鄰居邊界群組或預設網站邊界群組中的發行點時,可使用的部署選項來使用此參數。 **** **** 它會接受下列值:
DownloadContentLocallyWhenNeededByRunningTaskSequence
:執行任務順序需要在本機下載內容DownloadAllContentLocallyBeforeStartingTaskSequence
:開始任務順序之前,請先在本機下載所有內容
Type: | DeploymentOptionType |
Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
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 |
-ForceWildcardHandling
這個參數會處理萬用字元,而且可能會造成意想不到的行為。 建議您不要使用此選項。 您無法將它與 DisableWildcardHandling合併。
Type: | SwitchParameter |
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 |
-PreDownload
在主控台中,[新增階段] 嚮導的 [一般] 頁面上,此參數與下列設定相同: [預先下載此任務順序的內容]。
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 |
-ThrottlingDays
指定此軟體可供使用的天數的整數值。 此參數與主控台中 [新增階段] 嚮導的 [階段設定] 頁面上的下列設定相同:逐步使此軟體可供在這段時間內,) 天內 (。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
這個參數與下列設定相同:在主控台中 [新增階段] 嚮導的 [使用者經驗] 頁面上,使用下列值指定此部署的使用者經驗設定:
DisplayAll
:在軟體中心顯示並顯示所有通知HideAll
:在軟體中心和所有通知中隱藏
Type: | UserNotificationType |
Accepted values: | DisplayAll, HideAll |
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 |
-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 |
-批註
指定此階段的選用批註。 最大長度為512個字元。
Type: | String |
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
- 新 CMTaskSequencePhase
- CMTaskSequencePhasedDeployment
- 新 CMTaskSequenceAutoPhasedDeployment
- 新 CMTaskSequenceManualPhasedDeployment
- Remove-CMTaskSequencePhasedDeployment
- CMTaskSequencePhasedDeployment
- CMPhasedDeploymentStatus
- 移動-CMPhasedDeploymentToNext
- Resume-CMPhasedDeployment
- 暫掛-CMPhasedDeployment
- 建立分階段的部署