Compartilhar via

Método TaskFolder.RegisterTask

  • Artigo

Para scripts, registra (cria) uma nova tarefa na pasta usando XML para definir a tarefa.

Sintaxe

TaskFolder.RegisterTask( _
  ByVal path, _
  ByVal xmlText, _
  ByVal flags, _
  ByVal userId, _
  ByVal password, _
  ByVal logonType, _
  [ ByVal sddl ], _
  ByRef pTask _
)

Parâmetros

caminho [in]

O nome da tarefa. Se esse valor for Nothing, a tarefa será registrada na pasta de tarefas raiz e o nome da tarefa será um valor GUID criado pelo serviço Agendador de Tarefas.

Um nome de tarefa não pode começar ou terminar com um caractere de espaço. O caractere '.' não pode ser usado para especificar a pasta de tarefa atual e a '.'. os caracteres não podem ser usados para especificar a pasta de tarefa pai no caminho.

xmlText [in]

Uma descrição formatada em XML da tarefa.

Os tópicos a seguir contêm tarefas definidas usando XML.

sinalizadores [in]

Uma constante TASK_CREATION .

Valor Significado
TASK_VALIDATE_ONLY
0x1
 O Agendador de Tarefas verifica a sintaxe do XML que descreve a tarefa, mas não registra a tarefa. Essa constante não pode ser combinada com os valores TASK_CREATE, TASK_UPDATE ou TASK_CREATE_OR_UPDATE .
TASK_CREATE
0x2
 O Agendador de Tarefas registra a tarefa como uma nova tarefa.
TASK_UPDATE
0x4
 O Agendador de Tarefas registra a tarefa como uma versão atualizada de uma tarefa existente. Quando uma tarefa com um gatilho de registro for atualizada, a tarefa será executada após a atualização ocorrer.
TASK_CREATE_OR_UPDATE
0x6
 O Agendador de Tarefas registra a tarefa como uma nova tarefa ou como uma versão atualizada se a tarefa já existir. Equivalente a TASK_CREATE | TASK_UPDATE.
TASK_DISABLE
0x8
 O Agendador de Tarefas desabilita a tarefa existente.
TASK_DONT_ADD_PRINCIPAL_ACE
0x10
 O Agendador de Tarefas é impedido de adicionar a ACE (entrada de controle de acesso) para a entidade de contexto. Quando a função TaskFolder.RegisterTask é chamada com esse sinalizador para atualizar uma tarefa, o serviço Agendador de Tarefas não adiciona o ACE para a nova entidade de contexto e não remove o ACE da entidade de contexto antiga.
TASK_IGNORE_REGISTRATION_TRIGGERS
0x20
 O Agendador de Tarefas cria a tarefa, mas ignora os gatilhos de registro na tarefa. Ignorando os gatilhos de registro, a tarefa não será executada quando for registrada, a menos que um gatilho baseado em tempo faça com que ela seja executada no registro.

userId [in]

As credenciais de usuário usadas para registrar a tarefa.

Observação

Se a tarefa for definida como uma tarefa do Agendador de Tarefas 1.0, não use um nome de grupo (em vez de um nome de usuário específico) neste parâmetro userId. Uma tarefa é definida como uma tarefa do Agendador de Tarefas 1.0 quando o atributo de versão do elemento Task no XML da tarefa é definido como 1.1.

password [in]

A senha da userId usada para registrar a tarefa. Quando o tipo de logon TASK_LOGON_SERVICE_ACCOUNT é usado, a senha deve ser um valor VARIANT vazio, como VT_NULL ou VT_EMPTY.

logonType [in]

Define qual técnica de logon é usada para executar a tarefa registrada.

Valor Significado
TASK_LOGON_NONE
0
 O método de logon não é especificado. Usado para credenciais não NT.
TASK_LOGON_PASSWORD
1
 Use uma senha para fazer logon no usuário. A senha deve ser fornecida no momento do registro.
TASK_LOGON_S4U
2
 Use um token interativo existente para executar uma tarefa. O usuário deve fazer logon usando um logon de serviço para usuário (S4U). Quando um logon S4U é usado, nenhuma senha é armazenada pelo sistema e não há acesso à rede ou aos arquivos criptografados.
TASK_LOGON_INTERACTIVE_TOKEN
3
 O usuário já deve estar conectado. A tarefa será executada somente em uma sessão interativa existente.
TASK_LOGON_GROUP
4
 Ativação de grupo. O campo groupId especifica o grupo.
TASK_LOGON_SERVICE_ACCOUNT
5
 Indica que uma conta de Sistema Local, Serviço Local ou Serviço de Rede está sendo usada como um contexto de segurança para executar a tarefa.
TASK_LOGON_INTERACTIVE_TOKEN_OR_PASSWORD
6
 Primeiro, use o token interativo. Se o usuário não estiver conectado (nenhum token interativo está disponível), a senha será usada. A senha deve ser especificada quando uma tarefa é registrada. Esse sinalizador não é recomendado para novas tarefas porque é menos confiável do que TASK_LOGON_PASSWORD.

sddl [in, opcional]

O descritor de segurança associado à tarefa registrada. Você pode especificar a ACL (lista de controle de acesso) no descritor de segurança de uma tarefa para permitir ou negar acesso a determinados usuários e grupos a uma tarefa.

Observação

Se a conta do Sistema Local tiver acesso negado a uma tarefa, o serviço Agendador de Tarefas poderá produzir resultados inesperados.

pTask [out]

Um objeto RegisteredTask que representa a nova tarefa.

Valor retornado

Esse método não retorna um valor.

Comentários

Para uma tarefa, que contém uma ação de caixa de mensagem, a caixa de mensagem será exibida se a tarefa for ativada e a tarefa tiver um tipo de logon interativo. Para definir o tipo de logon da tarefa como interativo, especifique 3 (TASK_LOGON_INTERACTIVE_TOKEN) ou 4 (TASK_LOGON_GROUP) na propriedade LogonType da entidade de tarefa ou no parâmetro logonType de TaskFolder.RegisterTask ou TaskFolder.RegisterTaskDefinition.

Somente um membro do grupo Administradores pode criar uma tarefa com um gatilho de inicialização.

Você pode registrar com êxito uma tarefa com um grupo especificado no parâmetro userId e 3 (TASK_LOGON_INTERACTIVE_TOKEN) especificado no parâmetro logonType de TaskFolder.RegisterTask ou TaskFolder.RegisterTaskDefinition, mas a tarefa não será executada.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 [somente aplicativos da área de trabalho]
Biblioteca de tipos
Taskschd.tlb
DLL
Taskschd.dll

Confira também

Agendador de Tarefas

RegisteredTask

TaskFolder