Compartir vía

Ejemplo de desencadenador de tiempo (XML)

  • Artículo

En este ejemplo, el XML define una tarea que inicia el Bloc de notas en un momento específico.

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 un momento específico

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 tiempo que inicia la tarea en un tiempo específico 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 notepad.exe at a specific time.
-->
<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 at a specified time.</Description>
    </RegistrationInfo>
    <Triggers>
        <TimeTrigger>
            <StartBoundary>2005-10-11T13:21:17-08:00</StartBoundary>
            <EndBoundary>2006-01-01T00:00:00-08:00</EndBoundary>
            <Enabled>true</Enabled>
            <ExecutionTimeLimit>PT5M</ExecutionTimeLimit>
        </TimeTrigger>
    </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

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.
  • TimeTrigger: define el desencadenador de tiempo. 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 límite de tiempo de ejecución que especifica la cantidad máxima de tiempo en la que el disparador puede iniciar la tarea. El elemento StartBoundary es un elemento obligatorio para los desencadenantes de tiempo.
  • 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.
  • Acciones: define las acciones que realiza la tarea (en este caso, ejecutar el Bloc de notas).

Uso del Programador de tareas