Compartir a través de

Ejemplo de desencadenador semanal (XML)

  • Artículo

En este ejemplo, el XML define una tarea que inicia el Bloc de notas cada dos semanas.

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 cada semana el lunes a las 8:00 a.m.

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 calendario (iniciar la tarea cada dos semanas los lunes a las 8:00 a.m.) y muchas otras configuraciones de tareas que afectan la forma en que el Programador de tareas maneja la tarea.

<?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 obligatorio para los desencadenantes de calendario.

  • ScheduleByWeek

    Define la programación semanal. En este caso, el intervalo se establece para realizar la tarea cada dos semanas los 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, ejecutar el Bloc de notas).

Uso del Programador de tareas