Freigeben über

Aufgabenaktionen

  • Artikel

Die arbeitsaufgaben, die von einer Aufgabe ausgeführt werden, werden als Aktionen bezeichnet. Eine Aufgabe kann eine einzelne Aktion oder maximal 32 Aktionen aufweisen. Beachten Sie, dass sie, wenn mehrere Aktionen angegeben werden, sequenziell ausgeführt werden.

Aktionstypen

In der folgenden Tabelle mit Aktionen wird die Art der Arbeit oder Aktionen beschrieben, die von einer Aufgabe ausgeführt werden können.

Aktionstyp Beschreibung
ComHandler-Aktion Diese Aktion löst einen COM-Handler aus.
Exec-Aktion Diese Aktion führt einen Befehlszeilenvorgang aus, z. B. das Starten des Editors.
E-Mail-Aktion Diese Aktion sendet eine E-Mail, wenn eine Aufgabe ausgelöst wird.
Nachrichtenaktion anzeigen Diese Aktion zeigt ein Meldungsfeld mit einer angegebenen Nachricht und einem angegebenen Titel an.

Angeben von Aktionen

Die Aktionen eines Vorgangs werden angegeben, wenn der Vorgang definiert und in einer Sammlung von Aktionen gespeichert wird, die vom Aufgabenplanerdienst verwendet werden. In der folgenden Tabelle sind Links zu Referenzthemen für die APIs und XML-Elemente aufgeführt, die Aktionen zugeordnet sind.

Weitere Informationen und Beispiele zur Verwendung der Aufgabenplanungsschnittstellen, Skriptobjekte und XML finden Sie unter Using the Task Scheduler.

Schnittstellen-APIs für die C++-Entwicklung

API Beschreibung
Actions-Eigenschaft von ITaskDefinition Dient zum Abrufen oder Festlegen der Aktionen, die von der Aufgabe ausgeführt werden.
IActionCollection- Enthält die Aktionen, die von der Aufgabe ausgeführt werden.
IComHandlerAction- Stellt eine Aktion dar, die einen Handler ausgelöst.
IExecAction- Stellt eine Aktion dar, die einen Befehlszeilenvorgang ausführt.
IEmailAction- Stellt eine Aktion dar, die eine E-Mail-Nachricht sendet.
IShowMessageAction- Stellt eine Aktion dar, die ein Meldungsfeld anzeigt.

Skripting-Objekt-APIs für die Skriptentwicklung

API Beschreibung
TaskDefinition.Actions- Dient zum Abrufen oder Festlegen der Aktionen, die von der Aufgabe ausgeführt werden.
ActionCollection- Enthält die Aktionen, die von der Aufgabe ausgeführt werden.
ComHandlerAction- Stellt eine Aktion dar, die einen Handler ausgelöst.
ExecAction- Stellt eine Aktion dar, die einen Befehlszeilenvorgang ausführt.
EmailAction- Stellt eine Aktion dar, die eine E-Mail-Nachricht sendet.
ShowMessageAction- Stellt eine Aktion dar, die ein Meldungsfeld anzeigt.

XML-Elemente

Element Beschreibung
Aktionen Definiert die von der Aufgabe ausgeführten Aktionen.
ComHandler- Stellt eine Aktion dar, die einen Handler ausgelöst.
Exec- Stellt eine Aktion dar, die einen Befehlszeilenvorgang ausführt.
SendEmail- Stellt eine Aktion dar, die eine E-Mail-Nachricht sendet.
ShowMessage- Stellt eine Aktion dar, die ein Meldungsfeld anzeigt.

Verwenden von Variablen in Aktionseigenschaften

Einige Aktionseigenschaften vom Typ BSTR- können $(Arg0), $(Arg1), ..., $(Arg32)-Variablen in ihren Zeichenfolgenwerten enthalten. Diese Variablen werden durch die Werte ersetzt, die im Params Parameter des IRegisteredTask::Run und IRegisteredTask::RunEx Methoden angegeben werden oder innerhalb des Ereignistriggers für die Aufgabe enthalten sind. In der folgenden Tabelle sind die Aktionseigenschaften aufgeführt, die Variablen in ihren Zeichenfolgenwerten verwenden können.

Aktion Eigenschaften
COM-Handleraktion C++:
Skripterstellung:
E-Mail-Aktion C++:
Skripterstellung:
Exec-Aktion C++:
Skripterstellung:
Nachrichtenaktion anzeigen C++:
Skripterstellung:

Über den Taskplaner-