Ejemplo de desencadenador semanal (XML)

  • Artículo

El XML de este ejemplo define una tarea que inicia el Bloc de notas de forma bi-semanal.

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 el nombre de la tarea definition>/tn<.>

Para definir una tarea para iniciar el Bloc de notas cada semana el lunes a las 8:00 a.m.

En el ejemplo XML siguiente se muestra cómo definir una tarea con una sola acción de ejecución (a partir del Bloc de notas), un único desencadenador de calendario (inicia la tarea cada otra semana el lunes a las 8:00 a.m.) y varias otras opciones de configuración de tareas que afectan a cómo controla la tarea el Programador de tareas.

<?xml version="1.0" ?>
<!--
This sample schedules a task to start on a bi-weekly basis.
-->
<Task xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
    <RegistrationInfo>
        <Date>2005-05-01T09:00:00</Date>
        <Author>AuthorName</Author>
        <Version>1.0.0</Version>
        <Description>Notepad starts every other week on Monday at 8:00am.</Description>
    </RegistrationInfo>
    <Triggers>
        <CalendarTrigger>
            <StartBoundary>2005-05-02T08:00:00</StartBoundary>
            <EndBoundary>2006-01-01T00:00:00</EndBoundary>
            <ScheduleByWeek>
                <WeeksInterval>2</WeeksInterval>
                <DaysOfWeek>
                    <Monday/>
                </DaysOfWeek>
            </ScheduleByWeek>
        </CalendarTrigger>
    </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

Estos son algunos elementos importantes que se deben tener en cuenta al usar este ejemplo.

  • RegistrationInfo

    Contiene información de registro sobre la tarea.

  • Desencadenadores

    Define el desencadenador que inicia la tarea.

  • CalendarTrigger

    Define el desencadenador de calendario semanal. En este caso, solo se usan cuatro elementos secundarios: los límites de inicio y finalización que especifican cuándo se activa y desactiva el desencadenador, la programación semanal y los días de la semana en que se ejecutará la tarea. El elemento StartBoundary es un elemento necesario para los desencadenadores de calendario.

  • ScheduleByWeek

    Define la programación semanal. En este caso, el intervalo se establece para realizar la tarea cada otra semana el lunes.

  • Principal

    Define el contexto de seguridad en el que se ejecuta una tarea.

  • Configuración

    Define la configuración de tareas que usa el Programador de tareas para realizar la tarea.

  • Acciones

    Define las acciones que realiza la tarea (en este caso, ejecutando el Bloc de notas).

Uso del Programador de tareas