Beispiel für einen wöchentlichen Trigger (XML)

Der XML-Code in diesem Beispiel definiert eine Aufgabe, die Editor zwei wochenweise startet.

Um eine in XML definierte Aufgabe zu registrieren, können Sie entweder die Funktion ITaskFolder::RegisterTask (TaskFolder.RegisterTask für die Skripterstellung) oder das befehlszeilentool Schtasks.exe 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 /tn .

So definieren Sie eine Aufgabe, die alle zwei Wochen am Montag um 8:00 Uhr Editor

Im folgenden XML-Beispiel wird gezeigt, wie eine Aufgabe mit einer einzelnen Ausführungsaktion (beginnend Editor), einem einzelnen Kalendertrigger (startet die Aufgabe alle zwei Wochen am Montag um 8:00 Uhr) und mehreren anderen Taskeinstellungen definiert wird, die beeinflussen, wie der Task von 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 über den Task.

  • Trigger

    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, den wöchentlichen 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 ist 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 Taskeinstellungen, die Taskplaner zum Ausführen der Aufgabe verwendet.

  • Aktionen

    Definiert die Aktionen, die der Task ausführt (in diesem Fall das Ausführen von Editor).

Verwenden der Taskplaner