New-CMTaskSequenceDeployment

Creare una distribuzione della sequenza di attività.

Sintassi

New-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Availability <MakeAvailableToType>]
   [-DeadlineDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-InputObject] <IResultObject>
   [-InternetOption <Boolean>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Availability <MakeAvailableToType>]
   [-DeadlineDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-InternetOption <Boolean>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-TaskSequencePackageId] <String>
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-CMTaskSequenceDeployment crea 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: Distribuire una sequenza di attività con molti parametri comuni

In questo esempio vengono eseguite le azioni seguenti:

  • Usare il cmdlet Get-CMTaskSequence per ottenere l'oggetto sequenza di attività da distribuire e salvarlo nella variabile $DeployTS
  • Definire la raccolta come destinazione della distribuzione nella variabile $DeployCollection
  • Definire l'ora disponibile per la distribuzione alle 20:00 del 25 novembre 2025 nella variabile $DeployAvailableTime
  • Definire l'ora di scadenza della distribuzione alle 20:00 del 25 gennaio 2026 nella variabile $DeployExpireTime
  • Definire la scadenza della distribuzione alle 20:00 del 25 dicembre 2025 nella variabile $ScheduleDateTime
  • Usare il cmdlet New-CMSchedule per creare un oggetto pianificazione per la scadenza con una pianificazione ricorrente giornaliera.
  • Distribuire la sequenza di attività
$DeployTS = Get-CMTaskSequence -TaskSequencePackageId 'PS104823'
$DeployCollection = 'PS11B7C4'
$DeployAvailableTime = [datetime]::ParseExact("20251125-200000", "yyyyMMdd-HHmmss", $null)
$DeployExpireTime = [datetime]::ParseExact("20260125-200000", "yyyyMMdd-HHmmss", $null)
$ScheduleDateTime = [datetime]::ParseExact("20251225-200000", "yyyyMMdd-HHmmss", $null)
$DeploySchedule = New-CMSchedule -DurationInterval Days -RecurInterval Days -RecurCount 1 -DurationCount 0 -Start $ScheduleDateTime
New-CMTaskSequenceDeployment -InputObject $DeployTS -DeployPurpose Required -AvailableDateTime $DeployAvailableTime -Availability Clients -RerunBehavior AlwaysRerunProgram -Schedule $DeploySchedule -CollectionId $DeployCollection -ShowTaskSequenceProgress $true -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -RunFromSoftwareCenter $true -DeadlineDateTime $DeployExpireTime

Parametri

-AlertDateTime

Se si abilita un avviso di distribuzione, usare questo parametro per specificare un'ora per l'avviso.

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.

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

-AvailableDateTime

Specificare quando questa distribuzione è disponibile.

Usare -DeadlineDateTime per specificare quando scade la distribuzione e -Schedule 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

-Collection

Specificare un oggetto raccolta come destinazione per la distribuzione della 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 un ID raccolta come destinazione 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

-CollectionName

Specificare un nome di raccolta come destinazione 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:True

-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:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeadlineDateTime

Usare questo parametro per specificare quando scade la distribuzione.

Usare -AvailableDateTime per specificare quando la distribuzione è disponibile e -Schedule per specificare l'assegnazione o la scadenza della distribuzione.

Tipo:DateTime
Alias:DeploymentExpireDateTime
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.

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

-DistributeCollectionName

Il sito distribuisce il contenuto ai gruppi di punti di distribuzione associati al nome della raccolta.

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

-DistributeContent

Aggiungere questo parametro per distribuire il contenuto della sequenza di attività quando si crea questa distribuzione. I client non possono installare la sequenza di attività fino a quando non si distribuisce il contenuto ai punti di distribuzione a cui i client possono accedere.

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

-DistributionPointGroupName

Il sito distribuisce il contenuto a questo gruppo di punti di distribuzione.

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

-DistributionPointName

Il sito distribuisce il contenuto a questo punto di distribuzione.

Tipo:String
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 sequenza di attività da distribuire. Per ottenere un oggetto sequenza di attività, usare il cmdlet Get-CMTaskSequence .

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

-InternetOption

Consentire l'esecuzione della sequenza di attività per i client su Internet.

Tipo:Boolean
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 la distribuzione è disponibile 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, TaskSequenceId
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:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject

Note

Assicurarsi di usare i parametri di pianificazione in modo appropriato:

  • -AvailableDateTime: specificare quando questa distribuzione è disponibile.

  • -DeadlineDateTime: specificare quando scade la distribuzione.

  • -Schedule: specificare l'assegnazione o la scadenza della distribuzione.