Partager via


Objet LogonTrigger

Objet de script qui représente un déclencheur qui démarre une tâche lorsqu’un utilisateur se connecte. Lorsque le service Planificateur de tâches démarre, tous les utilisateurs connectés sont énumérés et toutes les tâches inscrites avec des déclencheurs d’ouverture de session qui correspondent à l’utilisateur connecté sont exécutées.

Membres

L’objet LogonTrigger a les types de membres suivants :

Propriétés

L’objet LogonTrigger a ces propriétés.

Propriété Type d’accès Description
Retarder
Lecture/écriture
Obtient ou définit une valeur qui indique la durée entre le moment où l’utilisateur se connecte et le démarrage du travail.
activé
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit une valeur booléenne qui indique si le déclencheur est activé.
Limite de fin
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit la date et l’heure de désactivation du déclencheur. Le déclencheur ne peut pas démarrer la tâche après sa désactivation.
ExecutionTimeLimit
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit la durée maximale pendant laquelle la tâche lancée par le déclencheur est autorisée à s’exécuter.
Id
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit l’identificateur du déclencheur.
Répétition
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit une valeur qui indique la fréquence d’exécution de la tâche et la durée pendant laquelle le modèle de répétition est répété après le démarrage de la tâche.
Limite de début
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit la date et l’heure auxquelles le déclencheur est activé.
Type
Lecture seule
Hérité de l’objet Trigger . Obtient le type du déclencheur.
Userid
Lecture/écriture
Obtient ou définit l'identificateur de l'utilisateur.

Notes

Si vous souhaitez qu’une tâche soit déclenchée lorsqu’un membre d’un groupe se connecte à l’ordinateur plutôt que lorsqu’un utilisateur spécifique se connecte, n’affectez pas de valeur à la propriété LogonTrigger.UserId . Au lieu de cela, créez un déclencheur d’ouverture de session avec une propriété LogonTrigger.UserId vide et affectez une valeur au principal de la tâche à l’aide de la propriété Principal.GroupId .

Lors de la lecture ou de l’écriture de code XML pour une tâche, un déclencheur d’ouverture de session est spécifié à l’aide de l’élément LogonTrigger du schéma du planificateur de tâches.

Exemples

Pour plus d’informations et un exemple de code pour cet objet de script, consultez Exemple de déclencheur d’ouverture de session (script).

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2008 [applications de bureau uniquement]
Bibliothèque de types
Taskschd.tlb
DLL
Taskschd.dll

Voir aussi

Déclencheur