Partager via

Exemple de déclencheur de temps (XML)

  • Article

Le XML dans cet exemple définit une tâche qui démarre Notepad à une heure spécifique.

Pour enregistrer une tâche définie en XML, vous pouvez utiliser soit la fonction ITaskFolder::RegisterTask (TaskFolder.RegisterTask pour le scripting) soit l’outil en ligne de commande Schtasks.exe. Si vous utilisez l’outil Schtasks.exe (situé dans le répertoire C:\Windows\System32), vous pouvez utiliser la commande suivante pour enregistrer la tâche : schtasks /create /XML <chemin vers le fichier XML contenant la définition de la tâche> /tn <nom de la tâche>.

Pour définir une tâche pour démarrer Notepad à une heure spécifique

L’exemple XML suivant montre comment définir une tâche avec une seule action d’exécution (démarrer Notepad), un seul déclencheur temporel qui démarre la tâche à une heure spécifiée, et plusieurs autres paramètres de tâche qui affectent la manière dont la tâche est gérée par le Planificateur de tâches.

<?xml version="1.0" ?>
<!--
This sample schedules a task to start notepad.exe at a specific time.
-->
<Task xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
    <RegistrationInfo>
        <Date>2005-10-11T13:21:17-08:00</Date>
        <Author>AuthorName</Author>
        <Version>1.0.0</Version>
        <Description>Task starts after at a specified time.</Description>
    </RegistrationInfo>
    <Triggers>
        <TimeTrigger>
            <StartBoundary>2005-10-11T13:21:17-08:00</StartBoundary>
            <EndBoundary>2006-01-01T00:00:00-08:00</EndBoundary>
            <Enabled>true</Enabled>
            <ExecutionTimeLimit>PT5M</ExecutionTimeLimit>
        </TimeTrigger>
    </Triggers>
    <Principals>
        <Principal>
            <UserId>Administrator</UserId>
            <LogonType>InteractiveToken</LogonType>
        </Principal>
    </Principals>
    <Settings>
        <Enabled>true</Enabled>
        <AllowStartOnDemand>true</AllowStartOnDemand>
        <AllowHardTerminate>true</AllowHardTerminate>
    </Settings>
    <Actions>
        <Exec>
            <Command>notepad.exe</Command>
        </Exec>
    </Actions>
</Task>

Éléments de schéma du Planificateur de tâches

Voici quelques éléments importants à garder à l’esprit lors de l’utilisation de cet exemple :

  • RegistrationInfo : Contient des informations d’enregistrement sur la tâche.
  • Triggers : Définit le déclencheur qui lance la tâche.
  • TimeTrigger : Définit le déclencheur temporel. Dans ce cas, trois éléments enfants sont utilisés : les limites de début et de fin qui spécifient quand le déclencheur est activé et désactivé, et la limite de temps d’exécution qui spécifie le temps maximum dans lequel la tâche peut être démarrée par le déclencheur. L’élément StartBoundary est un élément requis pour les déclencheurs temporels.
  • Principal : Définit le contexte de sécurité sous lequel une tâche s’exécute.
  • Settings : Définit les paramètres de la tâche que le Planificateur de tâches utilise pour exécuter la tâche.
  • Actions : Définit les actions que la tâche exécute (dans ce cas, démarrer Notepad).

Utilisation du Planificateur de tâches