Exemple de déclencheur de démarrage (script)

Cet exemple de script montre comment créer une tâche dont l’exécution du Bloc-notes est planifiée lors du démarrage du système. La tâche contient un déclencheur de démarrage qui spécifie une limite de démarrage et un délai de démarrage de la tâche après le démarrage du système. La tâche contient également une action qui spécifie la tâche à exécuter dans le Bloc-notes. La tâche est inscrite à l’aide du compte de service local comme contexte de sécurité pour exécuter la tâche.

La procédure suivante décrit comment planifier le démarrage d’un exécutable tel que le Bloc-notes lorsque le système est démarré.

Pour planifier le démarrage du Bloc-notes lorsque le système est démarré

1. Créez un objet TaskService . Cet objet vous permet de créer la tâche dans un dossier spécifié.
2. Obtenez un dossier de tâches et créez une tâche. Utilisez la méthode TaskService.GetFolder pour obtenir le dossier dans lequel la tâche est stockée et la méthode TaskService.NewTask pour créer l’objet TaskDefinition qui représente la tâche.
3. Définissez des informations sur la tâche à l’aide de l’objet TaskDefinition . Utilisez la propriété TaskDefinition.Settings pour définir les paramètres qui déterminent la façon dont le service Planificateur de tâches effectue la tâche et la propriété TaskDefinition.RegistrationInfo pour définir les informations qui décrivent la tâche.
4. Créez un déclencheur d’ouverture de session à l’aide de la propriété TaskDefinition.Triggers . Cette propriété permet d’accéder à l’objet TriggerCollection . Utilisez la méthode TriggerCollection.Create (en spécifiant le type de déclencheur que vous souhaitez créer) pour créer un déclencheur de démarrage. Lorsque vous créez le déclencheur, définissez les propriétés StartBoundary et EndBoundary du déclencheur pour activer et désactiver le déclencheur. Vous pouvez également spécifier une valeur pour la propriété Delay du déclencheur de démarrage.
5. Créez une action pour que la tâche s’exécute à l’aide de la propriété TaskDefinition.Actions . Cette propriété permet d’accéder à l’objet ActionCollection . Utilisez la méthode ActionCollection.Create pour spécifier le type d’action que vous souhaitez créer. Cet exemple utilise un objet ExecAction , qui représente une action qui démarre un exécutable.
6. Inscrivez la tâche à l’aide de la méthode TaskFolder.RegisterTaskDefinition . La tâche est inscrite à l’aide du compte de service local comme contexte de sécurité pour exécuter la tâche.

L’exemple VBScript suivant montre comment planifier l’exécution d’une tâche du Bloc-notes 30 secondes après le démarrage du système.

'---------------------------------------------------------
' This sample schedules a task to start notepad.exe 30 seconds after
' the system is booted.
'---------------------------------------------------------

' A constant that specifies a boot trigger.
const TriggerTypeBoot = 8
' A constant that specifies an executable action.
const ActionTypeExecutable = 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 = "Task will execute Notepad when " & _
    "the computer is booted."
regInfo.Author = "Author Name"

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

'********************************************************
' Create a boot trigger.
Dim triggers
Set triggers = taskDefinition.Triggers

Dim trigger
Set trigger = triggers.Create(TriggerTypeBoot)

' Trigger variables that define when the trigger is active.
Dim startTime, endTime
startTime = "2006-05-02T10:49:02"
endTime = "2006-05-02T10:52:02"

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

trigger.StartBoundary = startTime
trigger.EndBoundary = endTime
trigger.ExecutionTimeLimit = "PT5M"    ' Five minutes
trigger.Id = "BootTriggerId"
trigger.Delay = "PT30S"                ' 30 Seconds   

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

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

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

'***********************************************************
' Register (create) the task.
const createOrUpdateTask = 6
call rootFolder.RegisterTaskDefinition( _
    "Test Boot Trigger", taskDefinition, createOrUpdateTask, _
    "Local Service", , 5)

WScript.Echo "Task submitted."

Rubriques connexes

Utilisation du planificateur de tâches