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
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 |
|
| DLL |
|