Condividi tramite


Set-CMTaskSequenceDeployment

Configurare una distribuzione della sequenza di attività.

Sintassi

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   -InputObject <IResultObject>
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequenceDeploymentId <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequenceName <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequencePackageId <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-CMTaskSequenceDeployment configura una distribuzione della sequenza di attività. Una distribuzione della sequenza di attività assegna una sequenza di attività a una raccolta di computer.

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: Configurare una distribuzione per mostrare lo stato di avanzamento

Questo comando configura la distribuzione della sequenza di attività usando il nome della sequenza di attività e il nome della raccolta. Imposta il commento e consente al client di visualizzare lo stato di avanzamento della sequenza di attività.

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Systems" -Comment "Task sequence test" -ShowTaskSequenceProgress $True

Esempio 2: Riconfigurare una distribuzione della sequenza di attività

Questo comando riconfigura la maggior parte delle impostazioni per la distribuzione di una sequenza di attività.

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Desktop and Server Clients" -Comment "Task sequence test" -SendWakeupPacket $True -UseMeteredNetwork $True -DeploymentExpireDateTime $(Get-Date) -ScheduleEvent LogOff -RerunBehavior NeverRerunDeployedProgram -AllowUsersRunIndependently $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -InternetOption $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowFallback $True -AllowSharedContent $True

Parametri

-AddSchedule

Specificare un oggetto token di pianificazione da aggiungere alla 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

-AddScheduleEvent

Specificare uno degli eventi di pianificazione accettati da aggiungere alla distribuzione.

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

-AlertDateTime

Specifica una data e ora di avviso.

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

-AllowFallback

Indica se consentire ai client di usare un percorso di origine di fallback per il contenuto.

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

-AllowSharedContent

Indica se consentire il contenuto condiviso.

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

-AllowUsersRunIndependently

Indica se consentire agli utenti di eseguire il programma in modo indipendente, indipendentemente dallo stato di assegnazione.

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

-ClearSchedule

Aggiungere questo parametro per rimuovere tutte le pianificazioni dalla distribuzione.

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

-ClearScheduleEvent

Aggiungere questo parametro per rimuovere tutti gli eventi di pianificazione dalla distribuzione.

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

-Collection

Specifica un oggetto raccolta come destinazione della distribuzione.

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

-CollectionId

Specifica l'ID di una raccolta come destinazione della distribuzione.

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

-CollectionName

Specifica un nome di una raccolta designata per ricevere una distribuzione della sequenza di attività.

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

-Comment

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

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

-CreateAlertOnFailure

Indica se creare un avviso in caso di errore.

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

-CreateAlertOnSuccess

Indica se creare un avviso in caso di esito positivo.

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

-DeploymentAvailableDateTime

Specifica l'ora di data disponibile per la distribuzione.

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

-DeploymentExpireDateTime

Specifica la data di scadenza della distribuzione.

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

-DeploymentOption

Specifica se i client scaricano tutto il contenuto prima di avviare la sequenza di attività o scaricano il contenuto in base alle esigenze dalla sequenza di attività in esecuzione.

Tipo:DeploymentOptionType
Valori accettati:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
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

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

Tipo:IResultObject
Alias:Deployment, DeploymentSummary, TaskSequence, Advertisement
Posizione:Named
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

-MakeAvailableTo

Specifica se rendere disponibile questa sequenza di attività per i client di Configuration Manager e se renderla disponibile quando si distribuisce un sistema operativo usando supporti di avvio, supporti pre-installati o PXE.

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

-PassThru

Restituisce l'oggetto di lavoro corrente. Per impostazione predefinita, questo cmdlet non genera alcun output.

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

-PercentFailure

Specifica una percentuale di soglia per la distribuzione della sequenza di attività non riuscita.

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

-PercentSuccess

Specifica una percentuale di soglia per la distribuzione corretta della sequenza di attività.

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

-PersistOnWriteFilterDevice

Indica se installare una sequenza di attività nella sovrimpressione temporanea e eseguire il commit delle modifiche in un secondo momento oppure eseguire il commit delle modifiche a una scadenza dell'installazione o a una finestra di manutenzione. Questa impostazione si applica ai dispositivi che eseguono un'edizione incorporata di Windows con un filtro di scrittura.

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

-RemoveSchedule

Specificare un oggetto token di pianificazione da rimuovere dalla 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

-RemoveScheduleEvent

Specificare uno degli eventi di pianificazione accettati da rimuovere dalla distribuzione.

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

-RerunBehavior

Specifica se la sequenza di attività verrà 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

-Schedule

Specifica una matrice di oggetti CMSchedule . Un oggetto CMSchedule definisce la pianificazione di assegnazione obbligatoria per una distribuzione. Per creare un oggetto CMSchedule , 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

Indica se consentire l'installazione dell'applicazione, anche se l'installazione viene eseguita all'esterno di una finestra di manutenzione.

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

-SystemRestart

Indica se consentire a un programma annunciato di riavviare il sistema, anche se il riavvio si verifica all'esterno di una finestra di manutenzione.

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

-TaskSequenceDeploymentId

Specifica un ID per la distribuzione di una sequenza di attività da configurare.

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

-TaskSequenceName

Specifica un nome per la sequenza di attività da distribuire.

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

-TaskSequencePackageId

Specifica un ID per una sequenza di attività da distribuire.

Tipo:String
Posizione:Named
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