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.