Freigeben über


Beispiel für Zeittrigger (XML)

Das XML in diesem Beispiel definiert eine Aufgabe, die den Editor zu einer bestimmten Zeit 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 zum Starten des Editors zu einem bestimmten Zeitpunkt

Das folgende XML-Beispiel zeigt, wie Sie eine Aufgabe mit einer einzelnen Ausführungsaktion (Starten des Editors), einem einzelnen Zeittrigger, der die Aufgabe zu einer bestimmten Zeit startet, und mehreren anderen Aufgabeneinstellungen definieren, die sich darauf auswirken, wie die Aufgabe von der Aufgabenplanung verarbeitet 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 sind einige wichtige Elemente aufgeführt, die Sie bei der Verwendung dieses Beispiels berücksichtigen sollten:

  • RegistrationInfo: Enthält Registrierungsinformationen zur Aufgabe.
  • Triggers: 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.
  • Principal: Definiert den Sicherheitskontext, unter dem eine Aufgabe ausgeführt wird.
  • Settings: Definiert die Aufgabeneinstellungen, die die Aufgabenplanung zum Ausführen der Aufgabe verwendet.
  • Actions: Definiert die Aktionen, die die Aufgabe ausführt (in diesem Fall das Ausführen des Editors).

Verwenden der Aufgabenplanung