New-CMTaskSequenceDeployment

模組:

ConfigurationManager

建立工作順序部署。

語法

New-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Availability <MakeAvailableToType>]
   [-DeadlineDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-InputObject] <IResultObject>
   [-InternetOption <Boolean>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Availability <MakeAvailableToType>]
   [-DeadlineDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-InternetOption <Boolean>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-TaskSequencePackageId] <String>
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-CMTaskSequenceDeployment Cmdlet 會建立工作順序部署。 工作順序部署會將工作順序指派給計算機集合。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：部署具有許多常見參數的工作順序

此範例會執行下列動作：

• 使用 Get-CMTaskSequence Cmdlet 取得要部署的工作順序物件，並將它儲存在 $DeployTS 變數中
• 將集合定義為變數中部署的目標 $DeployCollection
• 在變數中定義 2025 年 11 月 25 日下午 8：00 的部署可用時間 $DeployAvailableTime
• 在變數中定義 2026 年 1 月 25 日下午 8：00 的部署到期時間 $DeployExpireTime
• 在變數中定義 2025 年 12 月 25 日下午 8：00 的部署期限 $ScheduleDateTime
• 使用 New-CMSchedule Cmdlet 建立具有每日週期性排程之期限的排程物件。
• 部署工作順序

$DeployTS = Get-CMTaskSequence -TaskSequencePackageId 'PS104823'
$DeployCollection = 'PS11B7C4'
$DeployAvailableTime = [datetime]::ParseExact("20251125-200000", "yyyyMMdd-HHmmss", $null)
$DeployExpireTime = [datetime]::ParseExact("20260125-200000", "yyyyMMdd-HHmmss", $null)
$ScheduleDateTime = [datetime]::ParseExact("20251225-200000", "yyyyMMdd-HHmmss", $null)
$DeploySchedule = New-CMSchedule -DurationInterval Days -RecurInterval Days -RecurCount 1 -DurationCount 0 -Start $ScheduleDateTime
New-CMTaskSequenceDeployment -InputObject $DeployTS -DeployPurpose Required -AvailableDateTime $DeployAvailableTime -Availability Clients -RerunBehavior AlwaysRerunProgram -Schedule $DeploySchedule -CollectionId $DeployCollection -ShowTaskSequenceProgress $true -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -RunFromSoftwareCenter $true -DeadlineDateTime $DeployExpireTime

參數

-AlertDateTime

如果您啟用部署警示，請使用此參數來指定警示的時間。

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

-AllowFallback

允許用戶端使用預設月台界限群組中的發佈點。

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

-AllowSharedContent

允許用戶端使用鄰近界限群組中的發佈點。

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

-Availability

指定是否要將此工作順序提供給 Configuration Manager 用戶端使用，以及當您使用開機媒體、預先設置的媒體或 PXE 部署 OS 時，是否可以執行此工作順序。

類型:	MakeAvailableToType
別名:	MakeAvailableTo
接受的值:	Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AvailableDateTime

指定此部署可用的 時機。

使用 -DeadlineDateTime 指定部署 到期時間，並 使用 -Schedule 指定部署指派或 期限。

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

-Collection

指定集合物件做為此工作順序部署的目標。 若要取得此物件，請使用 Get-CMCollection Cmdlet。

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

-CollectionId

指定集合標識碼作為此工作順序部署的目標。

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

-CollectionName

指定集合名稱作為此工作順序部署的目標。

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

-Comment

指定工作順序部署的選擇性批注。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DeadlineDateTime

使用此參數來指定部署 到期的時間。

使用 -AvailableDateTime 指定部署 可用的時間，並 使用 -Schedule 來指定部署指派或 期限。

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

-DeploymentOption

指定用戶端如何與發佈點互動，以取得工作順序的內容。 並非所有選項都可在特定案例中使用。 如需詳細資訊，請 參閱部署工作順序 - 部署選項。

類型:	DeploymentOptionType
接受的值:	DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeployPurpose

