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 : |