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 accomplies 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 démarrage de Bloc-notes.
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 des 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
Actions, propriété 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 e-mail.
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 e-mail.
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 e-mail.
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 IRegisteredTask::RunEx ou contenues dans le déclencheur d’événement de 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 d’e-mail C++ :
Création de scripts :
Exec Action C++ :
Création de scripts :
Afficher l’action de message C++ :
Création de scripts :

À propos du planificateur de tâches