AuthenticablePrincipal AuthenticablePrincipal AuthenticablePrincipal AuthenticablePrincipal Class

Definition

Kapselt die gemeinsamen Konto- und Kontaktdaten für Prinzipale, die authentifiziert werden können.Encapsulates the account and contact data common to principals that can be authenticated.

public ref class AuthenticablePrincipal : System::DirectoryServices::AccountManagement::Principal
[System.DirectoryServices.AccountManagement.DirectoryRdnPrefix("CN")]
[System.Security.SecurityCritical(System.Security.SecurityCriticalScope.Everything)]
public class AuthenticablePrincipal : System.DirectoryServices.AccountManagement.Principal
type AuthenticablePrincipal = class
    inherit Principal
Public Class AuthenticablePrincipal
Inherits Principal
Vererbung
AuthenticablePrincipalAuthenticablePrincipalAuthenticablePrincipalAuthenticablePrincipal
Abgeleitet
Attribute

Konstruktoren

AuthenticablePrincipal(PrincipalContext) AuthenticablePrincipal(PrincipalContext) AuthenticablePrincipal(PrincipalContext) AuthenticablePrincipal(PrincipalContext)

Initialisiert eine neue Instanz der AuthenticablePrincipal-Klasse unter Verwendung des angegebenen Kontexts.Initializes a new instance of the AuthenticablePrincipal class by using the specified context. Dieser Konstruktor wird von Konstruktoren für abgeleitete Klassen aufgerufen, um die Basisklasse zu initialisieren. Eine unmittelbare Verwendung im Code ist nicht vorgesehen.This constructor is called by derived-class constructors to initialize the base class and is not intended for use directly from your code.

AuthenticablePrincipal(PrincipalContext, String, String, Boolean) AuthenticablePrincipal(PrincipalContext, String, String, Boolean) AuthenticablePrincipal(PrincipalContext, String, String, Boolean) AuthenticablePrincipal(PrincipalContext, String, String, Boolean)

Initialisiert eine neue Instanz der AuthenticablePrincipal-Klasse unter Verwendung des angegebenen Kontexts, des angegebenen SAM-Kontonamens, des angegebenen Kennworts sowie des aktivierten Werts.Initializes a new instance of the AuthenticablePrincipal class by using the specified context, SAM account name, password, and enabled value. Dieser Konstruktor wird von Konstruktoren für abgeleitete Klassen aufgerufen, um die Basisklasse zu initialisieren. Eine unmittelbare Verwendung im Code ist nicht vorgesehen.This constructor is called by derived-class constructors to initialize the base class and is not intended for use directly from your code.

Eigenschaften

AccountExpirationDate AccountExpirationDate AccountExpirationDate 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.Gets or sets a Nullable DateTime that specifies the date and time that the account expires.

AccountLockoutTime AccountLockoutTime AccountLockoutTime 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.Gets the Nullable DateTime that specifies the date and time that the account was locked out.

AdvancedSearchFilter AdvancedSearchFilter AdvancedSearchFilter AdvancedSearchFilter

Gibt ein AdvancedFilters-Objekt für Query By Example zurück, um schreibgeschützte Eigenschaften vor dem Übergeben des Objekts an PrincipalSearcher festzulegen.Returns an AdvancedFilters object for use with Query By Example to set read-only properties before passing the object to the PrincipalSearcher.

AllowReversiblePasswordEncryption AllowReversiblePasswordEncryption AllowReversiblePasswordEncryption AllowReversiblePasswordEncryption

Ruft einen booleschen Wert ab, der angibt, ob die umkehrbare Kennwortverschlüsselung für das Konto aktiviert wurde, oder legt diesen fest.Gets or sets a Boolean value that specifies whether reversible password encryption is enabled for this account.

BadLogonCount BadLogonCount BadLogonCount BadLogonCount

Ruft die Anzahl der Anmeldeversuche für das Konto ab, bei denen fehlerhafte Anmeldeinformationen verwendet wurden.Gets the number of logon attempts using incorrect credentials for this account.

Certificates Certificates Certificates Certificates

Ruft eine X509Certificate2Collection ab, die die X509-Zertifikate für das Konto enthält.Gets a X509Certificate2Collection that contains the X509 certificates for this account.

Context Context Context Context

Ruft einen Prinzipalkontext ab, der mit dem Prinzipal verknüpft ist.Gets a principal context that is associated with the principal.

(Inherited from Principal)
ContextRaw ContextRaw ContextRaw ContextRaw

Ruft einen Prinzipalkontext ab, der mit diesem Prinzipal verknüpft ist.Gets a principal context that is associated with this principal.

