Delen via

Voorbeeld van aanmeldingstrigger (XML)

De XML in dit voorbeeld definieert een taak die Kladblok start wanneer een gebruiker zich aanmeldt.

Als u een taak wilt registreren die is gedefinieerd in XML, kunt u de functie ITaskFolder::RegisterTask (TaskFolder.RegisterTask gebruiken voor het uitvoeren van scripts) of het Schtasks.exe opdrachtregelprogramma. Als u het hulpprogramma Schtasks.exe (in de map C:\Windows\System32) gebruikt, kunt u de volgende opdracht gebruiken om de taak te registreren: schtasks /create /XML<pad naar het XML-bestand met de taakdefinitie>/tn<taaknaam>.

Een taak definiëren om Kladblok te starten bij het opstarten van het systeem

In het volgende XML-voorbeeld ziet u hoe u een taak definieert met één uitvoeringsactie (kladblok starten), één aanmeldingstrigger waarmee de taak wordt gestart wanneer een gebruiker zich aanmeldt en verschillende andere taakinstellingen die van invloed zijn op de manier waarop de taak wordt verwerkt door Task Scheduler.

Notitie

Stel de waarde van het element UserId in op een gebruikersnaam op de computer waarop de taak is geregistreerd.

 

<?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-schema-elementen

Hier volgen enkele belangrijke elementen om rekening mee te houden bij het gebruik van dit voorbeeld:

  • RegistrationInfo: bevat registratiegegevens over de taak.
  • Triggers: Hiermee definieert u de trigger waarmee de taak wordt gestart.
  • LogonTrigger-: Hiermee definieert u de aanmeldingstrigger. In dit geval worden drie onderliggende elementen gebruikt: de begin- en eindgrenzen die aangeven wanneer de trigger wordt geactiveerd en gedeactiveerd, en de UserId element die id van de gebruiker. De taak wordt gestart wanneer deze gebruiker zich aanmeldt bij de computer.
  • Principal-: definieert de beveiligingscontext waaronder een taak wordt uitgevoerd.
  • Instellingen: definieert de taakinstellingen die de Task Scheduler gebruikt om de taak uit te voeren.
  • Acties: Definieert de acties die de taak uitvoert. In dit geval voert u Kladblok uit.

De taakplanner gebruiken