Partager via


Exemple de déclencheur d’inscription (XML)

Le XML dans cet exemple définit une tâche qui démarre Notepad lors de l’enregistrement de la tâche.

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

Remarque

Lorsqu’une tâche avec un déclencheur d’enregistrement est mise à jour, la tâche s’exécute après la mise à jour.

 

Pour définir une tâche pour démarrer Notepad lors de l’enregistrement

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 d’enregistrement qui démarre la tâche lorsqu’elle est enregistré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.

Remarque

Lorsqu’une tâche avec un déclencheur d’enregistrement est mise à jour, la tâche s’exécute après la mise à jour.

 

<?xml version="1.0" ?>
<!--
This sample schedules a task to start notepad.exe when
the task is registered.
-->
<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 registration.</Description>
    </RegistrationInfo>
    <Triggers>
        <RegistrationTrigger>
        </RegistrationTrigger>
    </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.
  • RegistrationTrigger : Définit le déclencheur d’enregistrement. Dans ce cas, seuls deux é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é.
  • 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 effectue. Dans ce cas, l’exécution de Notepad.

Utilisation du Planificateur de tâches