Freigeben über

Beispiel für Anmeldetrigger (XML)

  • Artikel

Das XML in diesem Beispiel definiert eine Aufgabe, die den Editor startet, wenn sich ein Benutzer anmeldet.

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 beim Systemstart

Das folgende XML-Beispiel zeigt, wie Sie eine Aufgabe mit einer einzelnen Ausführungsaktion (Starten des Editors), einem einzelnen Anmeldetrigger, der die Aufgabe bei der Anmeldung des Benutzers startet, und mehreren anderen Aufgabeneinstellungen definieren, die sich darauf auswirken, wie die Aufgabe von der Aufgabenplanung verarbeitet wird.

Hinweis

Legen Sie den Wert des UserId-Elements auf einen Benutzernamen auf dem Computer fest, auf dem die Aufgabe 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 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.
  • LogonTrigger: Definiert den Anmeldetrigger. 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 der Bezeichner des Benutzers ist. Die Aufgabe wird gestartet, wenn sich dieser Benutzer beim Computer anmeldet.
  • 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. Führen Sie in diesem Fall den Editor aus.

Verwenden der Aufgabenplanung