TaskFolder.RegisterTaskDefinition-Methode
Für die Skripterstellung registriert (erstellt) eine Aufgabe an einem angegebenen Speicherort, indem das TaskDefinition-Objekt verwendet wird, um einen Task zu definieren.
Syntax
TaskFolder.RegisterTaskDefinition( _
ByVal path, _
ByVal definition, _
ByVal flags, _
ByVal userId, _
ByVal password, _
ByVal logonType, _
[ ByVal sddl ], _
ByRef task _
)
Parameter
-
pfad [ In]
-
Der Name der Aufgabe. Wenn dieser Wert Nothing ist, wird der Task im Stammaufgabeordner registriert, und der Taskname ist ein GUID-Wert, der vom Taskplaner wird.
Ein Aufgabenname kann nicht mit einem Leerzeichen beginnen oder enden. Das Zeichen "." kann nicht verwendet werden, um den aktuellen Taskordner und den "." anzugeben. -Zeichen können nicht verwendet werden, um den übergeordneten Taskordner im Pfad anzugeben.
-
Definition [ In]
-
Die Definition der Aufgabe, die registriert ist.
-
Flags [ In]
-
Eine TASK _ CREATION-Konstante.
Wert Bedeutung - AUFGABE _ VALIDATE _ ONLY
- 0x1
Der Taskplaner überprüft die Syntax des XML-Code, der den Task beschreibt, aber den Task nicht registriert. Diese Konstante kann nicht mit den Werten TASK _ CREATE, TASK _ UPDATE oder TASK CREATE OR UPDATE _ _ _ kombiniert werden. - AUFGABE _ CREATE
- 0x2
Der Taskplaner registriert die Aufgabe als neue Aufgabe. - AUFGABE _ UPDATE
- 0x4
Der Taskplaner registriert den Task als aktualisierte Version einer vorhandenen Aufgabe. Wenn eine Aufgabe mit einem Registrierungstrigger aktualisiert wird, wird die Aufgabe nach dem Update ausgeführt. - AUFGABE _ CREATE- _ ODER _ UPDATE-0x6
Der Taskplaner registriert die Aufgabe entweder als neue Aufgabe oder als aktualisierte Version, wenn die Aufgabe bereits vorhanden ist. Entspricht TASK _ CREATE | TASK _ UPDATE. - AUFGABE _ DISABLE
- 0x8
Die Taskplaner deaktiviert die vorhandene Aufgabe. - AUFGABE _ FÜGEN SIE KEINE _ _ _ PRINZIPAL-ACE-0X10
Der Taskplaner zugriffssteuerungseintrag (ACE) für den Kontextprinzipal wird nicht hinzugefügt. Wenn die TaskFolder.RegisterTaskDefinition-Funktion mit diesem Flag aufgerufen wird, um eine Aufgabe zu aktualisieren, fügt der Taskplaner-Dienst den ACE für den neuen Kontextprinzipal nicht hinzu und entfernt den ACE nicht aus dem alten Kontextprinzipal. - AUFGABE _ IGNORIEREN _ VON _ REGISTRIERUNGSTRIGGERN
- 0X20
Der Taskplaner erstellt die Aufgabe, ignoriert jedoch die Registrierungstrigger in der Aufgabe. Durch Ignorieren der Registrierungstrigger wird die Aufgabe nicht ausgeführt, wenn sie registriert wird, es sei denn, ein zeitbasierter Trigger bewirkt, dass sie bei der Registrierung ausgeführt wird. -
userId [ In]
-
Die Benutzeranmeldeinformationen, die zum Registrieren der Aufgabe verwendet werden. Falls vorhanden, haben diese Anmeldeinformationen Vorrang vor den Anmeldeinformationen, die im Aufgabendefinitionsobjekt angegeben sind, auf das der Definitionsparameter verweist.
Hinweis
Wenn die Aufgabe als Taskplaner 1.0-Aufgabe definiert ist, verwenden Sie keinen Gruppennamen (statt eines bestimmten Benutzernamens) in diesem userId-Parameter. Ein Task wird als Taskplaner 1.0-Aufgabe definiert, wenn die Compatibility-Eigenschaft in den Einstellungen des Task auf 1 festgelegt ist.
-
Kennwort [ In]
-
Das Kennwort für die userId, die zum Registrieren der Aufgabe verwendet wird. Wenn der Anmeldetyp TASK LOGON SERVICE ACCOUNT verwendet wird, muss das Kennwort ein leerer VARIANT-Wert wie _ _ _ VT _ NULL oder VT _ EMPTY sein.
-
logonType [ In]
-
Definiert, welche Anmeldetechnik zum Ausführen der registrierten Aufgabe verwendet wird.
Wert Bedeutung - AUFGABE _ LOGON _ NONE
- 0
Die Anmeldemethode ist nicht angegeben. Wird für Nicht-NT-Anmeldeinformationen verwendet. - AUFGABE _ _ANMELDEKENNWORT
- 1
Verwenden Sie ein Kennwort für die Benutzerprotokollierung. Das Kennwort muss zum Zeitpunkt der Registrierung angegeben werden. - AUFGABE _ LOGON _ S4U
- 2
Verwenden Sie ein vorhandenes interaktives Token, um eine Aufgabe auszuführen. Der Benutzer muss sich mit einem Dienst für die Benutzeranmeldung (S4U) anmelden. Wenn eine S4U-Anmeldung verwendet wird, wird kein Kennwort vom System gespeichert, und es besteht kein Zugriff auf das Netzwerk oder auf verschlüsselte Dateien. - AUFGABE _ INTERAKTIVES _ TOKEN FÜR DIE _ ANMELDUNG
- 3
Der Benutzer muss bereits angemeldet sein. Die Aufgabe wird nur in einer vorhandenen interaktiven Sitzung ausgeführt. - AUFGABE _ LOGON _ GROUP
- 4
Gruppenaktivierung. Das Feld groupId gibt die Gruppe an. - AUFGABE _ _ _ ANMELDEDIENSTKONTO
- 5
Gibt an, dass ein lokales Systemkonto, ein lokaler Dienst oder ein Netzwerkdienstkonto als Sicherheitskontext zum Ausführen der Aufgabe verwendet wird. - AUFGABE _ INTERAKTIVES _ TOKEN ODER KENNWORT FÜR DIE _ _ _ ANMELDUNG
- 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 als TASK _ LOGON _ PASSWORD ist. -
sddl [ in, optional]
-
Der Sicherheitsdeskriptor, der dem registrierten Task 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 ermöglichen oder zu verweigern.
Hinweis
Wenn dem lokalen Systemkonto der Zugriff auf eine Aufgabe verweigert wird, kann Taskplaner Dienst zu unerwarteten Ergebnissen führen.
-
Aufgabe [ out]
-
Ein RegisteredTask-Objekt, das die neue Aufgabe darstellt.
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Hinweise
Für eine Aufgabe, die eine Meldungsfeldaktion enthält, wird das Meldungsfeld angezeigt, wenn der Task aktiviert ist und der Task über einen interaktiven Anmeldetyp verfügt. Um den Taskanmeldungstyp 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 mit einer Gruppe registrieren, die im userId-Parameter und 3 (TASK _ LOGON _ INTERACTIVE _ TOKEN) angegeben ist, die im logonType-Parameter von TaskFolder.RegisterTask oder TaskFolder.RegisterTaskDefinition angegeben ist. Die Aufgabe wird jedoch nicht ausgeführt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Typbibliothek |
|
| DLL |
|