Taskfolder. RegisterTask-Methode
Bei der Skripterstellung (erstellt) eine neue Aufgabe im Ordner mithilfe von XML zum Definieren der Aufgabe.
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 auf " Nothing" festgelegt ist, wird die Aufgabe im Stamm Aufgaben Ordner registriert, und der TaskName ist ein GUID-Wert, der vom Taskplaner-Dienst erstellt wird.
Ein Taskname darf nicht mit einem Leerzeichen beginnen oder enden. Das Zeichen "." kann nicht verwendet werden, um den aktuellen Aufgaben Ordner und ".." anzugeben. Zeichen können nicht verwendet werden, um den übergeordneten Aufgaben Ordner 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 Aufgaben _ Erstellungs Konstante.
Wert Bedeutung - Aufgabe _ _Nur
- 0x1 validieren
Der Taskplaner überprüft die Syntax des XML-Codes, der den Task beschreibt, registriert jedoch nicht den Task. Diese Konstante kann nicht mit den Werten Create _ , Task _ Update oder Task _ Create _ oder _ Update kombiniert werden. - Aufgabe _
- 0x2 erstellen
Der Taskplaner die den Task als neue Aufgabe registriert. - Aufgabe _ Update
- 0x4
Der Taskplaner registriert den Task als aktualisierte Version eines vorhandenen Tasks. Wenn eine Aufgabe mit einem Registrierungs-ausgelöst wird, wird die Aufgabe ausgeführt, nachdem das Update ausgeführt wurde. - Aufgabe _ 0x6 erstellen _ oder _ Aktualisieren
Der Taskplaner registriert den Task entweder als neue Aufgabe oder als aktualisierte Version, wenn der Task bereits vorhanden ist. Entspricht der Aufgabe zum _ Erstellen von | Aufgaben _ Aktualisierungen. - Aufgabe _
- 0x8 deaktivieren
Mit dem Taskplaner wird die vorhandene Aufgabe deaktiviert. - Aufgabe _ _ _ Prinzipal- _ ACE
- 0x10 nicht hinzufügen
Der Taskplaner wird verhindert, dass der ACE (Access Control Entry, ACE) für den Kontext Prinzipal hinzugefügt wird. Wenn die taskfolder. RegisterTask -Funktion mit diesem Flag aufgerufen wird, um eine Aufgabe zu aktualisieren, fügt der Taskplaner-Dienst nicht den ACE für den neuen Kontext Prinzipal hinzu und entfernt den ACE nicht aus dem alten Kontext Prinzipal. - Aufgabe _ _Registrierungs _ Trigger ignorieren
- 0x20
Der Taskplaner erstellt die Aufgabe, ignoriert jedoch die Registrierungs Trigger in der Aufgabe. Durch das Ignorieren der Registrierungs Trigger wird die Aufgabe nicht ausgeführt, wenn Sie registriert wird, es sei denn, ein zeitbasierter Trigger führt die Ausführung bei der Registrierung aus. -
Benutzer-ID [ in]
-
Die Benutzer Anmelde Informationen, 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). Ein Task wird als Taskplaner 1,0-Aufgabe definiert, wenn das Versions Attribut des Task-Elements im XML-Code der Aufgabe auf 1,1 festgelegt ist.
-
Kennwort [ in]
-
Das Kennwort für die Benutzer-ID, die zum Registrieren der Aufgabe verwendet wird. Wenn der _ _ Anmeldetyp für das Anmeldedienst _ Konto verwendet wird, muss das Kennwort ein leerer Variant -Wert wie z. b. VT _ null oder VT _ empty sein.
-
logontype [ in]
-
Definiert, welche Anmelde Methode verwendet wird, um die registrierte Aufgabe auszuführen.
Wert Bedeutung - Aufgabe _ Login _ None
- 0
Die Anmelde Methode ist nicht angegeben. Wird für nicht-NT-Anmelde Informationen verwendet. - Aufgabe _ Anmelde _ Kennwort
- 1
Verwenden Sie ein Kennwort für die Anmeldung für den Benutzer. Das Kennwort muss beim Registrierungs Zeitpunkt angegeben werden. - Aufgabe _ Anmeldung _ S4U
- 2
Verwenden Sie ein vorhandenes interaktives Token, um eine Aufgabe auszuführen. Der Benutzer muss sich mithilfe eines Diensts für die Benutzeranmeldung (S4U) anmelden. Wenn eine S4U-Anmeldung verwendet wird, wird kein Kennwort vom System gespeichert, und es gibt keinen Zugriff auf das Netzwerk oder verschlüsselte Dateien. - Aufgabe _ _Interaktives Anmelde _ Token
- 3
Der Benutzer muss bereits angemeldet sein. Der Task wird nur in einer vorhandenen interaktiven Sitzung ausgeführt. - Aufgabe _ Anmelde _ Gruppe
- 4
Gruppen Aktivierung. Das Feld GroupID gibt die Gruppe an. - Aufgabe _ Anmelde _ Dienst _ Konto
- 5
Gibt an, dass ein lokales System, ein lokaler Dienst oder ein Netzwerkdienst Konto als Sicherheitskontext zum Ausführen des Tasks verwendet wird. - Aufgabe _ _Interaktives _ Token _ oder _ Kennwort für die Anmeldung
- 6
Verwenden Sie zuerst das interaktive Token. Wenn der Benutzer nicht angemeldet ist (kein interaktives Token verfügbar), wird das Kennwort verwendet. Das Kennwort muss angegeben werden, wenn ein Task registriert wird. Dieses Flag wird für neue Aufgaben nicht empfohlen, da es weniger zuverlässig ist als das Kennwort für die Task _ Anmeldung _ . -
SDDL [ in, optional]
-
Die Sicherheits Beschreibung, die der registrierten Aufgabe zugeordnet ist. Sie können die Zugriffs Steuerungs Liste (ACL) in der Sicherheits Beschreibung für eine Aufgabe angeben, um bestimmten Benutzern und Gruppen den Zugriff auf eine Aufgabe zu gewähren oder zu verweigern.
Hinweis
Wenn dem lokalen System Konto der Zugriff auf eine Aufgabe verweigert wird, kann der Taskplaner Dienst unerwartete Ergebnisse liefern.
-
pTask [ vorgenommen]
-
Ein registeredtask -Objekt, das die neue Aufgabe darstellt.
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Bemerkungen
Für einen Task, der eine MessageBox-Aktion enthält, wird das Meldungs Feld angezeigt, wenn die Aufgabe aktiviert ist und der Task einen interaktiven Anmeldetyp aufweist. Wenn Sie den Anmeldetyp für die Aufgabe interaktiv festlegen möchten, geben Sie in der logontype -Eigenschaft des Task Prinzipals oder im logontype -Parameter von taskfolder. RegisterTask oder taskfolder. RegisterTaskDefinitionden Wert 3 an._ _ _****_ _
Nur ein Mitglied der Gruppe "Administratoren" kann eine Aufgabe mit einem Start--Vorgang erstellen.
Sie können eine Aufgabe erfolgreich mit einer Gruppe registrieren, die im UserID -Parameter angegeben ist, und 3 (_ _ interaktives Anmelde _ Token für die Aufgabe), das im logontype -Parameter von Task Folder. RegisterTask oder taskfolder. RegisterTaskDefinitionangegeben ist, die Aufgabe jedoch nicht ausgeführt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Nur Windows Vista [ -Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nur Windows Server 2008 [ -Desktop-Apps] |
| Typbibliothek |
|
| DLL |
|