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

  • Artikel

Das XML in diesem Beispiel definiert eine Aufgabe, die den Editor alle zwei Wochen startet.

Um eine Aufgabe zu registrieren, die in XML definiert ist, können Sie entweder die ITaskFolder::RegisterTask-Funktion (TaskFolder.RegisterTask für Skripting) oder das Schtasks.exe-Befehlszeilentool verwenden. Wenn Sie das Schtasks.exe-Tool verwenden (befindet sich im Verzeichnis C:\Windows\System32), können Sie den folgenden Befehl zum Registrieren der Aufgabe verwenden: schtasks /create /XML <Pfad zur XML-Datei mit der Aufgabendefinition> /tn <Aufgabenname>.

So definieren Sie eine Aufgabe, bei der der Editor jede zweite Woche am Montag um 8:00 Uhr gestartet wird

Das folgende XML-Beispiel zeigt, wie Sie eine Aufgabe mit einer einzelnen Ausführungsaktion (Starten des Editors), einem einzelnen Kalendertrigger (startet die Aufgabe jede zweite Woche am Montag um 8:00 Uhr) und mehrere andere Aufgabeneinstellungen definieren, die sich auf die Behandlung der Aufgabe durch die Aufgabenplanung auswirken.

<?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 sind einige wichtige Elemente aufgeführt, die Sie bei der Verwendung dieses Beispiels berücksichtigen sollten.

  • RegistrationInfo

    Enthält Registrierungsinformationen über die Aufgabe.

  • 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, der wöchentliche Zeitplan und die Wochentage, an denen die Aufgabe 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 jede zweite Woche an einem Montag ausgeführt wird.

  • Prinzipal

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

  • Einstellungen

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

  • Aktionen

    Definiert die Aktionen, die die Aufgabe ausführt (in diesem Fall das Ausführen des Editors).

Verwenden der Aufgabenplanung