指定此部署是否可供使用者安裝，或是否需要在期限安裝。

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

-DisableWildcardHandling

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

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

-DistributeCollectionName

網站會將內容發佈至與此集合名稱相關聯的發佈點群組。

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

-DistributeContent

新增此參數，以在建立此部署時發佈工作順序內容。 在您將內容發佈至用戶端可存取的發佈點之前，客戶端無法安裝工作順序。

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

-DistributionPointGroupName

網站會將內容發佈至此發佈點群組。

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

-DistributionPointName

網站會將內容發佈至此發佈點。

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

-ForceWildcardHandling

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

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

-InputObject

指定要部署的工作順序物件。 若要取得工作順序物件，請使用 Get-CMTaskSequence Cmdlet。

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

-InternetOption

允許工作順序針對因特網上的客戶端執行。

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

-PercentFailure

如果您為失敗的部署建立警示，當失敗的部署百分比高於此數目時，月臺會產生警示。

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

-PercentSuccess

如果您建立成功部署的警示，當成功部署的百分比低於此數目時，月臺會產生警示。

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

-PersistOnWriteFilterDevice

設定用戶端如何處理 Windows Embedded 裝置上的寫入篩選器。

• $true：在期限或維護期間認可變更。 需要重新啟動。
• $false：在重迭上套用內容，稍後再認可。

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

-RerunBehavior

指定如果工作順序先前在排定的強制時間之前執行，該工作順序是否會在計算機上重新執行。 根據預設，工作順序一律會重新執行。

類型:	RerunBehaviorType
接受的值:	NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RunFromSoftwareCenter

允許用戶獨立於指派執行程式。

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

-Schedule

使用此參數來指定部署指派或 期限。

使用 -AvailableDateTime 指定部署 可用的時間，並使用 -DeadlineDateTime 指定部署 到期時間。

指定排程物件的陣列。 排程物件會定義部署的強制指派排程。 若要建立排程物件，請使用 New-CMSchedule Cmdlet。

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

-ScheduleEvent

指定決定工作順序部署執行時間的事件陣列。

類型:	ScheduleEventType[]
接受的值:	AsSoonAsPossible, LogOn, LogOff
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SendWakeupPacket

指出是否要在部署開始之前將喚醒封包傳送至電腦。 如果此值為 $True，Configuration Manager 會喚醒電腦進入睡眠狀態。 如果此值為 $False，則不會喚醒計算機進入睡眠狀態。 若要喚醒計算機，請先設定網路喚醒。

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

-ShowTaskSequenceProgress

指出是否要顯示工作順序的進程對話框。

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

-SoftwareInstallation

達到安裝期限時，請將此參數設定為 $true ，以允許工作順序在維護期間外安裝。

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

-SystemRestart

達到安裝期限時，請將此參數設定為 $true ，以在必要時段外允許系統重新啟動。

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

-TaskSequencePackageId

指定要部署之工作順序的標識碼。

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

-UseMeteredNetwork

指出是否允許計量付費因特網連線上的用戶端在安裝期限之後下載內容，這可能會產生額外成本。

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

-UseUtcForAvailableSchedule

指出客戶端電腦是否使用UTC時間來判斷程式的可用性。 UTC 時間可讓所有電腦同時使用工作順序。

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

-UseUtcForExpireSchedule

指出客戶端電腦是否使用UTC時間來判斷程式的到期。 UTC 時間可讓所有電腦同時使用工作順序。

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

-WhatIf

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject

備註

請務必適當地使用排程參數：

• -AvailableDateTime：指定何時 可以使用此部署。

• -DeadlineDateTime：指定部署 到期的時間。

• -Schedule：指定部署指派或 期限。

相關連結

• Get-CMTaskSequenceDeployment
• Set-CMTaskSequenceDeployment
• Remove-CMTaskSequenceDeployment
• Get-CMTaskSequence
• 部署工作順序