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 E-mail	Esta ação envia um e-mail quando uma tarefa é acionada.
Mostrar ação de 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 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 do IRegisteredTask::Run e métodos IRegisteredTask::RunEx ou estão contidos no gatilho de evento para a 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 de IComHandlerAction Scripts: ComHandlerAction.ClassId ComHandlerAction.Data
Ação por e-mail	C++: propriedade Body do IEmailAction propriedade Server do IEmailAction propriedade Subject do IEmailAction Propriedade To de IEmailAction Propriedade Cc do IEmailAction propriedade bcc do IEmailAction propriedade ReplyTo do IEmailAction propriedade de IEmailAction Scripts: 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 Scripts: ExecAction.Arguments ExecAction.WorkingDirectory
Mostrar ação de mensagem	C++: propriedade Title de IShowMessageAction propriedade MessageBody do IShowMessageAction Scripts: ShowMessageAction.Title ShowMessageAction.MessageBody

Sobre o Agendador de Tarefas

Feedback

Esta página foi útil?

Last updated on 2025-03-12