Partager via


Start-CMTaskSequenceDeployment

(Déconseillé) Démarrez un déploiement de séquence de tâches.

Syntaxe

Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InputObject] <IResultObject>
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-TaskSequencePackageId] <String>
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Importante

Cette applet de commande est déconseillée. Utilisez New-CMTaskSequenceDeployment à la place.

Utilisez cette applet de commande pour démarrer 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. Pour plus d’informations, consultez Déployer une séquence de tâches dans Configuration Manager.

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émarrer un déploiement de séquence de tâches avec les options par défaut

Cette commande démarre un déploiement de séquence de tâches en utilisant le nom du déploiement de séquence de tâches et le nom d’une collection.

Get-CMTaskSequence -Name "Upgrade Windows 10" | Start-CMTaskSequenceDeployment -CollectionName "Collection 01"

Exemple 2 : Démarrer un déploiement de séquence de tâches avec des options configurées

Cette commande démarre un déploiement de séquence de tâches avec plusieurs options configurées.

Start-CMTaskSequenceDeployment -TaskSequencePackageId "XYZ00003" -CollectionName "Collection 02" -Comment "Task sequence test" -DeployPurpose Required -SendWakeUpPacket $True -UseMeteredNetwork $True -ScheduleEvent AsSoonAsPossible -RerunBehavior NeverRerunDeployedProgram -RunFromSoftwareCenter $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -AllowFallback $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowSharedContent $True -InternetOption $True

Paramètres

-AlertDateTime

Lorsque vous configurez le déploiement pour créer une alerte en cas de déploiement réussi, utilisez ce paramètre pour spécifier un objet DateTime . Configuration Manager crée une alerte de déploiement lorsque le seuil est inférieur à percentSuccess après cette date.

Pour obtenir cet objet, utilisez l’applet de commande intégrée Get-Date .

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

-AlertDay

Ce paramètre est déconseillé. Utilisez AlertDateTime.

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

-AlertTime

Ce paramètre est déconseillé. Utilisez AlertDateTime.

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.

Si vous spécifiez Clients, la valeur par défaut du paramètre DeploymentOption est DownloadAllContentLocallyBeforeStartingTaskSequence. Si vous spécifiez ClientsMediaAndPxe, MediaAndPxeou MediaAndPxeHidden, la valeur par défaut du paramètre DeploymentOption est DownloadContentLocallyWhenNeededByRunningTaskSequence.

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

-Collection

Spécifiez un objet de collection sur lequel cette séquence de tâches est déployée. 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 l’ID de la collection sur laquelle cette séquence de tâches est déployée.

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 le nom de la collection sur laquelle cette séquence de tâches est déployée.

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

-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:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeploymentAvailableDateTime

Spécifiez un objet DateTime pour le moment où ce déploiement est disponible. Pour obtenir cet objet, utilisez l’applet de commande intégrée Get-Date .

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

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

-DeploymentAvailableDay

Ce paramètre est déconseillé. Utilisez DeploymentAvailableDateTime.

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

-DeploymentAvailableTime

Ce paramètre est déconseillé. Utilisez DeploymentAvailableDateTime.

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

-DeploymentExpireDateTime

Spécifiez un objet DateTime pour l’expiration de ce déploiement. Pour obtenir cet objet, utilisez l’applet de commande intégrée Get-Date .

Utilisez DeploymentAvailableDateTime 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
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeploymentExpireDay

Ce paramètre est déconseillé. Utilisez DeploymentExpireDateTime.

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

-DeploymentExpireTime

Ce paramètre est déconseillé. Utilisez DeploymentExpireDateTime.

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

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

Si vous spécifiez Clients pour le paramètre Availability , la valeur par défaut de ce paramètre est DownloadAllContentLocallyBeforeStartingTaskSequence. Si vous spécifiez ClientsMediaAndPxe, MediaAndPxeou MediaAndPxeHidden pour le paramètre Availability , la valeur par défaut de ce paramètre est DownloadContentLocallyWhenNeededByRunningTaskSequence.

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

-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écifiez un objet de déploiement de séquence de tâches. Pour obtenir cet objet, utilisez l’applet de commande Get-CMTaskSequenceDeployment .

Type:IResultObject
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

Indique si la séquence de tâches s’exécute sur les clients qui se connectent via 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

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

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

-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 le moment où 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
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:False
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