Condividi tramite


Start-CMTaskSequenceDeployment

(Deprecato) Avviare una distribuzione della sequenza di attività.

Sintassi

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>]

Descrizione

Importante

Questo cmdlet è deprecato. Usare invece New-CMTaskSequenceDeployment .

Usare questo cmdlet per avviare una distribuzione della sequenza di attività. Una distribuzione della sequenza di attività assegna una sequenza di attività a una raccolta di computer. Per altre informazioni, vedere Distribuire una sequenza di attività in Configuration Manager.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Avviare una distribuzione della sequenza di attività con le opzioni predefinite

Questo comando avvia la distribuzione di una sequenza di attività usando il nome della distribuzione della sequenza di attività e il nome di una raccolta.

Get-CMTaskSequence -Name "Upgrade Windows 10" | Start-CMTaskSequenceDeployment -CollectionName "Collection 01"

Esempio 2: Avviare una distribuzione della sequenza di attività con le opzioni configurate

Questo comando avvia una distribuzione della sequenza di attività con diverse opzioni configurate.

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

Parametri

-AlertDateTime

Quando si configura la distribuzione per creare un avviso per la distribuzione corretta, usare questo parametro per specificare un oggetto DateTime . Configuration Manager crea un avviso di distribuzione quando la soglia è inferiore a PercentSuccess dopo questa data.

Per ottenere questo oggetto, usare il cmdlet predefinito Get-Date .

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AlertDay

Questo parametro è deprecato. Usare AlertDateTime.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AlertTime

Questo parametro è deprecato. Usare AlertDateTime.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowFallback

Consentire ai client di usare i punti di distribuzione dal gruppo di limiti del sito predefinito.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowSharedContent

Consentire ai client di usare i punti di distribuzione da un gruppo di limiti adiacente.

Tipo:Boolean
Alias:AllowUseRemoteDistributionPoint
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Availability

Specificare se rendere questa sequenza di attività disponibile per Configuration Manager client e se è disponibile per l'esecuzione quando si distribuisce un sistema operativo usando supporti di avvio, supporti pre-installati o PXE.

Se si specifica Clients, il valore predefinito per il parametro DeploymentOption è DownloadAllContentLocallyBeforeStartingTaskSequence. Se si specifica ClientsMediaAndPxe, MediaAndPxeo MediaAndPxeHidden, il valore predefinito per il parametro DeploymentOption è DownloadContentLocallyWhenNeededByRunningTaskSequence.

Tipo:MakeAvailableToType
Alias:MakeAvailableTo
Valori accettati:Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Collection

Specificare un oggetto raccolta in cui viene distribuita questa sequenza di attività. Per ottenere questo oggetto, usare il cmdlet Get-CMCollection .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionId

Specificare l'ID della raccolta in cui viene distribuita questa sequenza di attività.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

Specificare il nome della raccolta in cui viene distribuita questa sequenza di attività.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Comment

Specificare un commento facoltativo per la distribuzione della sequenza di attività.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentAvailableDateTime

Specificare un oggetto DateTime per quando questa distribuzione è disponibile. Per ottenere questo oggetto, usare il cmdlet predefinito Get-Date .

Usare DeploymentExpireDateTime per specificare quando scade la distribuzione e Pianificare per specificare l'assegnazione o la scadenza della distribuzione.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentAvailableDay

Questo parametro è deprecato. Usare DeploymentAvailableDateTime.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentAvailableTime

Questo parametro è deprecato. Usare DeploymentAvailableDateTime.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentExpireDateTime

Specificare un oggetto DateTime per quando questa distribuzione scade. Per ottenere questo oggetto, usare il cmdlet predefinito Get-Date .

Usare DeploymentAvailableDateTime per specificare quando è disponibile la distribuzione e Pianificare per specificare l'assegnazione o la scadenza della distribuzione.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentExpireDay

Questo parametro è deprecato. Usare DeploymentExpireDateTime.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentExpireTime

Questo parametro è deprecato. Usare DeploymentExpireDateTime.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentOption

Specificare il modo in cui i client interagiscono con i punti di distribuzione per ottenere contenuto per la sequenza di attività. Non tutte le opzioni sono disponibili in scenari specifici. Per altre informazioni, vedere Distribuire una sequenza di attività - Opzioni di distribuzione.

