Exemple de déclencheur logon (XML)

  • Article

Le code XML de cet exemple définit une tâche qui démarre le Bloc-notes lorsqu’un utilisateur se connecte.

Pour inscrire une tâche définie en XML, vous pouvez utiliser la fonction ITaskFolder::RegisterTask (TaskFolder.RegisterTask pour l’écriture de scripts) ou l’outil en ligne de commande Schtasks.exe. Si vous utilisez l’outil Schtasks.exe (situé dans le répertoire C:\Windows\System32), vous pouvez utiliser la commande suivante pour inscrire la tâche : schtasks /create /XML<path to the XML file containing the task definition>/tn<task name>.

Pour définir une tâche pour démarrer le Bloc-notes au démarrage du système

L’exemple XML suivant montre comment définir une tâche avec une seule action d’exécution (à partir du Bloc-notes), un déclencheur d’ouverture de session unique qui démarre la tâche lorsqu’un utilisateur se connecte et plusieurs autres paramètres de tâche qui affectent la façon dont la tâche est gérée par le planificateur de tâches.

Notes

Définissez la valeur de l’élément UserId sur un nom d’utilisateur sur l’ordinateur sur lequel la tâche est inscrite.

 

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

Éléments de schéma TaskScheduler

Voici quelques éléments importants à garder à l’esprit lors de l’utilisation de cet exemple :

  • RegistrationInfo : contient des informations d’inscription sur la tâche.
  • Déclencheurs : définit le déclencheur qui démarre la tâche.
  • LogonTrigger : définit le déclencheur d’ouverture de session. Dans ce cas, trois éléments enfants sont utilisés : les limites de début et de fin qui spécifient quand le déclencheur est activé et désactivé, et l’élément UserId qui identificateur de l’utilisateur. La tâche est démarrée lorsque cet utilisateur se connecte à l’ordinateur.
  • Principal : définit le contexte de sécurité sous lequel une tâche s’exécute.
  • Paramètres : définit les paramètres de tâche que le planificateur de tâches utilise pour effectuer la tâche.
  • Actions : définit les actions effectuées par la tâche. Dans ce cas, exécutez le Bloc-notes.

Utilisation du planificateur de tâches