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
, MediaAndPxe
ou 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
, MediaAndPxe
ou 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