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 i cmdlet di Configuration Manager dall'unità del sito di 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 disponibile questa sequenza di attività per i client di Configuration Manager 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
, MediaAndPxe
o 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
, MediaAndPxe
o 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.
Usare AvailableDateTime per specificare quando è disponibile la distribuzione e DeadlineDateTime per specificare la scadenza della 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