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.