Ejemplo de desencadenador diario (scripting)

En este ejemplo de scripting se muestra cómo crear una tarea que ejecuta el Bloc de notas a las 8:00 a.m. todos los días. La tarea contiene un desencadenador diario que especifica un límite de inicio para activar el desencadenador y especificar la hora del día en que se ejecuta la tarea, un intervalo de desencadenador para especificar que la tarea se ejecuta cada día y un límite final para desactivar el desencadenador. En el ejemplo también se muestra cómo establecer un patrón de repetición para que el desencadenador repita la tarea. La tarea también contiene una acción ejecutable que ejecuta el Bloc de notas.

En el procedimiento siguiente se describe cómo programar una tarea para iniciar un ejecutable a las 8:00 a. m. todos los días. (Estos pasos corresponden a los comentarios de código incluidos en el código de ejemplo).

Para programar el Bloc de notas a partir de las 8:00 a.m. todos los días

1. Cree un objeto TaskService . Este objeto permite crear la tarea en una carpeta especificada.
2. Obtenga una carpeta de tareas y cree una tarea. Utilice el método TaskService.GetFolder para obtener la carpeta donde se almacena la tarea y el método TaskService.NewTask para crear el objeto TaskDefinition que representa la tarea.
3. Defina información sobre la tarea mediante el objeto TaskDefinition . Utilice la propiedad TaskDefinition.Settings para definir la configuración que determina cómo el servicio Programador de tareas realiza la tarea y la propiedad TaskDefinition.RegistrationInfo para definir la información que describe la tarea.
4. Cree un desencadenador diario mediante la propiedad TaskDefinition.Triggers . Esta propiedad proporciona acceso al objeto TriggerCollection que se usa para crear el desencadenador. Use el método TriggerCollection.Create (especificando el tipo de desencadenador que desea crear) para crear un desencadenador diario. Al crear el desencadenador, establezca el límite de inicio para activar el desencadenador y especifique la hora del día en que se ejecuta la tarea, el intervalo entre los días y el límite final para desactivar el desencadenador. En el ejemplo siguiente se muestra cómo establecer un patrón de repetición para que el desencadenador repita la tarea.
5. Cree una acción para que la tarea se ejecute mediante la propiedad TaskDefinition.Actions . Esta propiedad proporciona acceso al objeto ActionCollection usado para crear la acción. Use el método ActionCollection.Create para especificar el tipo de acción que desea crear. En este ejemplo se usa un objeto ExecAction , que representa una acción que ejecuta una operación de línea de comandos.
6. Registre la tarea mediante el método TaskFolder.RegisterTaskDefinition . En este ejemplo, la tarea iniciará el Bloc de notas a las 8:00 a. m. todos los días.

En el siguiente ejemplo de VBScript se muestra cómo programar una tarea para ejecutar el Bloc de notas todos los días a las 8:00 a. m.

'------------------------------------------------------------------
' This sample schedules a task to start on a daily basis.
'------------------------------------------------------------------

' A constant that specifies a daily trigger.
const TriggerTypeDaily = 2
' A constant that specifies an executable action.
const ActionTypeExec = 0

'********************************************************
' Create the TaskService object.
Set service = CreateObject("Schedule.Service")
call service.Connect()

'********************************************************
' Get a folder to create a task definition in. 
Dim rootFolder
Set rootFolder = service.GetFolder("\")

' The taskDefinition variable is the TaskDefinition object.
Dim taskDefinition
' The flags parameter is 0 because it is not supported.
Set taskDefinition = service.NewTask(0) 

'********************************************************
' Define information about the task.

' Set the registration info for the task by 
' creating the RegistrationInfo object.
Dim regInfo
Set regInfo = taskDefinition.RegistrationInfo
regInfo.Description = "Start notepad at 8:00AM daily"
regInfo.Author = "Administrator"

' Set the task setting info for the Task Scheduler by
' creating a TaskSettings object.
Dim settings
Set settings = taskDefinition.Settings
settings.Enabled = True
settings.StartWhenAvailable = True
settings.Hidden = False

'********************************************************
' Create a daily trigger. Note that the start boundary 
' specifies the time of day that the task starts and the 
' interval specifies what days the task is run.
Dim triggers
Set triggers = taskDefinition.Triggers

Dim trigger
Set trigger = triggers.Create(TriggerTypeDaily)

' Trigger variables that define when the trigger is active 
' and the time of day that the task is run. The format of 
' this time is YYYY-MM-DDTHH:MM:SS
Dim startTime, endTime

Dim time
startTime = "2006-05-02T08:00:00"  'Task runs at 8:00 AM
endTime = "2015-05-02T08:00:00"

WScript.Echo "startTime :" & startTime
WScript.Echo "endTime :" & endTime

trigger.StartBoundary = startTime
trigger.EndBoundary = endTime
trigger.DaysInterval = 1    'Task runs every day.
trigger.Id = "DailyTriggerId"
trigger.Enabled = True

' Set the task repetition pattern for the task.
' This will repeat the task 5 times.
Dim repetitionPattern
Set repetitionPattern = trigger.Repetition
repetitionPattern.Duration = "PT4M"
repetitionPattern.Interval = "PT1M"

'***********************************************************
' Create the action for the task to execute.

' Add an action to the task to run notepad.exe.
Dim Action
Set Action = taskDefinition.Actions.Create( ActionTypeExec )
Action.Path = "C:\Windows\System32\notepad.exe"

WScript.Echo "Task definition created. About to submit the task..."

'***********************************************************
' Register (create) the task.

call rootFolder.RegisterTaskDefinition( _
    "Test Daily Trigger", taskDefinition, 6, , , 3)

WScript.Echo "Task submitted."

Temas relacionados

Uso del Programador de tareas