TaskFolder.RegisterTask-Methode

Artikel
06/13/2023

Für die Skripterstellung registriert (erstellt) eine neue Aufgabe im Ordner mithilfe von XML, um die Aufgabe zu definieren.

Syntax

TaskFolder.RegisterTask( _
  ByVal path, _
  ByVal xmlText, _
  ByVal flags, _
  ByVal userId, _
  ByVal password, _
  ByVal logonType, _
  [ ByVal sddl ], _
  ByRef pTask _
)

Parameter

Pfad [in]

Der Name der Aufgabe. Wenn dieser Wert Nothing ist, wird der Task im Stammtaskordner registriert, und der Vorgangsname ist ein GUID-Wert, der vom Taskplanerdienst erstellt wird.

Ein Aufgabenname kann nicht mit einem Leerzeichen beginnen oder enden. Das Zeichen "." kann nicht verwendet werden, um den aktuellen Aufgabenordner und den "." anzugeben. Zeichen können nicht verwendet werden, um den übergeordneten Aufgabenordner im Pfad anzugeben.

xmlText [in]

Eine XML-formatierte Beschreibung der Aufgabe.

Die folgenden Themen enthalten Aufgaben, die mithilfe von XML definiert wurden.

Flags [in]

Eine TASK_CREATION Konstante.

Wert	Bedeutung
TASK_VALIDATE_ONLY 0x1	Der Aufgabenplaner überprüft die Syntax des XML-Codes, der die Aufgabe beschreibt, den Task jedoch nicht registriert. Diese Konstante kann nicht mit den werten TASK_CREATE, TASK_UPDATE oder TASK_CREATE_OR_UPDATE kombiniert werden.
TASK_CREATE 0x2	Der Aufgabenplaner registriert die Aufgabe als neue Aufgabe.
TASK_UPDATE 0x4	Der Aufgabenplaner registriert den Task als aktualisierte Version einer vorhandenen Aufgabe. Wenn eine Aufgabe mit einem Registrierungstrigger aktualisiert wird, wird der Task nach dem Update ausgeführt.
TASK_CREATE_OR_UPDATE 0x6	Der Aufgabenplaner registriert die Aufgabe entweder als neue Aufgabe oder als aktualisierte Version, wenn der Task bereits vorhanden ist. Entspricht TASK_CREATE \| TASK_UPDATE.
TASK_DISABLE 0x8	Der Aufgabenplaner deaktiviert die vorhandene Aufgabe.
TASK_DONT_ADD_PRINCIPAL_ACE 0x10	Der Aufgabenplaner wird daran gehindert, den Zugriffssteuerungseintrag zulassen (ACE) für den Kontextprinzipal hinzuzufügen. Wenn die TaskFolder.RegisterTask-Funktion mit diesem Flag aufgerufen wird, um eine Aufgabe zu aktualisieren, fügt der Taskplanerdienst den ACE für den neuen Kontextprinzipal nicht hinzu und entfernt den ACE nicht aus dem alten Kontextprinzipal.
TASK_IGNORE_REGISTRATION_TRIGGERS 0x20	Der Taskplaner erstellt den Task, ignoriert jedoch die Registrierungstrigger im Task. Durch Ignorieren der Registrierungstrigger wird der Task nicht ausgeführt, wenn er registriert wird, es sei denn, ein zeitbasierter Trigger bewirkt, dass er bei der Registrierung ausgeführt wird.

userId [in]

Die Benutzeranmeldeinformationen, die zum Registrieren der Aufgabe verwendet werden.

Hinweis

Wenn der Task als Taskplaner 1.0-Aufgabe definiert ist, verwenden Sie in diesem userId-Parameter keinen Gruppennamen (anstelle eines bestimmten Benutzernamens). Eine Aufgabe wird als Taskplaner 1.0-Aufgabe definiert, wenn das Versionsattribute des Task-Elements im XML-Code des Vorgangs auf 1.1 festgelegt ist.

Kennwort [in]

