Ações de 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 aciona 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 da mensagem	Esta 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 aciona 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 aciona 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 aciona um manipulador.
doExec	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 que sã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étodos IRegisteredTask::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++: propriedade ClassId do IComHandlerAction Propriedade Data do IComHandlerAction Script: ComHandlerAction.ClassId comHandlerAction.Data
Ação de email	C++: Propriedade do corpo do IEmailAction Propriedade Server do IEmailAction propriedade do assunto do IEmailAction propriedade To do IEmailAction Propriedade cc do IEmailAction propriedade Cco do IEmailAction propriedade ReplyTo do IEmailAction da propriedade do IEmailAction Script: EmailAction.Body EmailAction.Server EmailAction.Subject EmailAction.To EmailAction.Cc EmailAction.Bcc EmailAction.ReplyTo EmailAction.From
Ação exec	C++: Propriedade Arguments do IExecAction propriedade WorkingDirectory do IExecAction Script: ExecAction.Arguments ExecAction.WorkingDirectory
Mostrar ação da mensagem	C++: Propriedade Title de IShowMessageAction propriedade MessageBody do IShowMessageAction Script: ShowMessageAction.Title ShowMessageAction.MessageBody

Tópicos relacionados

sobre o agendador de tarefas