Wöchentliches Triggerbeispiel (XML)

  • Artikel

Der XML-Code in diesem Beispiel definiert eine Aufgabe, die Editor zweiwöchentlich startet.

Um eine aufgabe zu registrieren, die in XML definiert ist, können Sie entweder die ITaskFolder::RegisterTask-Funktion (TaskFolder.RegisterTask für die Skripterstellung) oder das Schtasks.exe Befehlszeilentool verwenden. Wenn Sie das tool Schtasks.exe (im Verzeichnis C:\Windows\System32) verwenden, können Sie den folgenden Befehl verwenden, um den Task zu registrieren: schtasks /create /XML path<to the XML file containing the task definition>/tn<task name>.

So definieren Sie eine Aufgabe zum Starten des Editor alle zwei Wochen am Montag um 8:00 Uhr

Im folgenden XML-Beispiel wird gezeigt, wie Sie eine Aufgabe mit einer einzelnen Ausführungsaktion (Start von Editor), einem einzelnen Kalendertrigger (startet den Vorgang alle zwei Wochen am Montag um 8:00 Uhr) und mehreren anderen Vorgangseinstellungen definieren, die sich darauf auswirken, wie die Aufgabe vom Taskplaner behandelt wird.

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

TaskScheduler-Schemaelemente

Im Folgenden finden Sie einige wichtige Elemente, die Sie bei der Verwendung dieses Beispiels beachten sollten.

  • RegistrationInfo

    Enthält Registrierungsinformationen zum Task.

  • Auslöser

    Definiert den Trigger, der die Aufgabe startet.

  • CalendarTrigger

    Definiert den Wöchentlichen Kalendertrigger. In diesem Fall werden nur vier untergeordnete Elemente verwendet: die Start- und Endgrenzen, die angeben, wann der Trigger aktiviert und deaktiviert wird, der wöchentliche Zeitplan und die Wochentage, an denen der Task ausgeführt wird. Das StartBoundary-Element ist ein erforderliches Element für Kalendertrigger.

  • ScheduleByWeek

    Definiert den wöchentlichen Zeitplan. In diesem Fall wird das Intervall so festgelegt, dass die Aufgabe alle zwei Wochen an einem Montag ausgeführt wird.

  • Prinzipal

    Definiert den Sicherheitskontext, unter dem eine Aufgabe ausgeführt wird.

  • Einstellungen

    Definiert die Aufgabeneinstellungen, die der Taskplaner zum Ausführen der Aufgabe verwendet.

  • Aktionen

    Definiert die Aktionen, die von der Aufgabe ausgeführt werden (in diesem Fall wird Editor ausgeführt).

Verwenden des Aufgabenplanungsmoduls