Partager via

Exemple de déclencheur d’ouverture de session (script)

  • Article

Cet exemple de script montre comment créer une tâche qui est planifiée pour exécuter le Bloc-notes lorsqu’un utilisateur se connecte. La tâche contient un déclencheur d’ouverture de session qui spécifie une limite de démarrage pour la tâche à démarrer et un identificateur d’utilisateur qui spécifie l’utilisateur. La tâche est inscrite à l’aide du groupe Administrateurs 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 lorsqu’un utilisateur spécifié se connecte.

Pour planifier le démarrage du Bloc-notes lorsqu’un utilisateur se connecte

  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 d’ouverture de session. Lorsque vous créez le déclencheur, définissez la limite de début et la limite de fin du déclencheur pour activer et désactiver le déclencheur. Vous devez définir la propriété UserId pour le déclencheur afin que les actions de la tâche soient planifiées pour s’exécuter lorsque l’utilisateur spécifié se connecte après la limite de début.
  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 . Cet exemple inscrit la tâche afin qu’elle utilise le groupe Administrateurs comme contexte de sécurité pour exécuter la tâche.

L’exemple VBScript suivant montre comment planifier une tâche pour exécuter le Bloc-notes lorsqu’un utilisateur se connecte.

'---------------------------------------------------------
' This sample schedules a task to start notepad.exe when a user logs on.
'---------------------------------------------------------

' A constant that specifies a logon trigger.
const TriggerTypeLogon = 9
' 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 a " & _
    "specified user logs on."
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 logon trigger.
Dim triggers
Set triggers = taskDefinition.Triggers

Dim trigger
Set trigger = triggers.Create(TriggerTypeLogon)

' 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 = "LogonTriggerId"
trigger.UserId = "DOMAIN\UserName"   ' Must be a valid user account   

'***********************************************************
' 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 Logon Trigger", taskDefinition, createOrUpdateTask, _
    "Builtin\Administrators", , 4)

WScript.Echo "Task submitted."

Utilisation du planificateur de tâches