New-CMTaskSequencePhase

參考

模組:: ConfigurationManager

使用此 Cmdlet 建立工作順序的部署階段。

語法

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 建立工作順序的部署階段。

範例

範例 1：建立工作順序階段

此範例會為名為 MyCollection 的集合建立名為 MyTSPhase 的工作順序階段。

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

參數

-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:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-CollectionId

依標識元指定目標集合。

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

-CollectionName

依名稱指定目標集合。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	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

-InstallationChoice

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

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

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

-PhaseName

指定階段的名稱。

類型:	String
別名:	Name
Position:	Named
預設值:	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

輸入

None

輸出

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase

共用方式為