Freigeben über


UserPrincipal Klasse

Definition

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)

Gilt für: