Objet EventTrigger

Objet de script qui représente un déclencheur qui démarre une tâche lorsqu’un événement système se produit.

Membres

L’objet EventTrigger a les types de membres suivants :

Propriétés

L’objet EventTrigger possède 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’événement se produit et le démarrage de la tâche.
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 ce 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 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 d’activation du déclencheur.
Abonnement
Lecture/écriture
Obtient ou définit la chaîne de requête XPath qui identifie l’événement qui déclenche le déclencheur.
Type
Lecture seule
Hérité de l’objet Trigger . Obtient le type du déclencheur.
ValueQueries
Lecture/écriture
Obtient ou définit une collection de requêtes XPath nommées. Chaque requête de la collection est appliquée au dernier xml d’événement correspondant retourné à partir de la requête d’abonnement spécifiée dans la propriété Subscription . Le nom de la requête peut être utilisé comme variable dans le message d’une action ShowMessageAction .

Notes

Un maximum de 500 tâches avec des abonnements aux événements peuvent être créées. Un abonnement aux événements qui interroge divers événements peut être utilisé pour déclencher une tâche qui utilise la même action en réponse aux événements en cours de journalisation.

Lors de la lecture ou de l’écriture de votre propre code XML pour une tâche, un déclencheur d’événement est spécifié à l’aide de l’élément EventTrigger du schéma Task Scheduler.

Exemples

Pour plus d’informations et un exemple de code pour cet objet de script, consultez Exemple de déclencheur d’événement (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]
En-tête
Windows.ui.xaml.h
Bibliothèque de types
Taskschd.tlb
DLL
Taskschd.dll

Voir aussi

Déclencheur

TriggerCollection

TriggerCollection.Create