RegisteredTask-Objekt

Skriptobjekt, das die Methoden bereitstellt, die verwendet werden, um den Task sofort auszuführen, alle ausgeführten Instanzen des Vorgangs abzurufen, die Anmeldeinformationen abzurufen oder festzulegen, die zum Registrieren des Vorgangs verwendet werden, und die Eigenschaften, die die Aufgabe beschreiben.

Member

Das RegisteredTask-Objekt verfügt über die folgenden Membertypen:

• Methoden
• Eigenschaften

Methoden

Das RegisteredTask-Objekt verfügt über diese Methoden.

Methode	BESCHREIBUNG
Getinstances	Gibt alle Instanzen des registrierten Tasks zurück, die derzeit ausgeführt werden.
GetRunTimes	Ruft die Zeiten ab, zu denen die Ausführung des registrierten Tasks während eines angegebenen Zeitraums geplant ist.
GetSecurityDescriptor	Ruft den Sicherheitsdeskriptor ab, der als Anmeldeinformationen für den registrierten Task verwendet wird.
Ausführung	Führt den registrierten Task sofort aus.
RunEx	Führt den registrierten Task sofort mit angegebenen Flags und einem Sitzungsbezeichner aus.
SetSecurityDescriptor	Legt den Sicherheitsdeskriptor fest, der als Anmeldeinformationen für die registrierte Aufgabe verwendet wird.
Stoppen	Beendet den registrierten Task sofort.

Eigenschaften

Das RegisteredTask-Objekt verfügt über diese Eigenschaften.

Eigenschaft	Zugriffstyp	BESCHREIBUNG
Definition	Schreibgeschützt	Ruft die Definition der Aufgabe ab.
Aktiviert	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, ob der registrierte Task aktiviert ist, oder legt diesen fest.
LastRunTime	Schreibgeschützt	Ruft den Zeitpunkt ab, zu dem der registrierte Task zuletzt ausgeführt wurde.
LastTaskResult	Schreibgeschützt	Ruft die Ergebnisse ab, die beim letzten Ausführen der registrierten Aufgabe zurückgegeben wurden.
Name	Schreibgeschützt	Ruft den Namen der registrierten Aufgabe ab.
NextRunTime	Schreibgeschützt	Ruft den Zeitpunkt ab, zu dem die ausführung des registrierten Tasks als nächstes geplant ist.
NumberOfMissedRuns	Schreibgeschützt	Ruft ab, wie oft der registrierte Task eine geplante Ausführung verpasst hat.
Pfad	Schreibgeschützt	Ruft den Pfad ab, in dem die registrierte Aufgabe gespeichert ist.
State	Schreibgeschützt	Ruft den Betriebsstatus der registrierten Aufgabe ab.
XML	Schreibgeschützt	Ruft die IM XML-formatierten Registrierungsinformationen für den registrierten Task ab.

Beispiele

Weitere Informationen und Beispielcode für dieses Skriptobjekt finden Sie unter Time Trigger Example (Scripting) and Displaying Task Names and States (Scripting).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Typbibliothek	Taskschd.tlb
DLL	Taskschd.dll