Exemplo de gatilho de registro (XML)

  • Artigo

O XML neste exemplo define uma tarefa que começa Bloco de notas quando a tarefa é registrada.

Para registrar uma tarefa definida em XML, você pode usar a função ITaskFolder::RegisterTask (TaskFolder.RegisterTask para script) ou a ferramenta de linha de comando Schtasks.exe. Se você usar a ferramenta Schtasks.exe (localizada no diretório C:\Windows\System32), poderá usar o seguinte comando para registrar a tarefa: schtasks /create /XMLpath<para o arquivo XML que contém o nome da definição> de tarefa/tntask<.>

Observação

Quando uma tarefa com um gatilho de registro é atualizada, a tarefa será executada depois que a atualização ocorrer.

 

Para definir uma tarefa para iniciar Bloco de notas no registro

O exemplo XML a seguir mostra como definir uma tarefa com uma única ação de execução (começando Bloco de notas), um único gatilho de registro que inicia a tarefa quando ela é registrada e várias outras configurações de tarefa que afetam como a tarefa é tratada pelo Agendador de Tarefas.

Observação

Quando uma tarefa com um gatilho de registro é atualizada, a tarefa será executada depois que a atualização ocorrer.

 

<?xml version="1.0" ?>
<!--
This sample schedules a task to start notepad.exe when
the task is registered.
-->
<Task xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
    <RegistrationInfo>
        <Date>2005-10-11T13:21:17-08:00</Date>
        <Author>AuthorName</Author>
        <Version>1.0.0</Version>
        <Description>Task starts after registration.</Description>
    </RegistrationInfo>
    <Triggers>
        <RegistrationTrigger>
        </RegistrationTrigger>
    </Triggers>
    <Principals>
        <Principal>
            <UserId>Administrator</UserId>
            <LogonType>InteractiveToken</LogonType>
        </Principal>
    </Principals>
    <Settings>
        <Enabled>true</Enabled>
        <AllowStartOnDemand>true</AllowStartOnDemand>
        <AllowHardTerminate>true</AllowHardTerminate>
    </Settings>
    <Actions>
        <Exec>
            <Command>notepad.exe</Command>
        </Exec>
    </Actions>
</Task>

Elementos de esquema TaskScheduler

Aqui estão alguns elementos importantes para ter em mente ao usar este exemplo.

  • RegistrationInfo: contém informações de registro sobre a tarefa.
  • Gatilhos: define o gatilho que inicia a tarefa.
  • RegistrationTrigger: define o gatilho de registro. Nesse caso, apenas dois elementos filho são usados: os limites de início e término que especificam quando o gatilho é ativado e desativado.
  • Principal: define o contexto de segurança no qual uma tarefa é executada.
  • Configurações: define as configurações de tarefa que o Agendador de Tarefas usa para executar a tarefa.
  • Ações: define as ações executadas pela tarefa. Nesse caso, executando Bloco de notas.

Usando o agendador de tarefas