Partager via

Exemple de déclencheur hebdomadaire (XML)

  • Article

Le XML dans cet exemple définit une tâche qui démarre Notepad toutes les deux semaines.

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 toutes les deux semaines le lundi à 8h00

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 de calendrier (démarre la tâche toutes les deux semaines le lundi à 8h00), 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 on a bi-weekly basis.
-->
<Task xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
    <RegistrationInfo>
        <Date>2005-05-01T09:00:00</Date>
        <Author>AuthorName</Author>
        <Version>1.0.0</Version>
        <Description>Notepad starts every other week on Monday at 8:00am.</Description>
    </RegistrationInfo>
    <Triggers>
        <CalendarTrigger>
            <StartBoundary>2005-05-02T08:00:00</StartBoundary>
            <EndBoundary>2006-01-01T00:00:00</EndBoundary>
            <ScheduleByWeek>
                <WeeksInterval>2</WeeksInterval>
                <DaysOfWeek>
                    <Monday/>
                </DaysOfWeek>
            </ScheduleByWeek>
        </CalendarTrigger>
    </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.

  • Déclencheurs

    Définit le déclencheur qui lance la tâche.

  • CalendarTrigger

    Définit le déclencheur de calendrier hebdomadaire. Dans ce cas, seuls quatre é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é, le calendrier hebdomadaire, et les jours de la semaine où la tâche s’exécutera. L’élément StartBoundary est un élément requis pour les déclencheurs de calendrier.

  • ScheduleByWeek

    Définit le calendrier hebdomadaire. Dans ce cas, l’intervalle est réglé pour exécuter la tâche toutes les deux semaines le lundi.

  • Principal

    Définit le contexte de sécurité sous lequel une tâche s’exécute.

  • Paramètres

    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, exécuter Notepad).

Utilisation du Planificateur de tâches