Principal-Objekt

Skripterstellungsobjekt, das die Sicherheitsanmeldeinformationen für einen Prinzipal enthält. Diese Sicherheitsanmeldeinformationen definieren den Sicherheitskontext für die Aufgaben, die dem Prinzipal zugeordnet sind.

Members

Das Principal-Objekt verfügt über die folgenden Typen von Membern:

Eigenschaften

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

Eigenschaft Zugriffstyp BESCHREIBUNG
Displayname
Lesen/Schreiben
Ruft den Namen des Prinzipals ab, der in der Benutzeroberfläche des Taskplaner wird, oder legt diesen fest.
Groupid
Lesen/Schreiben
Ruft den Bezeichner der Benutzergruppe ab, die zum Ausführen der dem Prinzipal zugeordneten Aufgaben erforderlich ist, oder legt diesen fest.
Id
Lesen/Schreiben
Ruft den Bezeichner des Prinzipals ab oder legt ihn fest.
LogonType
Lesen/Schreiben
Ruft die Sicherheitsanmeldungsmethode ab, die zum Ausführen der dem Prinzipal zugeordneten Aufgaben erforderlich ist, oder legt diese fest.
Runlevel
Lesen/Schreiben
Ruft den Bezeichner ab, mit dem die Berechtigungsebene angegeben wird, die zum Ausführen der dem Prinzipal zugeordneten Aufgaben erforderlich ist, oder legt diesen fest.
Userid
Lesen/Schreiben
Ruft den Benutzerbezeichner ab, der zum Ausführen der dem Prinzipal zugeordneten Aufgaben erforderlich ist, oder legt diesen fest.

Bemerkungen

Denken Sie beim Angeben eines Kontos daran, den doppelten zurücken Schrägstrich im Code ordnungsgemäß zu verwenden, um die Domäne und den Benutzernamen anzugeben. Verwenden Sie beispielsweise DOMAIN \ \ UserName, um einen Wert für die UserId-Eigenschaft anzugeben.

Beim Lesen oder Schreiben von XML für eine Aufgabe werden die Sicherheitsanmeldeinformationen für einen Prinzipal im Principal-Element des Taskplaner angegeben.

Wenn eine Aufgabe mit dem at.exe-Befehlszeilentool registriert wird und dieses Objekt zum Abrufen von Informationen über den Task verwendet wird, gibt die LogonType-Eigenschaft 0 zurück, die RunLevel-Eigenschaft gibt 0 zurück, und die UserId-Eigenschaft gibt Nothing zurück.

Beispiele

Weitere Informationen und Beispielcode für dieses Skriptobjekt finden Sie unter Time Trigger Example (Scripting) .

Requirements (Anforderungen)

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