共用方式為


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。 如果您指定 ClientsMediaAndPxeMediaAndPxeMediaAndPxeHiddenDeploymentOption 參數的預設值為 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

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

如果您指定 ClientsAvailability 參數,則此參數的預設值為 DownloadAllContentLocallyBeforeStartingTaskSequence。 如果您為 Availability 參數指定ClientsMediaAndPxeMediaAndPxeMediaAndPxeHidden , 則此參數預設值為 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