Exemple de déclencheur de temps (XML)

  • Article

Le code XML de cet exemple définit une tâche qui démarre le Bloc-notes à un moment spécifique.

Pour inscrire une tâche définie en XML, vous pouvez utiliser la fonction ITaskFolder::RegisterTask (TaskFolder.RegisterTask pour l’écriture de scripts) ou 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 inscrire la tâche : schtasks /create /XML<path to the XML file containing the task definition>/tn<task name>.

Pour définir une tâche pour démarrer le Bloc-notes à un moment spécifique

L’exemple XML suivant montre comment définir une tâche avec une seule action d’exécution (à partir du Bloc-notes), un déclencheur de temps unique qui démarre la tâche à une heure spécifiée et plusieurs autres paramètres de tâche qui affectent la façon 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 TaskScheduler

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

  • RegistrationInfo : contient des informations d’inscription sur la tâche.
  • Déclencheurs : définit le déclencheur qui démarre la tâche.
  • TimeTrigger : définit le déclencheur de temps. Dans ce cas, trois éléments enfants sont utilisés : les limites de début et de fin qui spécifient le moment où le déclencheur est activé et désactivé, et la limite de temps d’exécution qui spécifie la durée maximale pendant laquelle la tâche peut être démarrée par le déclencheur. L’élément StartBoundary est un élément obligatoire pour les déclencheurs de temps.
  • Principal : définit le contexte de sécurité sous lequel une tâche s’exécute.
  • Paramètres : définit les paramètres de tâche que le planificateur de tâches utilise pour effectuer la tâche.
  • Actions : définit les actions effectuées par la tâche (dans ce cas, en exécutant le Bloc-notes).

Utilisation du planificateur de tâches