Schtasks.exe

Permet à un administrateur de créer, supprimer, interroger, modifier, exécuter et mettre fin à des tâches planifiées sur un ordinateur local ou distant. L’exécution de Schtasks.exe sans arguments affiche l’état et l’heure d’exécution suivante pour chaque tâche inscrite.

Pour plus d’informations sur le planificateur de tâches, consultez cette introduction : Planificateur de tâches pour les développeurs.

Création d’une tâche

La syntaxe suivante est utilisée pour créer une tâche sur l’ordinateur local ou distant.

schtasks /Create 
[/S system [/U username [/P [password]]]]
[/RU username [/RP [password]] /SC schedule [/MO modifier] [/D day]
[/M months] [/I idletime] /TN taskname /TR taskrun [/ST starttime]
[/RI interval] [ {/ET endtime | /DU duration} [/K] 
[/XML xmlfile] [/V1]] [/SD startdate] [/ED enddate] [/IT] [/Z] [/F]

Paramètres

Système /S

Valeur qui spécifie l’ordinateur distant auquel se connecter. S’il est omis, le paramètre système est défini par défaut sur l’ordinateur local.

Nom d’utilisateur /U

Valeur qui spécifie le contexte utilisateur sous lequel Schtasks.exe doivent s’exécuter.

/P[password]

Valeur qui spécifie le mot de passe d’un contexte utilisateur donné. En cas d’omission, Schtasks.exe invite l’utilisateur à entrer une entrée.

Nom d’utilisateur /RU

Valeur qui spécifie le contexte utilisateur sous lequel la tâche s’exécute. Pour le compte système, les valeurs valides sont « », « NT AUTHORITY\SYSTEM » ou « SYSTEM ». Pour les tâches du Planificateur de tâches 2.0, « NT AUTHORITY\LOCALSERVICE » et « NT AUTHORITY\NETWORKSERVICE » sont également des valeurs valides.

/RP[password]

Valeur qui spécifie le mot de passe de l’utilisateur spécifié avec le paramètre /RU. Pour demander le mot de passe, la valeur doit être « * » ou aucune valeur. Ce mot de passe est ignoré pour le compte système. Ce paramètre doit être combiné avec /RU ou le commutateur /XML.

Planification /SC

Valeur qui spécifie la fréquence de planification. Les valeurs valides sont : MINUTE, HOURLY, DAILY, WEEKLY, MONTHLY, ONCE, ONSTART, ONLOGON, ONIDLE et ONEVENT.

Modificateur /MO

Valeur qui affine le type de planification pour permettre un contrôle plus précis sur la périodicité de la planification. Les valeurs autorisées sont :

• MINUTE: 1 - 1439 minutes.
• TOUTES LES HEURES : 1 à 23 heures.
• TOUS LES JOURS : 1 à 365 jours.
• HEBDOMADAIRE : semaines 1 à 52.
• ONCE : Aucun modificateur.
• ONSTART : aucun modificateur.
• ONLOGON : aucun modificateur.
• ONIDLE : aucun modificateur.
• MENSUEL : 1 à 12, ou FIRST, SECOND, THIRD, FOURTH, LAST et LASTDAY.
• ONEVENT : chaîne de requête d’événement XPath.

/Ddays

Valeur qui spécifie le jour de la semaine pour exécuter la tâche. Les valeurs valides sont : MON, TUE, WED, THU, FRI, SAT, SUN et pour les planifications MENSUELLEs de 1 à 31 (jours du mois). Le caractère générique (*) spécifie tous les jours.

/Mmois

Valeur qui spécifie les mois de l’année. La valeur par défaut est le premier jour du mois. Les valeurs valides sont : JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV et DEC. Le caractère générique (*) spécifie tous les mois.

/Iidletime

Valeur qui spécifie le temps d’inactivité à attendre avant d’exécuter une tâche ONIDLE planifiée. La plage valide est comprise entre 1 et 999 minutes.

/TNtaskname

Valeur qui spécifie un nom qui identifie de manière unique la tâche planifiée.

/TRtaskrun

Valeur qui spécifie le chemin d’accès et le nom de fichier de la tâche à exécuter à l’heure planifiée. Par exemple : C:\Windows\System32\calc.exe.

/STstarttime

Valeur qui spécifie l’heure de début de l’exécution de la tâche. Le format d’heure est HH:mm (24 heures). Par exemple, 14:30 spécifie 14:30PM. La valeur par défaut est l’heure actuelle où /ST n’est pas spécifié. Cette option est requise avec l’argument /SC ONCE.

Intervalle /RI

Valeur qui spécifie l’intervalle de répétition en minutes. Cela ne s’applique pas aux types de planification suivants : MINUTE, HOURLY, ONSTART, ONLOGON, ONIDLE et ONEVENT. La plage valide est comprise entre 1 et 599940 minutes. Si les paramètres /ET ou /DU sont spécifiés, la valeur par défaut est de 10 minutes.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/ETendtime

Valeur qui spécifie l’heure de fin d’exécution de la tâche. Le format d’heure est HH:mm (24 heures). Par exemple, 14:50 spécifie 14:50PM. Cela ne s’applique pas aux types de planification suivants : ONSTART, ONLOGON, ONIDLE et ONEVENT.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/DUduration

Valeur qui spécifie la durée d’exécution de la tâche. Le format d’heure est HH:mm (24 heures). Par exemple, 14:50 spécifie 14:50PM. Cela ne s’applique pas avec /ET et pour les types de planification suivants : ONSTART, ONLOGON, ONIDLE et ONEVENT. Pour les tâches /V1 (tâches du Planificateur de tâches 1.0), si /RI est spécifié, la durée par défaut est d’une heure.

Windows XP : Cette option n’est pas disponible.

/K

Valeur qui met fin à la tâche à l’heure de fin ou à l’heure de la durée. Cela ne s’applique pas aux types de planification suivants : ONSTART, ONLOGON, ONIDLE et ONEVENT. /ET ou /DU doit être spécifié.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/SDstartdate

Valeur qui spécifie la première date à laquelle exécuter la tâche. Le format est mm/jj/aaaa. Cette valeur est définie par défaut sur la date actuelle. Cela ne s’applique pas aux types de planification suivants : ONCE, ONSTART, ONLOGON, ONIDLE et ONEVENT.

/EDenddate

Valeur qui spécifie la date de la dernière exécution de la tâche. Le format est mm/jj/aaaa. Cela ne s’applique pas aux types de planification suivants : ONCE, ONSTART, ONLOGON, ONIDLE et ONEVENT.

/ECChannelName

Valeur qui spécifie le canal d’événements pour les déclencheurs ONEVENT.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/IL

Valeur qui permet à la tâche de s’exécuter de manière interactive uniquement si l’utilisateur /RU est actuellement connecté au moment de l’exécution de la tâche. La tâche s’exécute uniquement si l’utilisateur est connecté.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/NP

Valeur qui indique qu’aucun mot de passe n’est stocké. La tâche ne s’exécute pas de manière interactive en tant qu’utilisateur donné. Seules les ressources locales sont disponibles.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/Z

Valeur qui marque la tâche à supprimer après son exécution finale.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/XMLxmlfile

Valeur qui crée une tâche à partir d’un fichier XML. Ce paramètre peut être combiné avec les commutateurs /RU et /RP, ou avec le commutateur /RP seul lorsque le xml de tâche contient déjà le principal.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/V1

Valeur qui crée une tâche visible pour les plateformes Windows 2000, Windows Server 2003 et Windows XP.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/F

Valeur qui crée avec force la tâche et supprime les avertissements si la tâche spécifiée existe déjà.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/RLlevel

Valeur qui définit le niveau d’exécution de la tâche. Les valeurs valides sont LIMITED et HIGHEST. La valeur par défaut est LIMITED.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/DELAYdelaytime

Valeur qui spécifie le temps d’attente pour retarder la tâche après le déclenchement du déclencheur. Le format d’heure est mmmm:ss. Cette option est valide uniquement pour les types de planification ONSTART, ONLOGON et ONEVENT.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/?

Valeur qui affiche le message d’aide pour Schtasks.exe.

Remarques

Lorsque vous créez une tâche sur un ordinateur distant s’exécutant sur le système d’exploitation Windows XP, Windows Server 2003 ou Windows 2000, utilisez le commutateur /V1.

Vous ne pouvez pas créer une tâche non interactive remote Task Scheduler 1.0 (créez une tâche en n’utilisant pas le commutateur /IT et en utilisant le commutateur /V1) si l’exception de pare-feu Partage de fichiers et d’imprimantes est activée sur l’ordinateur distant et l’exception de pare-feu Gestion des tâches planifiées à distance désactivée.

Suppression d’une tâche

La syntaxe suivante est utilisée pour supprimer une ou plusieurs tâches planifiées.

schtasks /Delete 
[/S system [/U username [/P [password]]]]
[/TN taskname] [/F]

Paramètres

Système /S

Valeur qui spécifie l’ordinateur distant auquel se connecter. S’il est omis, le paramètre système est défini par défaut sur l’ordinateur local.

Nom d’utilisateur /U

Valeur qui spécifie le contexte utilisateur sous lequel Schtasks.exe doivent s’exécuter.

/P[password]

Valeur qui spécifie le mot de passe pour le contexte utilisateur donné. En cas d’omission, Schtasks.exe invite l’utilisateur à entrer une entrée.

/TNtaskname

Valeur qui spécifie le nom de la tâche planifiée à supprimer. Le caractère générique (*) peut être utilisé pour supprimer toutes les tâches.

/F

Valeur qui supprime de force la tâche et supprime les avertissements si la tâche spécifiée est en cours d’exécution.

/?

Valeur qui affiche l’aide pour Schtasks.exe.

Exécution d’une tâche

La syntaxe suivante est utilisée pour exécuter immédiatement une tâche planifiée.

schtasks /Run 
[/S system [/U username [/P [password]]]]
/TN taskname

Paramètres

Système /S

Valeur qui spécifie l’ordinateur distant auquel se connecter. S’il est omis, le paramètre système est défini par défaut sur l’ordinateur local.

Nom d’utilisateur /U

Valeur qui spécifie le contexte utilisateur sous lequel Schtasks.exe doivent s’exécuter.

/P[password]

Valeur qui spécifie le mot de passe pour le contexte utilisateur donné. En cas d’omission, Schtasks.exe invite l’utilisateur à entrer une entrée.

/TNtaskname

Valeur qui spécifie le nom de la tâche planifiée à exécuter.

/?

Valeur qui affiche l’aide pour Schtasks.exe.

Fin d’une tâche en cours d’exécution

La syntaxe suivante est utilisée pour arrêter une tâche planifiée en cours d’exécution.

schtasks /End 
[/S system [/U username [/P [password]]]]
/TN taskname

Paramètres

Système /S

Valeur qui spécifie l’ordinateur distant auquel se connecter. S’il est omis, le paramètre système est défini par défaut sur l’ordinateur local.

Nom d’utilisateur /U

Valeur qui spécifie le contexte utilisateur sous lequel Schtasks.exe doivent s’exécuter.

/P[password]

Valeur qui spécifie le mot de passe pour le contexte utilisateur donné. En cas d’omission, Schtasks.exe invite l’utilisateur à entrer une entrée.

/TNtaskname

Valeur qui spécifie le nom de la tâche planifiée à arrêter.

/?

Valeur qui affiche l’aide pour Schtasks.exe.

Interrogation des informations sur les tâches

La syntaxe suivante permet d’afficher les tâches planifiées à partir de l’ordinateur local ou distant.

schtasks /Query 
[/S system [/U username [/P [password]]]]
[/FO format | /XML] [/NH] [/V] [/TN taskname] [/?]

Paramètres

Système /S

Valeur qui spécifie l’ordinateur distant auquel se connecter. S’il est omis, le paramètre système est défini par défaut sur l’ordinateur local.

Nom d’utilisateur /U

Valeur qui spécifie le contexte utilisateur sous lequel Schtasks.exe doivent s’exécuter.

/P[password]

Valeur qui spécifie le mot de passe pour le contexte utilisateur donné. En cas d’omission, Schtasks.exe invite l’utilisateur à entrer une entrée.

Format /FO

Valeur qui spécifie le format de sortie. Les valeurs valides sont TABLE, LIST et CSV.

/NH

Valeur qui spécifie que l’en-tête de colonne ne doit pas être affiché dans la sortie. Cela est valide uniquement pour les formats TABLE et CSV.

/C

Valeur qui affiche une sortie de tâche détaillée.

Notes

Si une tâche a été planifiée pour s’exécuter une seule fois, les informations de planification affichées sont « Les données de planification ne sont pas disponibles dans ce format ».

/TNtaskname

Valeur qui spécifie le nom de la tâche pour laquelle récupérer les informations. Si aucun nom de tâche n’est spécifié, les informations relatives à toutes les tâches s’affichent.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/XML

Valeur utilisée pour afficher les définitions de tâche au format XML.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/?

Valeur utilisée pour afficher l’aide pour Schtasks.exe.

Modification d’une tâche

La syntaxe suivante permet de modifier l’exécution du programme ou de modifier le compte d’utilisateur et le mot de passe utilisés par une tâche planifiée.

schtasks /Change 
[/S system [/U username [/P [password]]]] /TN taskname
{ [/RU runasuser] [/RP runaspassword] [/TR taskrun] [/ST starttime] 
[/RI interval] [ {/ET endtime | /DU duration} [/K] ]
[/SD startdate] [/ED enddate] [/ENABLE | /DISABLE] [/IT] [/Z] }

Paramètres

Système /S

Valeur qui spécifie l’ordinateur distant auquel se connecter. En cas d’omission, le paramètre système est défini par défaut sur l’ordinateur local.

Nom d’utilisateur /U

Valeur qui spécifie le contexte utilisateur sous lequel Schtasks.exe doivent s’exécuter.

/P[password]

Valeur qui spécifie le mot de passe pour le contexte utilisateur donné. En cas d’omission, Schtasks.exe invite l’utilisateur à entrer.

/TNtaskname

Valeur qui spécifie la tâche planifiée à modifier.

/RUrunasuser

Valeur qui modifie le nom d’utilisateur (contexte utilisateur) sous lequel la tâche planifiée s’exécutera. Pour le compte système, les valeurs valides sont « », « NT AUTHORITY\SYSTEM » ou « SYSTEM ». Pour les tâches du Planificateur de tâches 2.0, « NT AUTHORITY\LOCALSERVICE » et « NT AUTHORITY\NETWORKSERVICE » sont également des valeurs valides.

/RPrunaspassword

Valeur qui spécifie un nouveau mot de passe pour le contexte utilisateur existant ou le mot de passe d’un nouveau compte d’utilisateur. Ce mot de passe est ignoré pour le compte système.

/TRtaskrun

Valeur qui spécifie un nouveau programme que la tâche exécutera.

/STstarttime

Valeur qui spécifie l’heure de début de l’exécution de la tâche. Le format d’heure est HH:mm (24 heures). Par exemple, 14:30 spécifie 14:30PM.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

Intervalle /RI

Valeur qui spécifie l’intervalle de répétition, en minutes. La plage valide est de 1 à 599940 minutes.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/ETendtime

Valeur qui spécifie l’heure de fin de la tâche. Le format d’heure est HH:mm (24 heures). Par exemple, 14:50 spécifie 14:50PM.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

Durée /DU

Valeur qui spécifie la durée d’exécution de la tâche. Le format d’heure est HH:mm (24 heures). Par exemple, 14:50 spécifie 14:50PM. Cela ne s’applique pas avec le paramètre /ET.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/K

Valeur qui met fin à la tâche à l’heure de fin ou à l’heure de durée.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/SDstartdate

Valeur qui spécifie la première date à laquelle exécuter la tâche. Le format est mm/jj/aaaa.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/EDenddate

Valeur qui spécifie la date de la dernière exécution de la tâche. Le format est mm/jj/aaaa.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/IL

Valeur qui permet à la tâche de s’exécuter de manière interactive uniquement si l’utilisateur /RU est actuellement connecté au moment de l’exécution de la tâche. La tâche s’exécute uniquement si l’utilisateur est connecté.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

Niveau /RL

Valeur qui définit le niveau d’exécution de la tâche. Les valeurs valides sont LIMITED et HIGHEST.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/ACTIVER

Valeur qui active la tâche planifiée. Une tâche activée peut s’exécuter et une tâche désactivée ne peut pas s’exécuter.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/DÉSACTIVER

Valeur qui désactive l’exécution de la tâche planifiée.

Notes

Si une tâche remote Task Scheduler 1.0 est désactivée par Schtasks.exe et que l’exception de pare-feu Partage de fichiers et d’imprimantes de l’ordinateur distant est activée et que l’exception de pare-feu Gestion des tâches planifiées à distance est désactivée, la tâche n’est pas désactivée lorsqu’elle est lue à partir d’une API Planificateur de tâches 2.0.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/Z

Valeur qui marque la tâche à supprimer après son exécution finale.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/DELAYdelaytime

Valeur qui spécifie le temps d’attente pour retarder l’exécution de la tâche après le déclenchement du déclencheur. Le format d’heure est mmmm:ss. Cette option n’est valide que pour les tâches avec les types de planification ONSTART, ONLOGON et ONEVENT.

Windows XP et Windows Server 2003 : Cette option n’est pas disponible.

/?

Valeur qui affiche le message d’aide pour Schtasks.exe.

Configuration requise