Start-CMTaskSequenceDeployment

Riferimento

Modulo:: ConfigurationManager

(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 .

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

-AlertDay

Questo parametro è deprecato. Usare AlertDateTime.

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

-AlertTime

Questo parametro è deprecato. Usare AlertDateTime.

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

-AllowFallback

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

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

-AllowSharedContent

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

Type:	Boolean
Aliases:	AllowUseRemoteDistributionPoint
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

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

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

-CollectionId

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

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

-CollectionName

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

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

-Comment

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

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-DeploymentAvailableDay

Questo parametro è deprecato. Usare DeploymentAvailableDateTime.

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

-DeploymentAvailableTime

Questo parametro è deprecato. Usare DeploymentAvailableDateTime.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-DeploymentExpireDay

Questo parametro è deprecato. Usare DeploymentExpireDateTime.

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

-DeploymentExpireTime

Questo parametro è deprecato. Usare DeploymentExpireDateTime.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-DeployPurpose

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

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

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

-InternetOption

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-RunFromSoftwareCenter

Consentire agli utenti di eseguire il programma indipendentemente dalle assegnazioni.

Type:	Boolean
Aliases:	AllowUsersRunIndependently
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

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

-ScheduleEvent

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

Type:	ScheduleEventType[]
Accepted values:	AsSoonAsPossible, LogOn, LogOff
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-ShowTaskSequenceProgress

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-TaskSequencePackageId

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

Type:	String
Aliases:	PackageId
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-WhatIf

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

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject