Objet LogonTrigger

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

Membres

L’objet LogonTrigger possède 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 ouvre une session et le moment où le travail est démarré.
Activé
Lecture/écriture
Héritée de l’objet déclencheur . Obtient ou définit une valeur booléenne qui indique si le déclencheur est activé.
EndBoundary
Lecture/écriture
Héritée de l’objet déclencheur . 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 une fois qu’elle est désactivée.
ExecutionTimeLimit
Lecture/écriture
Héritée de l’objet déclencheur . 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.
Identifi
Lecture/écriture
Héritée de l’objet déclencheur . Obtient ou définit l’identificateur pour le déclencheur.
Répétition
Lecture/écriture
Héritée de l’objet déclencheur . Obtient ou définit une valeur qui indique la fréquence d’exécution de la tâche et la durée de répétition du modèle de répétition après le démarrage de la tâche.
StartBoundary
Lecture/écriture
Héritée de l’objet déclencheur . Obtient ou définit la date et l’heure d’activation du déclencheur.
Type
Lecture seule
Héritée de l’objet déclencheur . Obtient le type du déclencheur.
UserId
Lecture/écriture
Obtient ou définit l'identificateur de l'utilisateur.

Remarques

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

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

Exemples

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

Configuration requise

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

Voir aussi

Déclencheur