Das Kennwort für die userId, die zum Registrieren der Aufgabe verwendet wird. Wenn der TASK_LOGON_SERVICE_ACCOUNT Anmeldetyp verwendet wird, muss das Kennwort ein leerer VARIANT-Wert sein, z. B. VT_NULL oder VT_EMPTY.

logonType [in]

Definiert, welche Anmeldetechnik zum Ausführen der registrierten Aufgabe verwendet wird.

Wert	Bedeutung
TASK_LOGON_NONE 0	Die Anmeldemethode wird nicht angegeben. Wird für Nicht-NT-Anmeldeinformationen verwendet.
TASK_LOGON_PASSWORD 1	Verwenden Sie ein Kennwort für die Protokollierung für den Benutzer. Das Kennwort muss zum Zeitpunkt der Registrierung angegeben werden.
TASK_LOGON_S4U 2	Verwenden Sie ein vorhandenes interaktives Token, um einen Task auszuführen. Der Benutzer muss sich mit einer S4U-Anmeldung (Service for User) anmelden. Wenn eine S4U-Anmeldung verwendet wird, wird kein Kennwort vom System gespeichert, und es gibt keinen Zugriff auf das Netzwerk oder auf verschlüsselte Dateien.
TASK_LOGON_INTERACTIVE_TOKEN 3	Der Benutzer muss bereits angemeldet sein. Der Task wird nur in einer vorhandenen interaktiven Sitzung ausgeführt.
TASK_LOGON_GROUP 4	Gruppenaktivierung. Das Feld groupId gibt die Gruppe an.
TASK_LOGON_SERVICE_ACCOUNT 5	Gibt an, dass ein Lokales System-, lokales Dienst- oder Netzwerkdienstkonto als Sicherheitskontext zum Ausführen der Aufgabe verwendet wird.
TASK_LOGON_INTERACTIVE_TOKEN_OR_PASSWORD 6	Verwenden Sie zunächst das interaktive Token. Wenn der Benutzer nicht angemeldet ist (kein interaktives Token verfügbar), wird das Kennwort verwendet. Das Kennwort muss angegeben werden, wenn eine Aufgabe registriert wird. Dieses Flag wird für neue Aufgaben nicht empfohlen, da es weniger zuverlässig ist als TASK_LOGON_PASSWORD.

sddl [in, optional]

Der Sicherheitsdeskriptor, der der registrierten Aufgabe zugeordnet ist. Sie können die Zugriffssteuerungsliste (Access Control List, ACL) im Sicherheitsdeskriptor für eine Aufgabe angeben, um bestimmten Benutzern und Gruppen den Zugriff auf eine Aufgabe zu erlauben oder zu verweigern.

Hinweis

Wenn dem Lokalen Systemkonto der Zugriff auf eine Aufgabe verweigert wird, kann der Aufgabenplanungsdienst unerwartete Ergebnisse erzeugen.

pTask [out]

Ein RegisteredTask-Objekt , das die neue Aufgabe darstellt.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Bei einer Aufgabe, die eine Meldungsfeldaktion enthält, wird das Meldungsfeld angezeigt, wenn die Aufgabe aktiviert ist und der Vorgang über einen interaktiven Anmeldetyp verfügt. Um den Vorgangsanmeldungstyp auf interaktiv festzulegen, geben Sie 3 (TASK_LOGON_INTERACTIVE_TOKEN) oder 4 (TASK_LOGON_GROUP) in der LogonType-Eigenschaft des Aufgabenprinzipals oder im logonType-Parameter von TaskFolder.RegisterTask oder TaskFolder.RegisterTaskDefinition an.

Nur ein Mitglied der Gruppe Administratoren kann eine Aufgabe mit einem Starttrigger erstellen.

Sie können eine Aufgabe erfolgreich bei einer Gruppe registrieren, die im Parameter userId und 3 (TASK_LOGON_INTERACTIVE_TOKEN) angegeben ist, der im parameter logonType von TaskFolder.RegisterTask oder TaskFolder.RegisterTaskDefinition angegeben ist. Der Task wird jedoch nicht ausgeführt.

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

Siehe auch

Aufgabenplanung
RegisteredTask
TaskFolder