Se si specifica Clients per il parametro Availability , il valore predefinito per questo parametro è DownloadAllContentLocallyBeforeStartingTaskSequence. Se si specifica ClientsMediaAndPxe, MediaAndPxeo MediaAndPxeHidden per il parametro Availability , il valore predefinito per questo parametro è DownloadContentLocallyWhenNeededByRunningTaskSequence.

Tipo:DeploymentOptionType
Valori accettati:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeployPurpose

Specificare se questa distribuzione è disponibile per l'installazione da parte degli utenti o se è necessaria per l'installazione alla scadenza.

Tipo:DeployPurposeType
Valori accettati:Available, Required
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto di distribuzione della sequenza di attività. Per ottenere questo oggetto, usare il cmdlet Get-CMTaskSequenceDeployment .

Tipo:IResultObject
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InternetOption

Indica se la sequenza di attività viene eseguita nei client che si connettono a Internet.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PercentFailure

Se si crea un avviso per le distribuzioni non riuscite, il sito genera un avviso quando la percentuale di distribuzioni non riuscite è superiore a questo numero.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PercentSuccess

Se si crea un avviso per le distribuzioni riuscite, il sito genera un avviso quando la percentuale di distribuzioni riuscite è inferiore a questo numero.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PersistOnWriteFilterDevice

Configurare il modo in cui il client gestisce il filtro di scrittura nei dispositivi Windows Embedded.

  • $true: eseguire il commit delle modifiche alla scadenza o durante una finestra di manutenzione. È necessario un riavvio.
  • $false: applicare il contenuto alla sovrimpressione e eseguirne il commit in un secondo momento.
Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RerunBehavior

Specificare se la sequenza di attività viene rieseguita in un computer se è stata eseguita in precedenza prima dell'ora obbligatoria pianificata. Per impostazione predefinita, la sequenza di attività viene sempre rieseguita.

Tipo:RerunBehaviorType
Valori accettati:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunFromSoftwareCenter

Consentire agli utenti di eseguire il programma indipendentemente dalle assegnazioni.

Tipo:Boolean
Alias:AllowUsersRunIndependently
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Schedule

Usare questo parametro per specificare l'assegnazione o la scadenza della distribuzione.

Utilizzare AvailableDateTime per specificare quando è disponibile la distribuzione e DeadlineDateTime per specificare quando scade la distribuzione.

Specificare una matrice di oggetti di pianificazione. Un oggetto pianificazione definisce la pianificazione di assegnazione obbligatoria per una distribuzione. Per creare un oggetto pianificazione, usare il cmdlet New-CMSchedule .

Tipo:IResultObject[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ScheduleEvent

Specifica una matrice di eventi che determinano quando viene eseguita la distribuzione della sequenza di attività.

Tipo:ScheduleEventType[]
Valori accettati:AsSoonAsPossible, LogOn, LogOff
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SendWakeupPacket

Indica se inviare un pacchetto di riattivazione ai computer prima dell'inizio della distribuzione. Se questo valore è $True, Configuration Manager riattiva un computer dalla sospensione. Se questo valore è $False, non riattiva i computer dalla sospensione. Per consentire la riattivazione dei computer, configurare prima la riattivazione LAN.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ShowTaskSequenceProgress

Indica se visualizzare una finestra di dialogo di processo per una sequenza di attività.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SoftwareInstallation

Quando viene raggiunta la scadenza dell'installazione, impostare questo parametro $true su per consentire l'installazione della sequenza di attività all'esterno della finestra di manutenzione.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SystemRestart

Quando viene raggiunta la scadenza dell'installazione, impostare questo parametro su per $true consentire il riavvio del sistema, se necessario, all'esterno della finestra di manutenzione.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TaskSequencePackageId

Specificare l'ID della sequenza di attività da distribuire.

Tipo:String
Alias:PackageId
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseMeteredNetwork

Indica se consentire ai client in una connessione Internet a consumo di scaricare il contenuto dopo la scadenza dell'installazione, il che potrebbe comportare costi aggiuntivi.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseUtcForAvailableSchedule

Indica se i computer client usano l'ora UTC per determinare la disponibilità di un programma. L'ora UTC rende la sequenza di attività disponibile contemporaneamente per tutti i computer.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseUtcForExpireSchedule

Indica se i computer client usano l'ora UTC per determinare la scadenza di un programma. L'ora UTC rende la sequenza di attività disponibile contemporaneamente per tutti i computer.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject