Compartir vía

Acciones de tarea

  • Artículo

Los elementos de trabajo realizados por una tarea se denominan acciones. Una tarea puede tener una sola acción o un máximo de 32 acciones. Tenga en cuenta que, cuando se especifican varias acciones, se ejecutan secuencialmente.

Tipos de acciones

En la tabla siguiente de acciones se describe el tipo de trabajo o las acciones que puede realizar una tarea.

Tipo de acción Descripción
Acción ComHandler Esta acción desencadena un controlador COM.
Acción exec Esta acción ejecuta una operación de línea de comandos como iniciar el Bloc de notas.
Acción de correo electrónico Esta acción envía un correo electrónico cuando se desencadena una tarea.
Mostrar acción de mensaje Esta acción muestra un cuadro de mensaje con un mensaje y título especificados.

Especificar acciones

Las acciones de una tarea se especifican cuando la tarea se define y almacena en una colección de acciones usadas por el servicio Programador de tareas. En la tabla siguiente se enumeran vínculos a temas de referencia para las API y los elementos XML asociados a acciones.

Para obtener más información y ejemplos sobre cómo usar las interfaces del Programador de tareas, los objetos de scripting y XML, vea Usar el programador de tareas.

API de interfaz para el desarrollo de C++

API Descripción
Actions (propiedad) de ITaskDefinition Obtiene o establece las acciones realizadas por la tarea.
IActionCollection Contiene las acciones realizadas por la tarea.
IComHandlerAction Representa una acción que desencadena un controlador.
IExecAction Representa una acción que ejecuta una operación de línea de comandos.
IEmailAction Representa una acción que envía un mensaje de correo electrónico.
IShowMessageAction Representa una acción que muestra un cuadro de mensaje.

API de objetos de scripting para el desarrollo de scripting

API Descripción
TaskDefinition.Actions Obtiene o establece las acciones realizadas por la tarea.
ActionCollection Contiene las acciones realizadas por la tarea.
ComHandlerAction Representa una acción que desencadena un controlador.
ExecAction Representa una acción que ejecuta una operación de línea de comandos.
EmailAction Representa una acción que envía un mensaje de correo electrónico.
ShowMessageAction Representa una acción que muestra un cuadro de mensaje.

Elementos XML

Elemento Descripción
Acciones Define las acciones realizadas por la tarea.
ComHandler Representa una acción que desencadena un controlador.
Exec Representa una acción que ejecuta una operación de línea de comandos.
SendEmail Representa una acción que envía un mensaje de correo electrónico.
Showmessage Representa una acción que muestra un cuadro de mensaje.

Usar variables en propiedades de acción

Algunas propiedades de acción que son de tipo BSTR pueden contener variables $(Arg0), $(Arg1), ..., $(Arg32) en sus valores de cadena. Estas variables se reemplazan por los valores especificados en el parámetro params del método IRegisteredTask::Run e IRegisteredTask::RunEx o se encuentran dentro del desencadenador de eventos para la tarea. En la tabla siguiente se enumeran las propiedades de acción que pueden usar variables en sus valores de cadena.

Acción Propiedades
Acción del controlador COM C++:
Scripting:
acción de Email C++:
Scripting:
Acción exec C++:
Scripting:
Mostrar acción de mensaje C++:
Scripting:

Acerca del programador de tareas