UserPrincipal Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Kapselt Prinzipale, die Benutzerkonten darstellen.
public ref class UserPrincipal : System::DirectoryServices::AccountManagement::AuthenticablePrincipal
[System.DirectoryServices.AccountManagement.DirectoryRdnPrefix("CN")]
public class UserPrincipal : System.DirectoryServices.AccountManagement.AuthenticablePrincipal
[System.DirectoryServices.AccountManagement.DirectoryRdnPrefix("CN")]
[System.Security.SecurityCritical(System.Security.SecurityCriticalScope.Everything)]
public class UserPrincipal : System.DirectoryServices.AccountManagement.AuthenticablePrincipal
[<System.DirectoryServices.AccountManagement.DirectoryRdnPrefix("CN")>]
type UserPrincipal = class
inherit AuthenticablePrincipal
[<System.DirectoryServices.AccountManagement.DirectoryRdnPrefix("CN")>]
[<System.Security.SecurityCritical(System.Security.SecurityCriticalScope.Everything)>]
type UserPrincipal = class
inherit AuthenticablePrincipal
Public Class UserPrincipal
Inherits AuthenticablePrincipal
- Vererbung
- Attribute
Konstruktoren
UserPrincipal(PrincipalContext) |
Initialisiert eine neue Instanz der UserPrincipal-Klasse unter Verwendung des angegebenen Kontexts. |
UserPrincipal(PrincipalContext, String, String, Boolean) |
Initialisiert eine neue Instanz der UserPrincipal-Klasse unter Verwendung des angegebenen Kontexts, des angegebenen SAM-Kontonamens, des angegebenen Kennworts sowie des aktivierten Werts. |
Eigenschaften
AccountExpirationDate |
Ruft einen DateTime-Wert ab, der das Datum und die Uhrzeit angibt, zu der das Konto abläuft, und NULL-Werte zulässt, oder legt diesen fest. (Geerbt von AuthenticablePrincipal) |
AccountLockoutTime |
Ruft einen DateTime-Wert ab, der das Datum und die Uhrzeit angibt, zu der das Konto gesperrt wurde, und der NULL-Werte zulässt, oder legt diesen fest. (Geerbt von AuthenticablePrincipal) |
AdvancedSearchFilter |
Gibt ein AdvancedFilters-Objekt zurück, um schreibgeschützte Eigenschaften festzulegen, bevor das Objekt an PrincipalSearcher übergeben wird. |
AllowReversiblePasswordEncryption |
Ruft einen booleschen Wert ab, der angibt, ob die umkehrbare Kennwortverschlüsselung für das Konto aktiviert wurde, oder legt diesen fest. (Geerbt von AuthenticablePrincipal) |
BadLogonCount |
Ruft die Anzahl der Anmeldeversuche für das Konto ab, bei denen fehlerhafte Anmeldeinformationen verwendet wurden. (Geerbt von AuthenticablePrincipal) |
Certificates |
Ruft eine X509Certificate2Collection ab, die die X509-Zertifikate für das Konto enthält. (Geerbt von AuthenticablePrincipal) |
Context |
Ruft einen Prinzipalkontext ab, der mit dem Prinzipal verknüpft ist. (Geerbt von Principal) |
ContextRaw |
Ruft einen Prinzipalkontext ab, der mit diesem Prinzipal verknüpft ist. (Geerbt von Principal) |
ContextType |
Ruft den Enumerationswert für den Kontexttyp ab, der den Kontexttyp des Prinzipals angibt, der mit diesem Prinzipal verknüpft ist. (Geerbt von Principal) |
Current |
Ruft ein Benutzerprinzipalobjekt ab, das den aktuellen Benutzer darstellt, unter dem der Thread ausgeführt wird. |
DelegationPermitted |
Ruft einen booleschen Wert ab, der angibt, ob das Konto delegiert werden kann und NULL-Werte zulässt, oder legt diesen fest. (Geerbt von AuthenticablePrincipal) |
Description |
Ruft die Beschreibung des Prinzipals ab oder legt diese fest. (Geerbt von Principal) |
DisplayName |
Ruft den Anzeigenamen für den Prinzipal ab oder legt diesen fest. (Geerbt von Principal) |
DistinguishedName |
Ruft den Distinguished Name (DN) für diesen Prinzipal ab. (Geerbt von Principal) |
EmailAddress |
Ruft die E-Mail-Adresse für dieses Konto ab oder legt diese fest. |
EmployeeId |
Ruft die Mitarbeiter-ID für diesen Benutzerprinzipal ab oder legt diese fest. |
Enabled |
Ruft einen booleschen Wert ab, der angibt, ob eine Authentifizierung für das Konto möglich und der NULL-Werte zulässt, oder legt diesen fest. (Geerbt von AuthenticablePrincipal) |
GivenName |
Ruft den angegebenen Namen für den Benutzerprinzipal ab oder legt diesen fest. |
Guid |
Ruft die GUID ab, die mit diesem Prinzipal verknüpft ist. (Geerbt von Principal) |
HomeDirectory |
Ruft das Basisverzeichnis für das Konto ab oder legt dieses fest. (Geerbt von AuthenticablePrincipal) |
HomeDrive |
Ruft das Basislaufwerk für das Konto ab oder legt dieses fest. (Geerbt von AuthenticablePrincipal) |
LastBadPasswordAttempt |
Ruft den DateTime-Wert ab, der das Datum und die Uhrzeit der letzten fehlerhaften Kennworteingabe für das Konto angibt und der NULL sein kann. (Geerbt von AuthenticablePrincipal) |
LastLogon |
Ruft den DateTime-Wert ab, der das Datum und die Uhrzeit der letzten Anmeldung für das Konto angibt und der NULL sein kann. (Geerbt von AuthenticablePrincipal) |
LastPasswordSet |
Ruft den DateTime-Wert ab, der das letzte Datum und die letzte Uhrzeit angibt, zu der das Kennwort für das Konto festgelegt wurde, und der NULL sein kann. (Geerbt von AuthenticablePrincipal) |
MiddleName |
Ruft den zweiten Vornamen für den Benutzerprinzipal ab oder legt diesen fest. |
Name |
Ruft den Namen des Prinzipals ab oder legt diesen fest. (Geerbt von Principal) |
PasswordNeverExpires |
Ruft einen booleschen Wert ab, der angibt, ob das Kennwort für das Konto abläuft, oder legt diesen fest. (Geerbt von AuthenticablePrincipal) |
PasswordNotRequired |
Ruft einen booleschen Wert ab, der angibt, ob ein Kennwort für das Konto erforderlich ist, oder legt diesen fest. (Geerbt von AuthenticablePrincipal) |
PermittedLogonTimes |
Ruft die Zeiten ab, zu denen sich der Prinzipal anmelden kann, oder legt diese fest. (Geerbt von AuthenticablePrincipal) |
PermittedWorkstations |
Ruft die Liste der Arbeitsstationen ab, bei denen sich der Prinzipal anmelden kann. (Geerbt von AuthenticablePrincipal) |
SamAccountName |
Ruft den SAM-Kontonamen für den Prinzipal ab oder legt diesen fest. (Geerbt von Principal) |
ScriptPath |
Ruft den Skriptpfad für das Konto ab oder legt diesen fest. (Geerbt von AuthenticablePrincipal) |
Sid |
Ruft die Sicherheits-ID (SID) des Prinzipals ab. (Geerbt von Principal) |
SmartcardLogonRequired |
Ruft einen booleschen Wert ab, der angibt, ob eine SmartCard für die Anmeldung bei dem Konto erforderlich ist, oder legt diesen fest. (Geerbt von AuthenticablePrincipal) |
StructuralObjectClass |
Ruft das Verzeichnisattribut der strukturellen Objektklasse ab. (Geerbt von Principal) |
Surname |
Ruft den Nachnamen des Benutzerprinzipals ab oder legt diesen fest. |
UserCannotChangePassword |
Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob der Benutzer das Kennwort für dieses Konto ändern kann. Verwenden Sie dies nicht mit einem ComputerPrincipal. (Geerbt von AuthenticablePrincipal) |
UserPrincipalName |
Ruft den diesem Prinzipal zugeordneten Benutzerprinzipalnamen (User Principal Name, UPN) ab, oder legt diesen fest. (Geerbt von Principal) |
VoiceTelephoneNumber |
Ruft die Telefonnummer für den Benutzerprinzipal ab oder legt diese fest. |
Methoden
ChangePassword(String, String) |
Ändert das Kontokennwort vom alten in das neue Kennwort. Verwenden Sie dies nicht mit einem ComputerPrincipal. (Geerbt von AuthenticablePrincipal) |
CheckDisposedOrDeleted() |
Bestimmt, ob die Dispose()-Methode oder Delete()-Methode für diese Klasse aufgerufen wurde. Diese Methode wird von Klassen aufgerufen, die von der Prinzipalklasse abgeleitet werden. (Geerbt von Principal) |
Delete() |
Löscht das Prinzipalobjekt aus dem Speicher. (Geerbt von Principal) |
Dispose() |
Verwirft die aktuelle Instanz des Principal-Objekts. (Geerbt von Principal) |
Equals(Object) |
Gibt einen booleschen Wert zurück, der angibt, ob das bereitgestellte Objekt gleich dem aktuellen Objekt ist. (Geerbt von Principal) |
ExpirePasswordNow() |
Lässt das Kennwort für das Konto ablaufen. Dies zwingt den Benutzer, das Kennwort bei der nächsten Anmeldung zu ändern. (Geerbt von AuthenticablePrincipal) |
ExtensionGet(String) |
Ruft ein Attribut eines erweiterten Klassenobjekts ab. (Geerbt von Principal) |
ExtensionSet(String, Object) |
Legt den Wert eines Attributs in einer erweiterten Klasse fest. (Geerbt von Principal) |
FindByBadPasswordAttempt(PrincipalContext, DateTime, MatchType) |
Gibt eine Sammlung von PrincipalSearchResult<T>-Objekten für Benutzer zurück, für die ein Anmeldeversuch mit ungültigem Kennwort im angegebenen Datums- und Uhrzeitbereich aufgezeichnet ist. |
FindByExpirationTime(PrincipalContext, DateTime, MatchType) |
Gibt eine Sammlung von PrincipalSearchResult<T>-Objekten für Benutzer zurück, die eine Kontoablaufzeit im angegebenen Datums- und Uhrzeitbereich aufweisen. |
FindByIdentity(PrincipalContext, IdentityType, String) |
Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht. Diese Version der FindByIdentity-Methode bestimmt das Format des Identitätswerts. |
FindByIdentity(PrincipalContext, String) |
Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätswert entspricht. |
FindByLockoutTime(PrincipalContext, DateTime, MatchType) |
Gibt eine Sammlung von PrincipalSearchResult<T>-Objekten für Benutzer zurück, die eine Kontosperrzeit im angegebenen Datums- und Uhrzeitbereich aufweisen. |
FindByLogonTime(PrincipalContext, DateTime, MatchType) |
Gibt eine Sammlung von PrincipalSearchResult<T>-Objekten für Benutzer zurück, für die eine Kontoanmeldung im angegebenen Datums- und Uhrzeitbereich aufgezeichnet wurde. |
FindByPasswordSetTime(PrincipalContext, DateTime, MatchType) |
Gibt eine Sammlung von PrincipalSearchResult<T>-Objekten für Benutzer zurück, die ihr Kennwort im angegebenen Datums- und Uhrzeitbereich festgelegt haben. |
GetAuthorizationGroups() |
Gibt eine Sammlung von Prinzipalobjekten zurück, die alle Autorisierungsgruppen enthält, in denen dieser Benutzer Member ist. Diese Funktion gibt nur Gruppen zurück, die Sicherheitsgruppen sind; Verteilergruppen werden nicht zurückgegeben. |
GetGroups() |
Gibt eine Auflistung von Gruppenobjekten zurück, die die Gruppen angeben, deren Member der aktuelle Prinzipal ist. (Geerbt von Principal) |
GetGroups(PrincipalContext) |
Gibt eine Auflistung von Gruppenobjekten zurück, deren Member der Prinzipal ist und die im Speicher vorhanden sind, der vom angegebenen Kontextparameter bereitgestellt wird. (Geerbt von Principal) |
GetHashCode() |
Ruft den Hashcode für den Inhalt des Prinzipalobjekts ab, der für die Verwendung in Hashalgorithmen und Hashdatenstrukturen geeignet ist, z. B. in einer Hashtabelle. (Geerbt von Principal) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
GetUnderlyingObject() |
Gibt das zugrunde liegende DirectoryEntry-Objekt zurück, das die Kontaktdaten für das Prinzipalobjekt bereitstellt. (Geerbt von Principal) |
GetUnderlyingObjectType() |
Gibt den zugrunde liegenden Objekttyp zurück. (Geerbt von Principal) |
IsAccountLockedOut() |
Gibt einen booleschen Wert zurück, der angibt, ob das Konto zurzeit gesperrt ist. (Geerbt von AuthenticablePrincipal) |
IsMemberOf(GroupPrincipal) |
Gibt einen booleschen Wert zurück, der angibt, ob der Prinzipal ein Member der angegebenen Gruppe ist. (Geerbt von Principal) |
IsMemberOf(PrincipalContext, IdentityType, String) |
Gibt einen booleschen Wert zurück, der angibt, ob der Prinzipal ein Member der Gruppe ist, die durch den Identitätstyp und den Identitätswert angegeben wird. (Geerbt von Principal) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
RefreshExpiredPassword() |
Aktualisiert ein abgelaufenes Kennwort. (Geerbt von AuthenticablePrincipal) |
Save() |
Speichert die Änderungen, die am Prinzipalobjekt des Speichers vorgenommen wurden. Wenn es sich dabei um ein neues Prinzipalobjekt handelt, fügt diese Methode es in den Speicher ein. (Geerbt von Principal) |
Save(PrincipalContext) |
Speichert die Änderungen, die am Prinzipalobjekt des Speichers vorgenommen wurden. Wenn es sich dabei um ein neues Prinzipalobjekt handelt, fügt diese Methode es in den angegebenen Kontext ein. Wenn der Prinzipal bereits beibehalten wurde, wird er aus dem ursprünglichen Kontext in den angegebenen Kontext verschoben. (Geerbt von Principal) |
SetPassword(String) |
Legt das Kennwort auf den angegebenen Wert fest. (Geerbt von AuthenticablePrincipal) |
ToString() |
Gibt eine benutzerfreundliche Zeichenfolgendarstellung des aktuellen Prinzipalobjekts zurück. (Geerbt von Principal) |
UnlockAccount() |
Entsperrt das Konto gegebenenfalls. (Geerbt von AuthenticablePrincipal) |