(Inherited from Principal)
ContextType ContextType ContextType ContextType

Ruft den Enumerationswert für den Kontexttyp ab, der den Kontexttyp des Prinzipals angibt, der mit diesem Prinzipal verknüpft ist.Gets the context type enumeration value that specifies the type of principal context associated with this principal.

(Inherited from Principal)
DelegationPermitted DelegationPermitted DelegationPermitted DelegationPermitted

Ruft einen booleschen Wert ab, der angibt, ob das Konto delegiert werden kann und NULL-Werte zulässt, oder legt diesen fest.Gets or sets a Nullable Boolean value that specifies whether the account may be delegated.

Description Description Description Description

Ruft die Beschreibung des Prinzipals ab oder legt diese fest.Gets or sets the description of the principal.

(Inherited from Principal)
DisplayName DisplayName DisplayName DisplayName

Ruft den Anzeigenamen für den Prinzipal ab oder legt diesen fest.Gets or sets the display name for this principal.

(Inherited from Principal)
DistinguishedName DistinguishedName DistinguishedName DistinguishedName

Ruft den Distinguished Name (DN) für diesen Prinzipal ab.Gets the distinguished name (DN) for this principal.

(Inherited from Principal)
Enabled Enabled Enabled 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.Gets or sets a Nullable Boolean value that specifies whether this account is enabled for authentication.

Guid Guid Guid Guid

Ruft die GUID ab, die mit diesem Prinzipal verknüpft ist.Gets the GUID associated with this principal.

(Inherited from Principal)
HomeDirectory HomeDirectory HomeDirectory HomeDirectory

Ruft das Basisverzeichnis für das Konto ab oder legt dieses fest.Gets or sets the home directory for this account.

HomeDrive HomeDrive HomeDrive HomeDrive

Ruft das Basislaufwerk für das Konto ab oder legt dieses fest.Gets or sets the home drive for this account.

LastBadPasswordAttempt LastBadPasswordAttempt LastBadPasswordAttempt 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.Gets the Nullable DateTime that specifies the date and time of the last incorrect password attempt on this account.

LastLogon LastLogon LastLogon 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.Gets the Nullable DateTime that specifies the date and time of the last logon for this account.

LastPasswordSet LastPasswordSet LastPasswordSet 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.Gets the Nullable DateTime that specifies the last date and time that the password was set for this account.

Name Name Name Name

Ruft den Namen des Prinzipals ab oder legt diesen fest.Gets or sets the name of this principal.

(Inherited from Principal)
PasswordNeverExpires PasswordNeverExpires PasswordNeverExpires PasswordNeverExpires

Ruft einen booleschen Wert ab, der angibt, ob das Kennwort für das Konto abläuft, oder legt diesen fest.Gets or sets a Boolean value that specifies whether the password expires for this account.

PasswordNotRequired PasswordNotRequired PasswordNotRequired PasswordNotRequired

Ruft einen booleschen Wert ab, der angibt, ob ein Kennwort für das Konto erforderlich ist, oder legt diesen fest.Gets or sets a Boolean value that specifies whether a password is required for this account.

PermittedLogonTimes PermittedLogonTimes PermittedLogonTimes PermittedLogonTimes

Ruft die Zeiten ab, zu denen sich der Prinzipal anmelden kann, oder legt diese fest.Gets or sets the times when the principal can logon.

PermittedWorkstations PermittedWorkstations PermittedWorkstations PermittedWorkstations

Ruft die Liste der Arbeitsstationen ab, bei denen sich der Prinzipal anmelden kann.Gets the list of workstations that this principal is permitted to log into.

SamAccountName SamAccountName SamAccountName SamAccountName

Ruft den SAM-Kontonamen für den Prinzipal ab oder legt diesen fest.Gets or sets the SAM account name for this principal.

(Inherited from Principal)
ScriptPath ScriptPath ScriptPath ScriptPath

Ruft den Skriptpfad für das Konto ab oder legt diesen fest.Gets or sets the script path for this account.

Sid Sid Sid Sid

Ruft die Sicherheits-ID (SID) des Prinzipals ab.Gets the Security ID (SID) of the principal.

(Inherited from Principal)
SmartcardLogonRequired SmartcardLogonRequired SmartcardLogonRequired SmartcardLogonRequired

Ruft einen booleschen Wert ab, der angibt, ob eine SmartCard für die Anmeldung bei dem Konto erforderlich ist, oder legt diesen fest.Gets or sets a Boolean value that specifies whether a smartcard is required to log on to the account.

StructuralObjectClass StructuralObjectClass StructuralObjectClass StructuralObjectClass

