Share via

Exemple de déclencheur hebdomadaire (XML)

  • Article

Le code XML de cet exemple définit une tâche qui démarre le Bloc-notes deux fois par semaine.

Pour inscrire une tâche définie en XML, vous pouvez utiliser la fonction ITaskFolder::RegisterTask (TaskFolder.RegisterTask pour les 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 contenant la définition> de tâche/tn<task name>.

Pour définir une tâche pour démarrer le Bloc-notes une semaine sur deux, le lundi à 8h00

L’exemple XML suivant montre comment définir une tâche avec une seule action d’exécution (bloc-notes de démarrage), un déclencheur de calendrier unique (démarre la tâche une semaine sur deux le lundi à 8h00) 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 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 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.

  • 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é, la planification hebdomadaire et les jours de la semaine sur lesquels la tâche s’exécutera. L’élément StartBoundary est un élément obligatoire pour les déclencheurs de calendrier.

  • ScheduleByWeek

    Définit la planification hebdomadaire. Dans ce cas, l’intervalle est défini pour effectuer la tâche toutes les deux semaines un 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 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