Start-CMTaskSequenceDeployment
(已淘汰) 啟動工作順序部署。
語法
Start-CMTaskSequenceDeployment
[-AlertDateTime <DateTime>]
[-AlertDay <DateTime>]
[-AlertTime <DateTime>]
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Availability <MakeAvailableToType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>]
[-DeployPurpose <DeployPurposeType>]
[-InputObject] <IResultObject>
[-InternetOption <Boolean>]
[-PassThru]
[-PercentFailure <Int32>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-ShowTaskSequenceProgress <Boolean>]
[-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMTaskSequenceDeployment
[-AlertDateTime <DateTime>]
[-AlertDay <DateTime>]
[-AlertTime <DateTime>]
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Availability <MakeAvailableToType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>]
[-DeployPurpose <DeployPurposeType>]
[-InternetOption <Boolean>]
[-PassThru]
[-PercentFailure <Int32>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-ShowTaskSequenceProgress <Boolean>]
[-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>]
[-TaskSequencePackageId] <String>
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
重要事項
此 Cmdlet 已被取代。 請改用 New-CMTaskSequenceDeployment 。
使用此 Cmdlet 來啟動工作順序部署。 工作順序部署會將工作順序指派給計算機集合。 如需詳細資訊,請 參閱在 Configuration Manager 中部署工作順序。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:使用預設選項啟動工作順序部署
此命令會使用工作順序部署的名稱和集合的名稱來啟動工作順序部署。
Get-CMTaskSequence -Name "Upgrade Windows 10" | Start-CMTaskSequenceDeployment -CollectionName "Collection 01"
範例 2:使用已設定的選項啟動工作順序部署
此命令會啟動具有數個已設定選項的工作順序部署。
Start-CMTaskSequenceDeployment -TaskSequencePackageId "XYZ00003" -CollectionName "Collection 02" -Comment "Task sequence test" -DeployPurpose Required -SendWakeUpPacket $True -UseMeteredNetwork $True -ScheduleEvent AsSoonAsPossible -RerunBehavior NeverRerunDeployedProgram -RunFromSoftwareCenter $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -AllowFallback $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowSharedContent $True -InternetOption $True
參數
-AlertDateTime
當您設定部署以建立成功部署的警示時,請使用此參數來指定 DateTime 物件。 當閾值低於這個日期之後的 PercentSuccess 時,Configuration Manager 會建立部署警示。
若要取得此物件,請使用 Get-Date 內建 Cmdlet。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-AlertDay
此參數已被取代。 使用 AlertDateTime。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-AlertTime
此參數已被取代。 使用 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 時,是否可以執行此工作順序。
如果您指定 Clients
,則 DeploymentOption 參數的預設值為 DownloadAllContentLocallyBeforeStartingTaskSequence
。
如果您指定 ClientsMediaAndPxe
、 MediaAndPxe
或 MediaAndPxeHidden
, DeploymentOption 參數的預設值為 DownloadContentLocallyWhenNeededByRunningTaskSequence
。
類型: | MakeAvailableToType |
別名: | MakeAvailableTo |
接受的值: | Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden |
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 |
接受萬用字元: | False |
-Comment
指定工作順序部署的選擇性批注。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentAvailableDateTime
指定此部署可用時的 DateTime 物件。 若要取得此物件,請使用 Get-Date 內建 Cmdlet。
使用 DeploymentExpireDateTime 來指定部署 到期時間,並使用 [排程 ] 指定部署指派或 期限。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentAvailableDay
此參數已被取代。 使用 DeploymentAvailableDateTime。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentAvailableTime
此參數已被取代。 使用 DeploymentAvailableDateTime。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentExpireDateTime
指定此部署到期時的DateTime 物件。 若要取得此物件,請使用 Get-Date 內建 Cmdlet。
使用 DeploymentAvailableDateTime 來指定部署 可用的時間,以及使用 排程 來指定部署指派或 期限。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentExpireDay
此參數已被取代。 使用 DeploymentExpireDateTime。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentExpireTime
此參數已被取代。 使用 DeploymentExpireDateTime。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentOption
指定用戶端如何與發佈點互動,以取得工作順序的內容。 並非所有選項都可在特定案例中使用。 如需詳細資訊,請 參閱部署工作順序 - 部署選項。
如果您指定 Clients
Availability 參數,則此參數的預設值為 DownloadAllContentLocallyBeforeStartingTaskSequence
。
如果您為 Availability 參數指定ClientsMediaAndPxe
、 MediaAndPxe
或 MediaAndPxeHidden
, 則此參數預設值為 DownloadContentLocallyWhenNeededByRunningTaskSequence
。
類型: | 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 |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
指定工作順序部署物件。 若要取得此物件,請使用 Get-CMTaskSequenceDeployment Cmdlet。
類型: | IResultObject |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-InternetOption
指出工作順序是否在透過因特網連線的用戶端上執行。
類型: | Boolean |
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 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 |
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 |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
IResultObject