Partager via


New-CMTaskSequenceDeployment

Créer un déploiement de séquence de tâches.

Syntaxe

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>]

Description

L’applet de commande New-CMTaskSequenceDeployment crée un déploiement de séquence de tâches. Un déploiement de séquence de tâches affecte une séquence de tâches à un regroupement d’ordinateurs.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Déployer une séquence de tâches avec de nombreux paramètres communs

Cet exemple effectue les actions suivantes :

  • Utilisez l’applet de commande Get-CMTaskSequence pour obtenir l’objet de séquence de tâches à déployer et l’enregistre dans la variable $DeployTS
  • Définissez la collection comme cible du déploiement dans la variable $DeployCollection
  • Définissez l’heure de déploiement disponible à 20h00 le 25 novembre 2025, dans la variable $DeployAvailableTime
  • Définissez l’heure d’expiration du déploiement à 20h00 le 25 janvier 2026, dans la variable $DeployExpireTime
  • Définissez l’échéance de déploiement à 20h00 le 25 décembre 2025, dans la variable $ScheduleDateTime
  • Utilisez l’applet de commande New-CMSchedule pour créer un objet de planification pour l’échéance avec une planification périodique quotidienne.
  • Déployer la séquence de tâches
$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

Paramètres

-AlertDateTime

Si vous activez une alerte de déploiement, utilisez ce paramètre pour spécifier une heure pour l’alerte.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowFallback

Autoriser les clients à utiliser des points de distribution du groupe de limites de site par défaut.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowSharedContent

Autoriser les clients à utiliser des points de distribution à partir d’un groupe de limites voisin.

Type:Boolean
Alias:AllowUseRemoteDistributionPoint
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Availability

Spécifiez s’il faut rendre cette séquence de tâches disponible pour les clients Configuration Manager et si elle est disponible pour s’exécuter lorsque vous déployez un système d’exploitation à l’aide d’un média de démarrage, d’un média préparé ou de PXE.

Type:MakeAvailableToType
Alias:MakeAvailableTo
Valeurs acceptées:Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AvailableDateTime

Spécifiez quand ce déploiement est disponible.

Utilisez -DeadlineDateTime pour spécifier le moment où le déploiement expire et -Schedule pour spécifier l’affectation du déploiement, ou échéance.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Collection

Spécifiez un objet de collection comme cible pour ce déploiement de séquence de tâches. Pour obtenir cet objet, utilisez l’applet de commande Get-CMCollection .

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CollectionId

Spécifiez un ID de collection comme cible pour ce déploiement de séquence de tâches.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CollectionName

Spécifiez un nom de collection comme cible pour ce déploiement de séquence de tâches.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Comment

Spécifiez un commentaire facultatif pour le déploiement de séquence de tâches.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeadlineDateTime

Utilisez ce paramètre pour spécifier quand le déploiement expire.

Utilisez -AvailableDateTime pour spécifier le moment où le déploiement est disponible et -Schedule pour spécifier l’affectation ou l’échéance du déploiement.

Type:DateTime
Alias:DeploymentExpireDateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeploymentOption

Spécifiez la façon dont les clients interagissent avec les points de distribution pour obtenir le contenu de la séquence de tâches. Toutes les options ne sont pas disponibles dans des scénarios spécifiques. Pour plus d’informations, consultez Déployer une séquence de tâches - Options de déploiement.

Type:DeploymentOptionType
Valeurs acceptées:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeployPurpose

Spécifiez si ce déploiement est disponible pour l’installation des utilisateurs ou s’il doit être installé à l’échéance.

Type:DeployPurposeType
Valeurs acceptées:Available, Required
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DistributeCollectionName

Le site distribue le contenu aux groupes de points de distribution associés à ce nom de collection.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DistributeContent

Ajoutez ce paramètre pour distribuer le contenu de la séquence de tâches lorsque vous créez ce déploiement. Les clients ne peuvent pas installer la séquence de tâches tant que vous n’avez pas distribué le contenu aux points de distribution auxquels les clients peuvent accéder.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DistributionPointGroupName

Le site distribue le contenu à ce groupe de points de distribution.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DistributionPointName

