Compartir a través de

Ejemplo de desencadenador de inicio de sesión (XML)

  • Artículo

En este ejemplo, el XML define una tarea que inicia el Bloc de notas cuando un usuario inicia sesión.

Para registrar una tarea definida en XML, puede usar la función ITaskFolder::RegisterTask (TaskFolder.RegisterTask para scripting) o la herramienta de línea de comandos Schtasks.exe. Si usa la herramienta Schtasks.exe (ubicada en el directorio C:\Windows\System32), puede usar el siguiente comando para registrar la tarea: schtasks /create /XML <ruta de acceso al archivo XML que contiene la definición de la tarea> /tn <nombre de la tarea>.

Definir una tarea para iniciar el Bloc de notas en el arranque del sistema

El siguiente ejemplo XML muestra cómo definir una tarea con una sola acción de ejecución (iniciar del Bloc de notas), un único desencadenador de inicio de sesión que inicia la tarea cuando un usuario inicia sesión y muchas otras configuraciones de tareas que afectan la forma en que el Programador de tareas maneja la tarea.

Nota:

Establezca el valor del elemento UserId en un nombre de usuario en el equipo en el que esté registrada la tarea.

 

<?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 de esquema TaskScheduler

A continuación se presentan algunos elementos importantes a tener en cuenta al utilizar este ejemplo:

  • RegistrationInfo: contiene información de registro sobre la tarea.
  • Triggers: define el desencadenador que inicia la tarea.
  • LogonTrigger: define el desencadenador de inicio de sesión. En este caso, se usan tres elementos secundarios: los límites de inicio y finalización que especifican cuándo se activa y desactiva el desencadenador y el elemento UserId que identifica al usuario. La tarea se inicia cuando este usuario inicia sesión en el equipo.
  • Principal: define el contexto de seguridad en el que se ejecuta una tarea.
  • Settings: define la configuración de la tarea que usa el Programador de tareas para realizar la tarea.
  • Actions: define las acciones que realiza la tarea. En este caso, ejecutar el Bloc de notas.

Uso del Programador de tareas