Exemple de déclencheur d’inscription (XML)

Le code XML de cet exemple définit une tâche qui démarre Bloc-notes lorsque la tâche est inscrite.

Pour inscrire une tâche définie dans XML, vous pouvez utiliser la fonction ITaskFolder::RegisterTask (TaskFolder.RegisterTask pour le script) 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 /XMLpathdans le fichier XML< contenant le nom de la définition> de tâche/tntask<.>

Remarque

Lorsqu’une tâche avec un déclencheur d’inscription est mise à jour, la tâche s’exécute une fois la mise à jour effectuée.

 

Pour définir une tâche pour démarrer Bloc-notes lors de l’inscription

L’exemple XML suivant montre comment définir une tâche avec une seule action d’exécution (à partir de Bloc-notes), un déclencheur d’inscription unique qui démarre la tâche lorsqu’elle est inscrite 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.

Remarque

Lorsqu’une tâche avec un déclencheur d’inscription est mise à jour, la tâche s’exécute une fois la mise à jour effectuée.

 

<?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 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.
• RegistrationTrigger : définit le déclencheur d’inscription. 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.
• 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, exécutez Bloc-notes.

Rubriques connexes

Utilisation du planificateur de tâches