Ruft das Verzeichnisattribut der strukturellen Objektklasse ab.Gets the structural object class directory attribute.

(Inherited from Principal)
UserCannotChangePassword UserCannotChangePassword UserCannotChangePassword UserCannotChangePassword

Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob der Benutzer das Kennwort für dieses Konto ändern kann.Gets or sets a Boolean value that specifies whether the user can change the password for this account. Verwenden Sie diese nicht mit einem ComputerPrincipal.Do not use this with a ComputerPrincipal.

UserPrincipalName UserPrincipalName UserPrincipalName UserPrincipalName

Ruft den diesem Prinzipal zugeordneten Benutzerprinzipalnamen (User Principal Name, UPN) ab, oder legt diesen fest.Gets or sets the user principal name (UPN) associated with this principal.

(Inherited from Principal)

Methoden

ChangePassword(String, String) ChangePassword(String, String) ChangePassword(String, String) ChangePassword(String, String)

Ändert das Kontokennwort vom alten in das neue Kennwort.Changes the account password from the old password to the new password. Verwenden Sie dies nicht mit einem ComputerPrincipal.Do not use this with a ComputerPrincipal.

CheckDisposedOrDeleted() CheckDisposedOrDeleted() CheckDisposedOrDeleted() CheckDisposedOrDeleted()

Bestimmt, ob die Dispose()-Methode oder Delete()-Methode für diese Klasse aufgerufen wurde.Determines whether the Dispose() or Delete() methods have been called on this class. Diese Methode wird von Klassen aufgerufen, die von der Prinzipalklasse abgeleitet werden.This method is called by classes that derive from this principal class.

(Inherited from Principal)
Delete() Delete() Delete() Delete()

Löscht das Prinzipalobjekt aus dem Speicher.Deletes the principal object from the store.

(Inherited from Principal)
Dispose() Dispose() Dispose() Dispose()

Verwirft die aktuelle Instanz des Principal-Objekts.Disposes the current instance of the Principal object.

(Inherited from Principal)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Gibt einen booleschen Wert zurück, der angibt, ob das bereitgestellte Objekt gleich dem aktuellen Objekt ist.Returns a Boolean value that specifies whether the supplied object is equal to the current object.

(Inherited from Principal)
ExpirePasswordNow() ExpirePasswordNow() ExpirePasswordNow() ExpirePasswordNow()

Lässt das Kennwort für das Konto ablaufen.Expires the password for this account. Dies zwingt den Benutzer, das Kennwort bei der nächsten Anmeldung zu ändern.This will force the user to change his/her password at the next logon.

ExtensionGet(String) ExtensionGet(String) ExtensionGet(String) ExtensionGet(String)

Ruft ein Attribut eines erweiterten Klassenobjekts ab.Retrieves an attribute of an extended class object.

(Inherited from Principal)
ExtensionSet(String, Object) ExtensionSet(String, Object) ExtensionSet(String, Object) ExtensionSet(String, Object)

Legt den Wert eines Attributs in einer erweiterten Klasse fest.Sets the value of an attribute in an extended class.

(Inherited from Principal)
FindByBadPasswordAttempt(PrincipalContext, DateTime, MatchType) FindByBadPasswordAttempt(PrincipalContext, DateTime, MatchType) FindByBadPasswordAttempt(PrincipalContext, DateTime, MatchType) FindByBadPasswordAttempt(PrincipalContext, DateTime, MatchType)

Gibt eine Auflistung von Authentifizierungsprinzipalobjekten zurück, die eine ungültige Kennworteingabe im angegebenen Datums- und Uhrzeitbereich aufweisen.Returns a collection of authentication principal objects that have an incorrect password try recorded in the specified date and time range.

FindByBadPasswordAttempt<T>(PrincipalContext, DateTime, MatchType) FindByBadPasswordAttempt<T>(PrincipalContext, DateTime, MatchType) FindByBadPasswordAttempt<T>(PrincipalContext, DateTime, MatchType) FindByBadPasswordAttempt<T>(PrincipalContext, DateTime, MatchType)

Gibt eine PrincipalSearchResult<T>-Sammlung von Objekten zurück, die im angegebenen Datums- und Uhrzeitbereich Versuche mit falschem Kennwort aufweisen.Returns a PrincipalSearchResult<T> collection of objects that have a bad password attempt within the specified date and time range. Dies ist die Vorlagenfunktion für erweiterte Klassen, die diese Funktionalität implementieren möchten.This is the template function for extended classes that wish to implement this functionality.

