Partager via

Actions de tâche

  • Article

Les éléments de travail effectués par une tâche sont appelés actions. Une tâche peut avoir une seule action ou un maximum de 32 actions. N’oubliez pas que lorsque plusieurs actions sont spécifiées, elles sont exécutées séquentiellement.

Types d’actions

Le tableau d’actions suivant décrit le type de travail ou d’actions qui peuvent être effectuées par une tâche.

Type d’action Description
ComHandler Action Cette action déclenche un gestionnaire COM.
Exec Action Cette action exécute une opération de ligne de commande telle que le bloc-notes de démarrage.
Action de messagerie Cette action envoie un e-mail lorsqu’une tâche est déclenchée.
Afficher l’action de message Cette action affiche une boîte de message avec un message et un titre spécifiés.

Spécification d’actions

Les actions d’une tâche sont spécifiées lorsque la tâche est définie et stockée dans une collection d’actions utilisées par le service Planificateur de tâches. Le tableau suivant répertorie les liens vers des rubriques de référence pour les API et les éléments XML associés aux actions.

Pour plus d’informations et d’exemples sur l’utilisation des interfaces du planificateur de tâches, des objets de script et du code XML, consultez Utilisation du planificateur de tâches.

API d’interface pour le développement C++

API Description
propriété actions d’ITaskDefinition Obtient ou définit les actions effectuées par la tâche.
IActionCollection Contient les actions effectuées par la tâche.
IComHandlerAction Représente une action qui déclenche un gestionnaire.
IExecAction Représente une action qui exécute une opération de ligne de commande.
IEmailAction Représente une action qui envoie un message électronique.
IShowMessageAction Représente une action qui affiche une boîte de message.

API d’objet script pour le développement de scripts

API Description
TaskDefinition.Actions Obtient ou définit les actions effectuées par la tâche.
ActionCollection Contient les actions effectuées par la tâche.
ComHandlerAction Représente une action qui déclenche un gestionnaire.
ExecAction Représente une action qui exécute une opération de ligne de commande.
EmailAction Représente une action qui envoie un message électronique.
ShowMessageAction Représente une action qui affiche une boîte de message.

Éléments XML

Élément Description
actions Définit les actions effectuées par la tâche.
ComHandler Représente une action qui déclenche un gestionnaire.
Exec Représente une action qui exécute une opération de ligne de commande.
sendEmail Représente une action qui envoie un message électronique.
ShowMessage Représente une action qui affiche une boîte de message.

Utilisation de variables dans les propriétés d’action

Certaines propriétés d’action de type BSTR peuvent contenir des variables $(Arg0), $(Arg1), ..., $(Arg32) dans leurs valeurs de chaîne. Ces variables sont remplacées par les valeurs spécifiées dans le paramètre params des méthodes IRegisteredTask ::Run et méthodes IRegisteredTask ::RunEx ou contenues dans le déclencheur d’événement pour la tâche. Le tableau suivant répertorie les propriétés d’action qui peuvent utiliser des variables dans leurs valeurs de chaîne.

Action Propriétés
Action du gestionnaire COM C++ :
Script:
Action d’e-mail C++ :
Script:
Exec Action C++ :
Script:
Afficher l’action de message C++ :
Script:

À propos du planificateur de tâches