Exemplo de gatilho de logon (XML)

O XML neste exemplo define uma tarefa que inicia o Bloco de Notas quando um usuário faz logon.

Para registrar uma tarefa definida em XML, você pode usar a função ITaskFolder::RegisterTask (TaskFolder.RegisterTask para scripting) 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 /XML<caminho para o arquivo XML que contém a definição de tarefa>/tn<nome da tarefa>.

Para definir uma tarefa para iniciar o Bloco de Notas na inicialização do sistema

O exemplo XML a seguir mostra como definir uma tarefa com uma única ação de execução (iniciando o Bloco de Notas), um único gatilho de logon que inicia a tarefa quando um usuário faz logon e várias outras configurações de tarefa que afetam como a tarefa é tratada pelo Agendador de Tarefas.

<?xml version="1.0" ?>
<!--
This sample schedules a task to start notepad.exe when a user logs on.
-->
<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>Starts Notepad when a specified user logs on.</Description>
    </RegistrationInfo>
    <Triggers>
        <LogonTrigger>
            <StartBoundary>2005-10-11T13:21:17-08:00</StartBoundary>
            <EndBoundary>2006-01-01T00:00:00-08:00</EndBoundary>
            <Enabled>true</Enabled>
            <UserId>DOMAIN_NAME\UserName</UserId>
        </LogonTrigger>
    </Triggers>
    <Principals>
        <Principal>
            <GroupId>Builtin\Administrators</GroupId>
        </Principal>
    </Principals>
    <Settings>
        <Enabled>true</Enabled>
        <AllowStartOnDemand>true</AllowStartOnDemand>
        <AllowHardTerminate>true</AllowHardTerminate>
    </Settings>
    <Actions>
        <Exec>
            <Command>notepad.exe</Command>
        </Exec>
    </Actions>
</Task>

Elementos do esquema TaskScheduler

A seguir estão alguns elementos importantes a ter em mente ao usar este exemplo:

• RegistrationInfo: Contém informações de registro sobre a tarefa.
• Triggers: Define o gatilho que inicia a tarefa.
• LogonTrigger: Define o gatilho de logon. Nesse caso, três elementos filho são usados: os limites de início e fim que especificam quando o gatilho é ativado e desativado e o UserId elemento identificador do usuário. A tarefa é iniciada quando este utilizador inicia sessão no computador..
• Principal: Define o contexto de segurança sob o 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 que a tarefa executa. Nesse caso, executando o Bloco de Notas.

Tópicos relacionados

Usando o Agendador de Tarefas