FindByExpirationTime(PrincipalContext, DateTime, MatchType) FindByExpirationTime(PrincipalContext, DateTime, MatchType) FindByExpirationTime(PrincipalContext, DateTime, MatchType) FindByExpirationTime(PrincipalContext, DateTime, MatchType)

Gibt eine Sammlung von Authentifizierungsprinzipalobjekten zurück, für die im angegebenen Datums- und Uhrzeitbereich eine Kontoablaufzeit aufgezeichnet wurde.Returns a collection of authentication principal objects that have an account expiration time recorded in the specified date and time range.

FindByExpirationTime<T>(PrincipalContext, DateTime, MatchType) FindByExpirationTime<T>(PrincipalContext, DateTime, MatchType) FindByExpirationTime<T>(PrincipalContext, DateTime, MatchType) FindByExpirationTime<T>(PrincipalContext, DateTime, MatchType)

Gibt eine PrincipalSearchResult<T>-Sammlung von Objekten zurück, die eine Ablaufzeit im angegebenen Datums- und Uhrzeitbereich aufweisen.Returns a PrincipalSearchResult<T> collection of objects that have an expiration time within the specified date and time range. Dies ist die Vorlagenfunktion für erweiterte Klassen, die diese Funktionalität implementieren möchten.This is the template function for extended classes that wish to implement this functionality.

FindByLockoutTime(PrincipalContext, DateTime, MatchType) FindByLockoutTime(PrincipalContext, DateTime, MatchType) FindByLockoutTime(PrincipalContext, DateTime, MatchType) FindByLockoutTime(PrincipalContext, DateTime, MatchType)

Gibt eine Sammlung von Authentifizierungsprinzipalobjekten zurück, für die im angegebenen Datums- und Uhrzeitbereich eine Kontosperrzeit aufgezeichnet wurde.Returns a collection of authentication principal objects that have an account lockout time recorded in the specified date and time range.

FindByLockoutTime<T>(PrincipalContext, DateTime, MatchType) FindByLockoutTime<T>(PrincipalContext, DateTime, MatchType) FindByLockoutTime<T>(PrincipalContext, DateTime, MatchType) FindByLockoutTime<T>(PrincipalContext, DateTime, MatchType)

Gibt eine PrincipalSearchResult<T>-Sammlung von Objekten zurück, die eine Sperrzeit im angegebenen Datums- und Uhrzeitbereich aufweisen.Returns a PrincipalSearchResult<T> collection of objects that have a lockout time within the specified date and time range. Dies ist die Vorlagenfunktion für erweiterte Klassen, die diese Funktionalität implementieren möchten.This is the template function for extended classes that wish to implement this functionality.

FindByLogonTime(PrincipalContext, DateTime, MatchType) FindByLogonTime(PrincipalContext, DateTime, MatchType) FindByLogonTime(PrincipalContext, DateTime, MatchType) FindByLogonTime(PrincipalContext, DateTime, MatchType)

Gibt eine Sammlung von Authentifizierungsprinzipalobjekten zurück, für die im angegebenen Datums- und Uhrzeitbereich eine Kontoanmeldung aufgezeichnet wurde.Returns a collection of authentication principal objects that have an account logon recorded in the specified date and time range.

FindByLogonTime<T>(PrincipalContext, DateTime, MatchType) FindByLogonTime<T>(PrincipalContext, DateTime, MatchType) FindByLogonTime<T>(PrincipalContext, DateTime, MatchType) FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)

Gibt eine PrincipalSearchResult<T>-Sammlung von Objekten zurück, die eine Anmeldezeit im angegebenen Datums- und Uhrzeitbereich aufweisen.Returns a PrincipalSearchResult<T> collection of objects that have a logon time within the specified date and time range. Dies ist die Vorlagenfunktion für erweiterte Klassen, die diese Funktionalität implementieren möchten.This is the template function for extended classes that wish to implement this functionality.

FindByPasswordSetTime(PrincipalContext, DateTime, MatchType) FindByPasswordSetTime(PrincipalContext, DateTime, MatchType) FindByPasswordSetTime(PrincipalContext, DateTime, MatchType) FindByPasswordSetTime(PrincipalContext, DateTime, MatchType)

Gibt eine Sammlung von Authentifizierungsprinzipalobjekten zurück, für die im angegebenen Datums- und Uhrzeitbereich ein Kontokennwort aufgezeichnet wurde.Returns a collection of authentication principal objects that have an account password set recorded in the specified date and time range.

FindByPasswordSetTime<T>(PrincipalContext, DateTime, MatchType) FindByPasswordSetTime<T>(PrincipalContext, DateTime, MatchType) FindByPasswordSetTime<T>(PrincipalContext, DateTime, MatchType) FindByPasswordSetTime<T>(PrincipalContext, DateTime, MatchType)

