Starttriggerbeispiel (Skripterstellung)

In diesem Skriptbeispiel wird gezeigt, wie Sie eine Aufgabe erstellen, die beim Starten des Systems für die Ausführung von Editor geplant ist. Der Task enthält einen Starttrigger, der eine Startgrenze und eine Verzögerungszeit für den Start des Tasks angibt, nachdem das System gestartet wurde. Der Task enthält auch eine Aktion, die den Task angibt, der Editor ausgeführt werden soll. Die Aufgabe wird mithilfe des Lokalen Dienstkontos als Sicherheitskontext zum Ausführen der Aufgabe registriert.

Im folgenden Verfahren wird beschrieben, wie Sie eine ausführbare Datei wie Editor so planen, dass sie gestartet wird, wenn das System gestartet wird.

So planen Sie den Start von Editor, wenn das System gestartet wird

1. Erstellen Sie ein TaskService-Objekt . Mit diesem Objekt können Sie die Aufgabe in einem angegebenen Ordner erstellen.
2. Rufen Sie einen Aufgabenordner ab, und erstellen Sie eine Aufgabe. Verwenden Sie die TaskService.GetFolder-Methode , um den Ordner abzurufen, in dem die Aufgabe gespeichert ist, und die TaskService.NewTask-Methode , um das TaskDefinition-Objekt zu erstellen, das den Task darstellt.
3. Definieren Sie Informationen zum Task mithilfe des TaskDefinition-Objekts . Verwenden Sie die TaskDefinition.Settings-Eigenschaft , um die Einstellungen zu definieren, die bestimmen, wie der Taskplaner-Dienst die Aufgabe ausführt, und die TaskDefinition.RegistrationInfo-Eigenschaft , um die Informationen zu definieren, die den Vorgang beschreiben.
4. Erstellen Sie mithilfe der TaskDefinition.Triggers-Eigenschaft einen Anmeldetrigger. Diese Eigenschaft bietet Zugriff auf das TriggerCollection-Objekt . Verwenden Sie die TriggerCollection.Create-Methode (geben Sie den Typ des Triggers an, den Sie erstellen möchten), um einen Starttrigger zu erstellen. Legen Sie beim Erstellen des Triggers die Eigenschaften StartBoundary und EndBoundary des Triggers fest, um den Trigger zu aktivieren und zu deaktivieren. Sie können auch einen Wert für die Delay-Eigenschaft des Starttriggers angeben.
5. Erstellen Sie mithilfe der TaskDefinition.Actions-Eigenschaft eine Aktion für die auszuführende Aufgabe. Diese Eigenschaft ermöglicht den Zugriff auf das ActionCollection-Objekt . Verwenden Sie die ActionCollection.Create-Methode , um den Typ der Aktion anzugeben, die Sie erstellen möchten. In diesem Beispiel wird ein ExecAction-Objekt verwendet, das eine Aktion darstellt, die eine ausführbare Datei startet.
6. Registrieren Sie den Task mithilfe der TaskFolder.RegisterTaskDefinition-Methode . Die Aufgabe wird mithilfe des Lokalen Dienstkontos als Sicherheitskontext zum Ausführen der Aufgabe registriert.

Das folgende VBScript-Beispiel zeigt, wie Sie eine Aufgabe so planen, dass Editor 30 Sekunden nach dem Start des Systems ausgeführt wird.

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

Zugehörige Themen

Verwenden des Aufgabenplanungsmoduls