Exemple de déclencheur d’inscription (script)

Cet exemple de script montre comment créer une tâche dont l’exécution du Bloc-notes est planifiée lors de l’inscription d’une tâche. La tâche contient un déclencheur d’inscription qui spécifie une limite de début et une limite de fin pour la tâche. La limite de démarrage spécifie quand le déclencheur est activé. La tâche contient également une action qui spécifie la tâche à exécuter dans le Bloc-notes.

Notes

Lorsqu’une tâche avec un déclencheur d’inscription est mise à jour, la tâche s’exécute une fois la mise à jour effectuée.

 

La procédure suivante décrit comment planifier le démarrage d’un exécutable tel que le Bloc-notes lorsqu’une tâche est inscrite.

Pour planifier le démarrage du Bloc-notes lorsqu’une tâche est inscrite

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’inscription à 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 d’inscription.
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 .

L’exemple VBScript suivant montre comment créer une tâche qui planifie l’exécution du Bloc-notes lorsque la tâche est inscrite.

'---------------------------------------------------------
' This sample schedules a task to start notepad.exe when
' the task is registered.
'---------------------------------------------------------

' A constant that specifies a registration trigger.
const TriggerTypeRegistration = 7
' 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 = "Start Notepad when the task is registered."
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 registration trigger.
Dim triggers
Set triggers = taskDefinition.Triggers

Dim trigger
Set trigger = triggers.Create(TriggerTypeRegistration)

trigger.ExecutionTimeLimit = "PT5M"    'Five minutes
trigger.Id = "RegistrationTriggerId"   

'***********************************************************
' 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.

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

WScript.Echo "Task submitted."

Rubriques connexes

Utilisation du planificateur de tâches