Beispiel für Zeittrigger (XML)

  • Artikel

Der XML-Code in diesem Beispiel definiert eine Aufgabe, die Editor zu einem bestimmten Zeitpunkt 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 von Editor zu einem bestimmten Zeitpunkt

Im folgenden XML-Beispiel wird gezeigt, wie Sie einen Vorgang mit einer einzelnen Ausführungsaktion (Start von Editor), einem einzelnen Zeittrigger, der den Vorgang zu einem bestimmten Zeitpunkt startet, 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 notepad.exe at a specific time.
-->
<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>Task starts after at a specified time.</Description>
    </RegistrationInfo>
    <Triggers>
        <TimeTrigger>
            <StartBoundary>2005-10-11T13:21:17-08:00</StartBoundary>
            <EndBoundary>2006-01-01T00:00:00-08:00</EndBoundary>
            <Enabled>true</Enabled>
            <ExecutionTimeLimit>PT5M</ExecutionTimeLimit>
        </TimeTrigger>
    </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 zur Aufgabe.
  • Trigger: Definiert den Trigger, der die Aufgabe startet.
  • TimeTrigger: Definiert den Zeittrigger. In diesem Fall werden drei untergeordnete Elemente verwendet: die Start- und Endgrenzen, die angeben, wann der Trigger aktiviert und deaktiviert wird, und das Ausführungszeitlimit, das die maximale Zeitspanne angibt, in der die Aufgabe vom Trigger gestartet werden kann. Das StartBoundary-Element ist ein erforderliches Element für Zeittrigger.
  • Prinzipal: Definiert den Sicherheitskontext, unter dem eine Aufgabe ausgeführt wird.
  • Einstellungen: Definiert die Aufgabeneinstellungen, die der Aufgabenplaner 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