Le site distribue le contenu à ce point de distribution.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie un objet de séquence de tâches à déployer. Pour obtenir un objet de séquence de tâches, utilisez l’applet de commande Get-CMTaskSequence .

Type:IResultObject
Alias:TaskSequence
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InternetOption

Autoriser l’exécution de la séquence de tâches pour les clients sur Internet.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PercentFailure

Si vous créez une alerte pour les déploiements ayant échoué, le site génère une alerte lorsque le pourcentage de déploiements ayant échoué est supérieur à ce nombre.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PercentSuccess

Si vous créez une alerte pour des déploiements réussis, le site génère une alerte lorsque le pourcentage de déploiements réussis est inférieur à ce nombre.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PersistOnWriteFilterDevice

Configurez la façon dont le client gère le filtre d’écriture sur les appareils Windows Embedded.

  • $true: Valider les modifications à l’échéance ou pendant une fenêtre de maintenance. Un redémarrage est nécessaire.
  • $false: appliquez le contenu sur la superposition et validez ultérieurement.
Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RerunBehavior

Spécifiez si la séquence de tâches s’exécute à nouveau sur un ordinateur si elle s’exécutait avant l’heure obligatoire planifiée. Par défaut, la séquence de tâches s’exécute toujours à nouveau.

Type:RerunBehaviorType
Valeurs acceptées:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunFromSoftwareCenter

Autoriser les utilisateurs à exécuter le programme indépendamment des affectations.

Type:Boolean
Alias:AllowUsersRunIndependently
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Schedule

Utilisez ce paramètre pour spécifier l’affectation ou l’échéance du déploiement.

Utilisez -AvailableDateTime pour spécifier quand le déploiement est disponible et -DeadlineDateTime pour spécifier le moment où le déploiement expire.

Spécifiez un tableau d’objets de planification. Un objet schedule définit la planification d’affectation obligatoire pour un déploiement. Pour créer un objet de planification, utilisez l’applet de commande New-CMSchedule .

Type:IResultObject[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScheduleEvent

Spécifie un tableau d’événements qui déterminent quand le déploiement de la séquence de tâches s’exécute.

Type:ScheduleEventType[]
Valeurs acceptées:AsSoonAsPossible, LogOn, LogOff
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SendWakeupPacket

Indique s’il faut envoyer un paquet de mise en éveil aux ordinateurs avant le début du déploiement. Si cette valeur est $True, Configuration Manager met un ordinateur en veille. Si cette valeur est $False, elle ne met pas les ordinateurs en veille. Pour que les ordinateurs sortent, commencez par configurer Wake On LAN.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ShowTaskSequenceProgress

Indique s’il faut afficher une boîte de dialogue de processus pour une séquence de tâches.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SoftwareInstallation

Une fois l’échéance d’installation atteinte, définissez ce paramètre sur $true pour permettre à la séquence de tâches de s’installer en dehors de la fenêtre de maintenance.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SystemRestart

Lorsque l’échéance d’installation est atteinte, définissez ce paramètre sur $true pour autoriser le redémarrage du système si nécessaire en dehors de la fenêtre de maintenance.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TaskSequencePackageId

Spécifiez l’ID de la séquence de tâches à déployer.

Type:String
Alias:PackageId, TaskSequenceId
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UseMeteredNetwork

Indique s’il faut autoriser les clients sur une connexion Internet limitée à télécharger du contenu après l’échéance d’installation, ce qui peut entraîner des coûts supplémentaires.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UseUtcForAvailableSchedule

Indique si les ordinateurs clients utilisent l’heure UTC pour déterminer la disponibilité d’un programme. L’heure UTC rend la séquence de tâches disponible en même temps pour tous les ordinateurs.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UseUtcForExpireSchedule

Indique si les ordinateurs clients utilisent l’heure UTC pour déterminer l’expiration d’un programme. L’heure UTC rend la séquence de tâches disponible en même temps pour tous les ordinateurs.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject

Notes

Veillez à utiliser les paramètres de planification de manière appropriée :

  • -AvailableDateTime : spécifiez quand ce déploiement est disponible.

  • -DeadlineDateTime : spécifiez le moment où le déploiement expire.

  • -Schedule : spécifiez l’affectation ou l’échéance du déploiement.