Przykład wyzwalacza logowania (skrypty)

W tym przykładzie skryptów pokazano, jak utworzyć zadanie zaplanowane do wykonania Notatnika, gdy użytkownik loguje się. Zadanie zawiera wyzwalacz logowania, który określa granicę początkową zadania do uruchomienia i identyfikator użytkownika, który określa użytkownika. Zadanie jest rejestrowane przy użyciu grupy Administratorzy jako kontekstu zabezpieczeń do uruchomienia zadania.

W poniższej procedurze opisano sposób planowania pliku wykonywalnego, takiego jak Notatnik, aby uruchamiać się po zalogowaniu określonego użytkownika.

Aby zaplanować uruchamianie Notatnika, gdy użytkownik loguje się

1. Utwórz obiekt TaskService. Ten obiekt umożliwia utworzenie zadania w określonym folderze.
2. Pobierz folder zadania i utwórz zadanie. Użyj metody TaskService.GetFolder, aby pobrać folder, w którym jest przechowywane zadanie, oraz metodę TaskService.NewTask, aby utworzyć obiekt TaskDefinition reprezentujący zadanie.
3. Zdefiniuj informacje o zadaniu przy użyciu obiektu TaskDefinition. Użyj właściwości TaskDefinition.Settings, aby zdefiniować ustawienia określające sposób wykonywania zadania przez usługę Harmonogram zadań oraz właściwość TaskDefinition.RegistrationInfo, aby zdefiniować informacje opisujące zadanie.
4. Utwórz wyzwalacz logowania przy użyciu właściwości TaskDefinition.Triggers. Ta właściwość zapewnia dostęp do obiektu TriggerCollection. Użyj metody TriggerCollection.Create (określając typ wyzwalacza, który chcesz utworzyć), aby utworzyć wyzwalacz logowania. Podczas tworzenia wyzwalacza ustaw granicę początkową i granicę końcową wyzwalacza, aby aktywować i dezaktywować wyzwalacz. Należy ustawić właściwość UserId dla wyzwalacza, aby akcje zadania zostały zaplanowane do wykonania, gdy określony użytkownik loguje się po granicy początkowej.
5. Utwórz akcję dla zadania do wykonania przy użyciu właściwości TaskDefinition.Actions. Ta właściwość zapewnia dostęp do obiektu ActionCollection. Użyj metody ActionCollection.Create, aby określić typ akcji, którą chcesz utworzyć. W tym przykładzie użyto obiektu ExecAction, który reprezentuje akcję uruchamiającą plik wykonywalny.
6. Zarejestruj zadanie przy użyciu metody TaskFolder.RegisterTaskDefinition. W tym przykładzie zadanie jest rejestrowane tak, aby używało grupy Administratorzy jako kontekstu zabezpieczeń do uruchomienia zadania.

W poniższym przykładzie VBScript pokazano, jak zaplanować zadanie do wykonania Notatnika, gdy użytkownik loguje się.

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

Tematy pokrewne

korzystanie z harmonogramu zadań