Beispiel für Anmeldetrigger (XML)

  • Artikel

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

Um einen in XML definierten Task zu registrieren, können Sie entweder die Funktion ITaskFolder::RegisterTask (TaskFolder.RegisterTask für Skripterstellung) oder das Schtasks.exe Befehlszeilentool verwenden. Wenn Sie das Tool Schtasks.exe (im Verzeichnis C:\Windows\System32) verwenden, können Sie den Task mit dem folgenden Befehl registrieren: schtasks /create /XML-Pfad<für die XML-Datei, die den Aufgabendefinitions>-/tn-Aufgabennamen<> enthält.

So definieren Sie eine Aufgabe zum Starten von Editor beim Systemstart

Im folgenden XML-Beispiel wird gezeigt, wie eine Aufgabe mit einer einzelnen Ausführungsaktion (Start von Editor), ein einzelner Anmeldetrigger definiert wird, der die Aufgabe startet, wenn sich ein Benutzer anmeldet, und mehrere andere Aufgabeneinstellungen, die sich darauf auswirken, wie die Aufgabe vom Taskplaner behandelt 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 beachten sollten:

  • RegistrationInfo: Enthält Registrierungsinformationen zum Task.
  • Trigger: Definiert den Trigger, der den Task 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 den Bezeichner des Benutzers bezeichnert. Die Aufgabe 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 Aufgabenplaner zum Ausführen der Aufgabe verwendet.
  • Aktionen: Definiert die Aktionen, die der Task ausführt. Führen Sie in diesem Fall Editor aus.

Verwenden des Aufgabenplaners