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 ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: Configurare una distribuzione per mostrare lo stato

Questo comando configura la distribuzione della sequenza di attività utilizzando il nome della sequenza di attività e il nome della raccolta. Imposta il commento e consente al client di visualizzare l'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 una distribuzione della 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 di pianificazione, utilizzare il cmdlet New-CMSchedule.

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

-AddScheduleEvent

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

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

-AlertDateTime

Specifica la data e l'ora dell'avviso.

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

-AllowFallback

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

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

-AllowSharedContent

Indica se consentire il contenuto condiviso.

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

-AllowUsersRunIndependently

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

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

-ClearSchedule

Aggiungere questo parametro per rimuovere tutte le pianificazioni dalla distribuzione.

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

-ClearScheduleEvent

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

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

-Collection

Specifica un oggetto insieme come destinazione della distribuzione.

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

-CollectionId

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

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

-CollectionName

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

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

-Comment

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

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

-CreateAlertOnFailure

Indica se creare un avviso in caso di errore.

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

-CreateAlertOnSuccess

Indica se creare un avviso per l'esito positivo.

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

-DeploymentAvailableDateTime

Specifica la data e l'ora disponibili per la distribuzione.

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

-DeploymentExpireDateTime

Specifica la data di scadenza della distribuzione.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 della sequenza di attività in esecuzione.

Type:DeploymentOptionType
Accepted values:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

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

-InputObject

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

Type:IResultObject
Aliases:Deployment, DeploymentSummary, TaskSequence, Advertisement
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-InternetOption

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

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

-MakeAvailableTo

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

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

-PassThru

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

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

-PercentFailure

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

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

-PercentSuccess

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

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

-PersistOnWriteFilterDevice

Indica se installare una sequenza di attività nella sovrimpressione temporanea e confermare le modifiche in un secondo momento oppure confermare le modifiche alla 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.

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

-RemoveSchedule

Specificare un oggetto token di pianificazione da rimuovere dalla distribuzione. Per creare un oggetto di pianificazione, utilizzare il cmdlet New-CMSchedule.

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

-RemoveScheduleEvent

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

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

-RerunBehavior

Specifica se la sequenza di attività verrà rieseguita in un computer se in precedenza è stata eseguita 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
Accept pipeline input:False
Accept wildcard characters: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, utilizzare il cmdlet New-CMSchedule.

Type:IResultObject[]
Position:Named
Default value:None
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
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 la riattivazione dei computer, configurare prima riattivazione LAN.

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

-ShowTaskSequenceProgress

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

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

-SoftwareInstallation

Indica se consentire l'installazione dell'applicazione, anche se l'installazione avviene al di fuori di una finestra di manutenzione.

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

-SystemRestart

Indica se consentire a un programma annunciato di riavviare il sistema, anche se il riavvio viene eseguito al di fuori di una finestra di manutenzione.

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

-TaskSequenceDeploymentId

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

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

-TaskSequenceName

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

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

-TaskSequencePackageId

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

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

-UseMeteredNetwork

Indica se consentire ai client su una connessione Internet a consumo di scaricare contenuto dopo la scadenza dell'installazione, con costi aggiuntivi.

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

-UseUtcForAvailableSchedule

Indica se i computer client utilizzano 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
Accept pipeline input:False
Accept wildcard characters:False

-UseUtcForExpireSchedule

Indica se i computer client utilizzano 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
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
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject