Exemple de déclencheur logon (XML)

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

Pour inscrire une tâche définie dans XML, vous pouvez utiliser la fonction ITaskFolder::RegisterTask (TaskFolder.RegisterTask pour le script) 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 /XMLpathdans le fichier XML< contenant le nom de la définition> de tâche/tntask<.>

Pour définir une tâche pour démarrer 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 (en commençant 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 Bloc-notes.

Utilisation du planificateur de tâches