Prinzipalobjekt

Skriptobjekt, das die Sicherheitsanmeldeinformationen für einen Prinzipal bereitstellt. Diese Sicherheitsanmeldeinformationen definieren den Sicherheitskontext für die Aufgaben, die dem Prinzipal zugeordnet sind.

Member

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

• Eigenschaften

Eigenschaften

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

Eigenschaft	Zugriffstyp	BESCHREIBUNG
DisplayName	Lesen/Schreiben	Ruft den Namen des Prinzipals ab, der auf der Taskplaner-Benutzeroberfläche angezeigt wird, oder legt diesen fest.
Groupid	Lesen/Schreiben	Ruft den Bezeichner der Benutzergruppe ab, die zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, 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 Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, oder legt diese fest.
Runlevel	Lesen/Schreiben	Ruft den Bezeichner ab, der verwendet wird, um die Berechtigungsstufe anzugeben, die zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, oder legt diesen fest.
Userid	Lesen/Schreiben	Ruft den Benutzerbezeichner ab, der zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, oder legt diesen fest.

Bemerkungen

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

Beim Lesen oder Schreiben von XML für einen Vorgang werden die Sicherheitsanmeldeinformationen für einen Prinzipal im Prinzipalelement des Taskplanerschemas angegeben.

Wenn ein Task mit dem Befehlszeilentool at.exe registriert wird und dieses Objekt zum Abrufen von Informationen zum 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).

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