Actions de tâche

Les éléments de travail exécutés par une tâche sont appelés actions. Une tâche peut avoir une seule action ou au maximum 32 actions. Sachez que lorsque plusieurs actions sont spécifiées, elles sont exécutées de manière séquentielle.

Types d'actions

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

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

Spécification des 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 des liens vers des rubriques de référence pour les API et les éléments XML associés à des actions.

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

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

API Description
Propriété actions de 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.

Scripts des API objet 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.
Comgérer Représente une action qui déclenche un gestionnaire.
Exécutable 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 qui sont 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 IRegisteredTask :: RunEx ou sont 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++ :
Création de scripts :
Action de messagerie C++ :
Création de scripts :
Action d’exécution C++ :
Création de scripts :
Afficher l’action du message C++ :
Création de scripts :

À propos de l’Planificateur de tâches