Start-CMTaskSequenceDeployment

(已淘汰) 啟動工作順序部署。

Syntax

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 物件。 Configuration Manager在此日期之後,當閾值低於PercentSuccess時,就會建立部署警示。

若要取得此物件,請使用 Get-Date 內建 Cmdlet。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlertDay

此參數已被取代。 使用 AlertDateTime

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlertTime

此參數已被取代。 使用 AlertDateTime

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowFallback

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowSharedContent

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

Type:Boolean
Aliases:AllowUseRemoteDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Availability

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

如果您指定 Clients ,則 DeploymentOption 參數的預設值為 DownloadAllContentLocallyBeforeStartingTaskSequence 。 如果您指定 ClientsMediaAndPxeMediaAndPxeMediaAndPxeHiddenDeploymentOption 參數的預設值為 DownloadContentLocallyWhenNeededByRunningTaskSequence

Type:MakeAvailableToType
Aliases:MakeAvailableTo
Accepted values:Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Collection

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

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CollectionId

指定要部署此工作順序之集合的識別碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Comment

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentAvailableDateTime

指定此部署可用時的DateTime物件。 若要取得此物件,請使用 Get-Date 內建 Cmdlet。

使用 DeploymentExpireDateTime 指定部署 到期時間,並使用 [排程 ] 指定部署指派或 期限

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentAvailableDay

此參數已被取代。 使用 DeploymentAvailableDateTime

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentAvailableTime

此參數已被取代。 使用 DeploymentAvailableDateTime

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentExpireDateTime

指定此部署到期時的DateTime物件。 若要取得此物件,請使用 Get-Date 內建 Cmdlet。

使用 DeploymentAvailableDateTime 來指定部署 可用的時間,以及使用 排程 來指定部署指派或 期限

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentExpireDay

此參數已被取代。 使用 DeploymentExpireDateTime

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentExpireTime

此參數已被取代。 使用 DeploymentExpireDateTime

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentOption

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

如果您指定 ClientsAvailability 參數,則此參數的預設值為 DownloadAllContentLocallyBeforeStartingTaskSequence 。 如果您為Availability 參數指定ClientsMediaAndPxeMediaAndPxeMediaAndPxeHidden ,則此參數的預設值為 DownloadContentLocallyWhenNeededByRunningTaskSequence

Type:DeploymentOptionType
Accepted values:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployPurpose

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

Type:DeployPurposeType
Accepted values:Available, Required
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

此參數會處理萬用字元,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:IResultObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InternetOption

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

新增此參數以傳回 物件,代表您正在使用的專案。 根據預設,此 Cmdlet 可能不會產生任何輸出。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PercentFailure

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PercentSuccess

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PersistOnWriteFilterDevice

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

  • $true:在期限或維護期間認可變更。 需要重新開機。
  • $false:在重迭上套用內容,稍後再認可。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RerunBehavior

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

Type:RerunBehaviorType
Accepted values:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunFromSoftwareCenter

允許使用者獨立于指派執行程式。

Type:Boolean
Aliases:AllowUsersRunIndependently
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

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

使用 AvailableDateTime 指定部署 可用的時間,以及使用 DeadlineDateTime 指定部署 到期時間

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

Type:IResultObject[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleEvent

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

Type:ScheduleEventType[]
Accepted values:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SendWakeupPacket

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowTaskSequenceProgress

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareInstallation

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SystemRestart

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TaskSequencePackageId

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

Type:String
Aliases:PackageId
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UseMeteredNetwork

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseUtcForAvailableSchedule

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseUtcForExpireSchedule

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject