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

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