Gibt eine PrincipalSearchResult<T>-Sammlung von Objekten zurück, die eine Kennwortfestlegungs-Zeit im angegebenen Datums- und Uhrzeitbereich aufweisen.Returns a PrincipalSearchResult<T> collection of objects that have a password set time within the specified date and time range. Dies ist die Vorlagenfunktion für erweiterte Klassen, die diese Funktionalität implementieren möchten.This is the template function for extended classes that wish to implement this functionality.

GetGroups() GetGroups() GetGroups() GetGroups()

Gibt eine Auflistung von Gruppenobjekten zurück, die die Gruppen angeben, deren Member der aktuelle Prinzipal ist.Returns a collection of group objects that specify the groups of which the current principal is a member.

(Inherited from Principal)
GetGroups(PrincipalContext) GetGroups(PrincipalContext) GetGroups(PrincipalContext) 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.Returns a collection of group objects that the principal is a member of and that exist in the store provided by the specified context parameter.

(Inherited from Principal)
GetHashCode() GetHashCode() GetHashCode() 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.Retrieves the hash created from the contents of the principal object, suited for use in hashing algorithms and data structures like a hash table.

(Inherited from Principal)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
GetUnderlyingObject() GetUnderlyingObject() GetUnderlyingObject() GetUnderlyingObject()

Gibt das zugrunde liegende DirectoryEntry-Objekt zurück, das die Kontaktdaten für das Prinzipalobjekt bereitstellt.Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

(Inherited from Principal)
GetUnderlyingObjectType() GetUnderlyingObjectType() GetUnderlyingObjectType() GetUnderlyingObjectType()

Gibt den zugrunde liegenden Objekttyp zurück.Returns the underlying object type.

(Inherited from Principal)
IsAccountLockedOut() IsAccountLockedOut() IsAccountLockedOut() IsAccountLockedOut()

Gibt einen booleschen Wert zurück, der angibt, ob das Konto zurzeit gesperrt ist.Returns a Boolean value that specifies whether the account is currently locked out.

IsMemberOf(GroupPrincipal) IsMemberOf(GroupPrincipal) IsMemberOf(GroupPrincipal) IsMemberOf(GroupPrincipal)

Gibt einen booleschen Wert zurück, der angibt, ob der Prinzipal ein Member der angegebenen Gruppe ist.Returns a Boolean value that specifies whether the principal is a member of the specified group.

(Inherited from Principal)
IsMemberOf(PrincipalContext, IdentityType, String) IsMemberOf(PrincipalContext, IdentityType, String) IsMemberOf(PrincipalContext, IdentityType, String) 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.Returns a Boolean value that specifies whether the principal is a member of the group specified by identity type and value.

(Inherited from Principal)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
RefreshExpiredPassword() RefreshExpiredPassword() RefreshExpiredPassword() RefreshExpiredPassword()

Aktualisiert ein abgelaufenes Kennwort.Refreshes an expired password.

Save() Save() Save() Save()

Speichert die Änderungen, die am Prinzipalobjekt des Speichers vorgenommen wurden.Saves the changes that were made on the principal object to the store. Wenn es sich dabei um ein neues Prinzipalobjekt handelt, fügt diese Methode es in den Speicher ein.If this is a new principal object, this method inserts it into the store.

(Inherited from Principal)
Save(PrincipalContext) Save(PrincipalContext) Save(PrincipalContext) Save(PrincipalContext)

Speichert die Änderungen, die am Prinzipalobjekt des Speichers vorgenommen wurden.Saves the changes that were made on the principal object to the store. Wenn es sich dabei um ein neues Prinzipalobjekt handelt, fügt diese Methode es in den angegebenen Kontext ein.If this is a new principal object, this method inserts it into the specified context. Wenn der Prinzipal bereits beibehalten wurde, wird er aus dem ursprünglichen Kontext in den angegebenen Kontext verschoben.If the principal has already been persisted, it is moved from the original context to the specified context.

(Inherited from Principal)
SetPassword(String) SetPassword(String) SetPassword(String) SetPassword(String)

Legt das Kennwort auf den angegebenen Wert fest.Sets the account password to the specified value.

ToString() ToString() ToString() ToString()

Gibt eine benutzerfreundliche Zeichenfolgendarstellung des aktuellen Prinzipalobjekts zurück.Returns a user friendly string representation of the current principal object.

(Inherited from Principal)
UnlockAccount() UnlockAccount() UnlockAccount() UnlockAccount()

Entsperrt das Konto gegebenenfalls.Unlocks the account if it is currently locked out.

Gilt für: