Set-CMTaskSequenceDeployment

模組:

ConfigurationManager

設定工作順序部署。

語法

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   -InputObject <IResultObject>
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequenceDeploymentId <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequenceName <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequencePackageId <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-CMTaskSequenceDeployment Cmdlet 會設定工作順序部署。 工作順序部署會將工作順序指派給計算機集合。

注意事項

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

範例

範例 1：設定部署以顯示進度

此命令會使用工作順序名稱和集合名稱來設定工作順序部署。 它會設定 批注，並讓客戶端顯示工作順序進度。

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Systems" -Comment "Task sequence test" -ShowTaskSequenceProgress $True

範例 2：重新設定工作順序部署

此命令會重新設定工作順序部署的大部分設定。

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Desktop and Server Clients" -Comment "Task sequence test" -SendWakeupPacket $True -UseMeteredNetwork $True -DeploymentExpireDateTime $(Get-Date) -ScheduleEvent LogOff -RerunBehavior NeverRerunDeployedProgram -AllowUsersRunIndependently $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -InternetOption $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowFallback $True -AllowSharedContent $True

參數

-AddSchedule

指定要新增至部署的排程令牌物件。 若要建立排程物件，請使用 New-CMSchedule Cmdlet。

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

-AddScheduleEvent

指定要新增至部署的其中一個已接受排程事件。

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

-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

-AllowUsersRunIndependently

指出是否允許使用者獨立執行程式，而不論其指派狀態為何。

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

-ClearSchedule

新增此參數以從部署中移除所有排程。

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

-ClearScheduleEvent

新增此參數，以從部署中移除所有排程事件。

類型:	SwitchParameter
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
接受萬用字元:	True

-Comment

指定工作順序部署的選擇性批注，以協助描述它。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-CreateAlertOnFailure

指出是否要在失敗時建立警示。

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

-CreateAlertOnSuccess

指出是否要在成功時建立警示。

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

-DeploymentAvailableDateTime

指定部署可用的日期時間。

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

-DeploymentExpireDateTime

指定部署到期日期時間。

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

-DeploymentOption

指定用戶端是否在啟動工作順序之前先下載所有內容，或視執行中工作順序的需求下載內容。

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

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

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

-InternetOption

指出工作順序是否在透過因特網連線的用戶端上執行。

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

-MakeAvailableTo

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

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

-PassThru

傳回目前的工作物件。 根據預設，此 Cmdlet 不會產生任何輸出。

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

-PercentFailure

指定失敗工作順序部署的閾值百分比。

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

-PercentSuccess

指定成功部署工作順序的閾值百分比。

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

-PersistOnWriteFilterDevice

指出是否要在暫存重迭上安裝工作順序，並在稍後認可變更，或是在安裝期限或維護期間認可變更。 此設定適用於使用寫入篩選器執行內嵌 Windows 版本的裝置。

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

-RemoveSchedule

指定要從部署中移除的排程令牌物件。 若要建立排程物件，請使用 New-CMSchedule Cmdlet。

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

-RemoveScheduleEvent

指定要從部署中移除的其中一個已接受排程事件。

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

-RerunBehavior

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

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

-Schedule

指定 CMSchedule 物件的陣列。 CMSchedule 物件會定義部署的強制指派排程。 若要建立 CMSchedule 物件，請使用 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

指出是否允許安裝應用程式，即使安裝是在維護期間之外也一樣。

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

-SystemRestart

指出是否允許已公告的程式重新啟動系統，即使重新啟動是在維護期間之外也一樣。

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

-TaskSequenceDeploymentId

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

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

-TaskSequenceName

指定要部署之工作順序的名稱。

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

-TaskSequencePackageId

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

類型:	String
Position:	Named
預設值:	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
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject

相關連結

• New-CMTaskSequenceDeployment
• Get-CMTaskSequenceDeployment
• Remove-CMTaskSequenceDeployment
• New-CMSchedule
• Get-CMTaskSequence