Beispiel für Anmeldetrigger (XML)

Der XML-Code in diesem Beispiel definiert eine Aufgabe, die Editor, wenn sich ein Benutzer anmeldet.

Zum Registrieren einer Aufgabe, 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 Schtasks.exe-Tool (im Verzeichnis C: Windows System32) verwenden, können Sie den folgenden Befehl verwenden, um die Aufgabe zu \ \ registrieren: schtasks /create /XML /tn .

So definieren Sie eine Aufgabe zum Starten Editor beim Systemstart

Das folgende XML-Beispiel zeigt, wie Sie eine Aufgabe mit einer einzelnen Ausführungsaktion (ab Editor), einem einzelnen Anmeldetrigger, der die Aufgabe startet, wenn sich ein Benutzer anmeldet, und mehreren anderen Aufgabeneinstellungen definieren, die sich darauf auswirken, wie der Task von Taskplaner.

Hinweis

Legen Sie den Wert des UserId-Elements auf einen Benutzernamen auf dem Computer fest, auf dem der Task registriert ist.

<?xml version="1.0" ?>
<!--
This sample schedules a task to start notepad.exe when a user logs on.
-->
<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>Starts Notepad when a specified user logs on.</Description>
    </RegistrationInfo>
    <Triggers>
        <LogonTrigger>
            <StartBoundary>2005-10-11T13:21:17-08:00</StartBoundary>
            <EndBoundary>2006-01-01T00:00:00-08:00</EndBoundary>
            <Enabled>true</Enabled>
            <UserId>DOMAIN_NAME\UserName</UserId>
        </LogonTrigger>
    </Triggers>
    <Principals>
        <Principal>
            <GroupId>Builtin\Administrators</GroupId>
        </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.
  • LogonTrigger:Definiert den Logon-Trigger. In diesem Fall werden drei untergeordnete Elemente verwendet: die Start- und Endgrenzen, die angeben, wann der Trigger aktiviert und deaktiviert wird, und das UserId-Element, das den Bezeichner des Benutzers enthält. Der Task wird gestartet, wenn sich dieser Benutzer beim Computer anmeldet.
  • Prinzipal:Definiert den Sicherheitskontext, unter dem ein Task ausgeführt wird.
  • Einstellungen: Definiert die Aufgabeneinstellungen, die der Taskplaner zum Ausführen der Aufgabe verwendet.
  • Aktionen:Definiert die Aktionen, die der Task ausführt. In diesem Fall wird Editor.

Verwenden des Taskplaner