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++: Propriedade ClassId de IComHandlerAction Propriedade Data de IComHandlerAction Script: ComHandlerAction.ClassId ComHandlerAction.Data
Ação Email	C++: Propriedade Body de IEmailAction Propriedade Server de IEmailAction Propriedade Subject de IEmailAction To Property of IEmailAction Propriedade Cc de IEmailAction Propriedade Bcc de IEmailAction Propriedade ReplyTo de IEmailAction Propriedade From de IEmailAction Script: EmailAction.Body EmailAction.Server EmailAction.Subject EmailAction.To EmailAction.Cc EmailAction.Bcc EmailAction.ReplyTo EmailAction.From
Ação exec	C++: Propriedade Arguments de IExecAction Propriedade WorkingDirectory de IExecAction Script: ExecAction.Arguments ExecAction.WorkingDirectory
Mostrar Ação de Mensagem	C++: Propriedade Title de IShowMessageAction Propriedade MessageBody de IShowMessageAction Script: ShowMessageAction.Title ShowMessageAction.MessageBody

Tópicos relacionados

Sobre o agendador de tarefas