Tägliches Triggerbeispiel (XML)

  • Artikel

Der XML-Code in diesem Beispiel definiert eine Aufgabe, die Editor täglich um 8:00 Uhr startet. Das Beispiel zeigt auch, wie ein Wiederholungsmuster für den Trigger festgelegt wird, um die Aufgabe zu wiederholen.

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, um den Editor täglich um 8:00 Uhr zu starten

Das folgende XML-Beispiel zeigt, wie Sie einen Vorgang mit einer einzelnen Ausführungsaktion (starte Editor), einem einzelnen Kalendertrigger (startet den Vorgang täglich um 8:00 Uhr morgens) und mehreren anderen Vorgangseinstellungen definieren, die sich darauf auswirken, wie die Aufgabe vom Aufgabenplaner behandelt wird.

<?xml version="1.0" ?>
<!--
This sample schedules a task to start on a daily basis.
-->
<Task xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
    <RegistrationInfo>
        <Date>2005-10-11T13:21:17-08:00</Date>
        <Author>AuthorName</Author>
        <Version>1.0.0</Version>
        <Description>Notepad starts every day.</Description>
    </RegistrationInfo>
    <Triggers>
        <CalendarTrigger>
            <StartBoundary>2005-10-11T13:21:17-08:00</StartBoundary>
            <EndBoundary>2006-01-01T00:00:00-08:00</EndBoundary>
            <Repetition>
                <Interval>PT1M</Interval>
                <Duration>PT4M</Duration>
            </Repetition>
            <ScheduleByDay>
                <DaysInterval>1</DaysInterval>
            </ScheduleByDay>
        </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.

  • Trigger

    Definiert den Trigger, der die Aufgabe startet.

  • CalendarTrigger

    Definiert den Täglichen Kalendertrigger. In diesem Fall werden vier untergeordnete Elemente verwendet: die Start- und Endgrenzen, die angeben, wann der Trigger aktiviert und deaktiviert wird, der Tageszeitplan und das Wiederholungsmuster für die Aufgabe. Das StartBoundary-Element ist ein erforderliches Element für Kalendertrigger.

  • ScheduleByDay

    Definiert den Tageszeitplan. In diesem Fall wird das Intervall so festgelegt, dass die Aufgabe täglich 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