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.
-
Enthält Registrierungsinformationen über den Task.
-
Definiert den Trigger, der die Aufgabe startet.
-
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.
-
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.
-
Definiert den Sicherheitskontext, unter dem eine Aufgabe ausgeführt wird.
-
Definiert die Taskeinstellungen, die Taskplaner zum Ausführen der Aufgabe verwendet.
-
Definiert die Aktionen, die der Task ausführt (in diesem Fall das Ausführen von Editor).