Compartilhar via


Ações da Tarefa

Os itens de trabalho executados por uma tarefa são chamados de ações. Uma tarefa pode ter uma única ação ou um máximo de 32 ações. Lembre-se de que, quando várias ações são especificadas, elas são executadas sequencialmente.

Tipos de ações

A tabela de ações a seguir descreve o tipo de trabalho ou ações que podem ser realizadas por uma tarefa.

Tipo de ação Descrição
Ação ComHandler Essa ação dispara um manipulador COM.
Ação exec Essa ação executa uma operação de linha de comando, como iniciar o Bloco de Notas.
Ação de email Essa ação envia um email quando uma tarefa é disparada.
Mostrar Ação de Mensagem Essa ação mostra uma caixa de mensagem com uma mensagem e um título especificados.

Especificando ações

As ações de uma tarefa são especificadas quando a tarefa é definida e armazenada em uma coleção de ações usadas pelo serviço Agendador de Tarefas. A tabela a seguir lista links para tópicos de referência para as APIs e elementos XML associados a ações.

Para obter mais informações e exemplos sobre como usar as interfaces do Agendador de Tarefas, objetos de script e XML, consulte Usando o agendador de tarefas.

APIs de interface para desenvolvimento em C++

API Descrição
Propriedade Actions de ITaskDefinition Obtém ou define as ações executadas pela tarefa.
IActionCollection Contém as ações executadas pela tarefa.
IComHandlerAction Representa uma ação que dispara um manipulador.
IExecAction Representa uma ação que executa uma operação de linha de comando.
IEmailAction Representa uma ação que envia uma mensagem de email.
IShowMessageAction Representa uma ação que mostra uma caixa de mensagem.

APIs de objeto de script para desenvolvimento de scripts

API Descrição
TaskDefinition.Actions Obtém ou define as ações executadas pela tarefa.
Actioncollection Contém as ações executadas pela tarefa.
ComHandlerAction Representa uma ação que dispara um manipulador.
ExecAction Representa uma ação que executa uma operação de linha de comando.
EmailAction Representa uma ação que envia uma mensagem de email.
ShowMessageAction Representa uma ação que mostra uma caixa de mensagem.

Elementos XML

Elemento Descrição
Ações Define as ações executadas pela tarefa.
ComHandler Representa uma ação que dispara um manipulador.
Exec Representa uma ação que executa uma operação de linha de comando.
Sendemail Representa uma ação que envia uma mensagem de email.
Showmessage Representa uma ação que mostra uma caixa de mensagem.

Usando variáveis em propriedades de ação

Algumas propriedades de ação do tipo BSTR podem conter variáveis $(Arg0), $(Arg1), ..., $(Arg32) em seus valores de cadeia de caracteres. Essas variáveis são substituídas pelos valores especificados no parâmetro params dos métodosIRegisteredTask::Run e IRegisteredTask::RunEx ou estão contidas no gatilho de evento da tarefa. A tabela a seguir lista as propriedades de ação que podem usar variáveis em seus valores de cadeia de caracteres.

Ação Propriedades
Ação do manipulador COM C++:
Script:
Ação Email C++:
Script:
Ação exec C++:
Script:
Mostrar Ação de Mensagem C++:
Script:

Sobre o agendador de tarefas