UserPrincipal Classe

Définition

Encapsule des entités de sécurité qui sont des comptes d'utilisateurs.Encapsulates principals that are user accounts.

public ref 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
type UserPrincipal = class
    inherit AuthenticablePrincipal
Public Class UserPrincipal
Inherits AuthenticablePrincipal
Héritage
Attributs

Constructeurs

UserPrincipal(PrincipalContext)

Initialise une nouvelle instance de la classe UserPrincipal à l'aide du contexte spécifié.Initializes a new instance of the UserPrincipal class by using the specified context.

UserPrincipal(PrincipalContext, String, String, Boolean)

Initialise une nouvelle instance de la classe UserPrincipal en utilisant le contexte spécifié, le nom du compte SAM, le mot de passe et une valeur indiquant si le compte est activé.Initializes a new instance of the UserPrincipal class by using the specified context, SAM account name, password, and enabled value.

Propriétés

AccountExpirationDate

Obtient ou définit un DateTime Nullable qui spécifie la date et l'heure à laquelle le compte expire.Gets or sets a Nullable DateTime that specifies the date and time that the account expires.

(Hérité de AuthenticablePrincipal)
AccountLockoutTime

Obtient le DateTime Nullable qui spécifie la date et l'heure à laquelle le compte a été verrouillé.Gets the Nullable DateTime that specifies the date and time that the account was locked out.

(Hérité de AuthenticablePrincipal)
AdvancedSearchFilter

Retourne un objet AdvancedFilters pour définir des propriétés de lecture seule avant de transmettre l’objet au PrincipalSearcher.Returns an AdvancedFilters object to set read-only properties before passing the object to the PrincipalSearcher.

AllowReversiblePasswordEncryption

Obtient ou définit une valeur de type Boolean qui spécifie si le chiffrement réversible du mot de passe est activé pour ce compte.Gets or sets a Boolean value that specifies whether reversible password encryption is enabled for this account.

(Hérité de AuthenticablePrincipal)
BadLogonCount

Obtient le nombre de tentatives d'ouverture de session effectuées à l'aide d'informations d'identification incorrectes pour ce compte.Gets the number of logon attempts using incorrect credentials for this account.

(Hérité de AuthenticablePrincipal)
Certificates

Obtient un X509Certificate2Collection qui contient les certificats X509 pour ce compte.Gets a X509Certificate2Collection that contains the X509 certificates for this account.

(Hérité de AuthenticablePrincipal)
Context

Obtient un contexte d'entité de sécurité qui est associé à l'entité de sécurité.Gets a principal context that is associated with the principal.

(Hérité de Principal)
ContextRaw

Obtient un contexte d'entité de sécurité associé cette entité de sécurité.Gets a principal context that is associated with this principal.

(Hérité de Principal)
ContextType

Obtient la valeur d’énumération du type de contexte qui spécifie le type de contexte de principal associé à cette entité.Gets the context type enumeration value that specifies the type of principal context associated with this principal.

(Hérité de Principal)
Current

Obtient un objet Principal d'utilisateur qui représente l'utilisateur actuel sous lequel le thread s'exécute.Gets a user principal object that represents the current user under which the thread is running.

DelegationPermitted

Obtient ou définit une valeur de type Boolean Nullable qui spécifie si le compte peut être délégué.Gets or sets a Nullable Boolean value that specifies whether the account may be delegated.

(Hérité de AuthenticablePrincipal)
Description

Obtient ou définit la description de l'entité de sécurité.Gets or sets the description of the principal.

(Hérité de Principal)
DisplayName

Obtient ou définit le nom complet de cette entité de sécurité.Gets or sets the display name for this principal.

(Hérité de Principal)
DistinguishedName

Obtient le nom unique (DN, Distinguished Name) de cette entité de sécurité.Gets the distinguished name (DN) for this principal.

(Hérité de Principal)
EmailAddress

Obtient ou définit l’adresse e-mail de ce compte.Gets or sets the email address for this account.

EmployeeId

Obtient ou définit l'ID d'employé de cette entité de sécurité d'utilisateur.Gets or sets the employee ID for this user principal.

Enabled

Obtient ou définit une valeur de type Boolean Nullable qui spécifie si ce compte est activé pour l'authentification.Gets or sets a Nullable Boolean value that specifies whether this account is enabled for authentication.

(Hérité de AuthenticablePrincipal)
GivenName

Obtient ou définit le prénom de l'entité de sécurité d'utilisateur.Gets or sets the given name for the user principal.

Guid

Obtient le GUID associé à cette entité de sécurité.Gets the GUID associated with this principal.

(Hérité de Principal)
HomeDirectory

Obtient ou définit le répertoire de base de ce compte.Gets or sets the home directory for this account.

(Hérité de AuthenticablePrincipal)
HomeDrive

Obtient ou définit le lecteur de base de ce compte.Gets or sets the home drive for this account.

(Hérité de AuthenticablePrincipal)
LastBadPasswordAttempt

Obtient le DateTime Nullable qui spécifie la date et l'heure de la dernière tentative de mot de passe incorrecte sur ce compte.Gets the Nullable DateTime that specifies the date and time of the last incorrect password attempt on this account.

(Hérité de AuthenticablePrincipal)
LastLogon

Obtient le DateTime Nullable qui spécifie la date et l'heure de la dernière ouverture de session pour ce compte.Gets the Nullable DateTime that specifies the date and time of the last logon for this account.

(Hérité de AuthenticablePrincipal)
LastPasswordSet

Obtient le DateTime Nullable qui spécifie la date et l'heure à laquelle le mot de passe a été défini pour la dernière fois pour ce compte.Gets the Nullable DateTime that specifies the last date and time that the password was set for this account.

(Hérité de AuthenticablePrincipal)
MiddleName

Obtient ou définit le deuxième prénom de l'entité de sécurité d'utilisateur.Gets or sets the middle name for the user principal.

Name

Obtient ou définit le nom de cette entité de sécurité.Gets or sets the name of this principal.

(Hérité de Principal)
PasswordNeverExpires

Obtient ou définit une valeur de type Boolean qui spécifie si le mot de passe expire pour ce compte.Gets or sets a Boolean value that specifies whether the password expires for this account.

(Hérité de AuthenticablePrincipal)
PasswordNotRequired

Obtient ou définit une valeur de type Boolean qui spécifie si un mot de passe est requis pour ce compte.Gets or sets a Boolean value that specifies whether a password is required for this account.

(Hérité de AuthenticablePrincipal)
PermittedLogonTimes

Obtient ou définit les heures auxquelles l'entité de sécurité peut ouvrir une session.Gets or sets the times when the principal can logon.

(Hérité de AuthenticablePrincipal)
PermittedWorkstations

Obtient la liste des stations de travail sur lesquelles cette entité de sécurité est autorisée à ouvrir une session.Gets the list of workstations that this principal is permitted to log into.

(Hérité de AuthenticablePrincipal)
SamAccountName

Obtient ou définit le nom du compte SAM de cette entité de sécurité.Gets or sets the SAM account name for this principal.

(Hérité de Principal)
ScriptPath

Obtient ou définit le chemin du script de ce compte.Gets or sets the script path for this account.

(Hérité de AuthenticablePrincipal)
Sid

Obtient l'ID de sécurité (SID) de l'entité de sécurité.Gets the Security ID (SID) of the principal.

(Hérité de Principal)
SmartcardLogonRequired

Obtient ou définit une valeur de type Boolean qui spécifie si une carte à puce est requise pour ouvrir une session sur ce compte.Gets or sets a Boolean value that specifies whether a smartcard is required to log on to the account.

(Hérité de AuthenticablePrincipal)
StructuralObjectClass

Obtient l'attribut d'annuaire de la classe d'objets structurelle.Gets the structural object class directory attribute.

(Hérité de Principal)
Surname

Obtient ou définit le nom de l'entité de sécurité d'utilisateur.Gets or sets the surname for the user principal.

UserCannotChangePassword

Obtient ou définit une valeur booléenne qui spécifie si l’utilisateur peut changer de mot de passe pour ce compte.Gets or sets a Boolean value that specifies whether the user can change the password for this account. N'utilisez pas avec ComputerPrincipal.Do not use this with a ComputerPrincipal.

(Hérité de AuthenticablePrincipal)
UserPrincipalName

Obtient ou définit le nom d’utilisateur principal (UPN) associé à ce principal.Gets or sets the user principal name (UPN) associated with this principal.

(Hérité de Principal)
VoiceTelephoneNumber

Obtient ou définit le numéro de téléphone de l'entité de sécurité d'utilisateur.Gets or sets the voice telephone number for the user principal.

Méthodes

ChangePassword(String, String)

Modifie le mot de passe du compte avec le nouveau mot de passe.Changes the account password from the old password to the new password. Ne pas utiliser avec ComputerPrincipal.Do not use this with a ComputerPrincipal.

(Hérité de AuthenticablePrincipal)
CheckDisposedOrDeleted()

Détermine si les méthodes Dispose() ou Delete() ont été appelées sur cette classe.Determines whether the Dispose() or Delete() methods have been called on this class. Cette méthode est appelée par les classes qui dérivent de cette classe Principal (entité de sécurité).This method is called by classes that derive from this principal class.

(Hérité de Principal)
Delete()

Supprime l'objet Principal du magasin.Deletes the principal object from the store.

(Hérité de Principal)
Dispose()

Élimine l'instance actuelle de l'objet Principal.Disposes the current instance of the Principal object.

(Hérité de Principal)
Equals(Object)

Retourne une valeur booléenne qui indique si l'objet fourni est égal à l'objet actuel.Returns a Boolean value that specifies whether the supplied object is equal to the current object.

(Hérité de Principal)
ExpirePasswordNow()

Fait expirer le mot de passe de ce compte.Expires the password for this account. Cela forcera l'utilisateur à modifier son mot de passe à la prochaine ouverture de session.This will force the user to change his/her password at the next logon.

(Hérité de AuthenticablePrincipal)
ExtensionGet(String)

Récupère un attribut d’un objet de classe étendue.Retrieves an attribute of an extended class object.

(Hérité de Principal)
ExtensionSet(String, Object)

Définit la valeur d'un attribut dans une classe étendue.Sets the value of an attribute in an extended class.

(Hérité de Principal)
FindByBadPasswordAttempt(PrincipalContext, DateTime, MatchType)

Retourne une collection d’objets PrincipalSearchResult<T> qui ont une tentative de mot de passe incorrecte enregistrée dans la plage de dates et heures spécifiée.Returns a collection of PrincipalSearchResult<T> objects for users that have an incorrect password attempt recorded in the specified date and time range.

FindByExpirationTime(PrincipalContext, DateTime, MatchType)

Retourne une collection d’objets PrincipalSearchResult<T> qui ont un délai d’expiration de compte dans la plage de dates et heures spécifiée.Returns a collection of PrincipalSearchResult<T> objects for users that have an account expiration time in the specified date and time range.

FindByIdentity(PrincipalContext, IdentityType, String)

Retourne un objet Principal de l’utilisateur qui correspond au type et à la valeur d’identité spécifiés.Returns a user principal object that matches the specified identity type, and value. Cette version de la méthode FindByIdentity détermine le format de la valeur d’identité.This version of the FindByIdentity method determines the format of the identity value.

FindByIdentity(PrincipalContext, String)

Retourne un objet principal utilisateur qui correspond à la valeur d’identité spécifiée.Returns a user principal object that matches the specified identity value.

FindByLockoutTime(PrincipalContext, DateTime, MatchType)

Retourne une collection d’objets PrincipalSearchResult<T> qui ont un délai de verrouillage de compte dans la plage de dates et heures spécifiée.Returns a collection of PrincipalSearchResult<T> objects for users that have an account lockout time in the specified date and time range.

FindByLogonTime(PrincipalContext, DateTime, MatchType)

Retourne une collection d’objets PrincipalSearchResult<T> pour des utilisateurs qui ont une connexion de compte enregistrée dans la plage de dates et d’heures spécifiée.Returns a collection of PrincipalSearchResult<T> objects for users that have account logon recorded in the specified date and time range.

FindByPasswordSetTime(PrincipalContext, DateTime, MatchType)

Retourne une collection d’objets PrincipalSearchResult<T> pour les utilisateurs qui ont défini leur mot de passe dans la plage de dates et heures spécifiée.Returns a collection of PrincipalSearchResult<T> objects for users that have set their password within the specified date and time range.

GetAuthorizationGroups()

Retourne une collection d’objets principaux contenant tous les groupes d’autorisations dont cet utilisateur est membre.Returns a collection of principal objects that contains all the authorization groups of which this user is a member. Cette fonction retourne uniquement les groupes qui sont des groupes de sécurité ; les groupes de distribution ne sont pas retournés.This function only returns groups that are security groups; distribution groups are not returned.

GetGroups()

Retourne une collection d'objets de groupe qui spécifient les groupes desquels l'entité de sécurité actuelle est membre.Returns a collection of group objects that specify the groups of which the current principal is a member.

(Hérité de Principal)
GetGroups(PrincipalContext)

Retourne une collection d'objets de groupe desquels l'entité de sécurité est membre et qui existent dans le magasin fourni par le paramètre de contexte spécifié.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.

(Hérité de Principal)
GetHashCode()

Récupère le groupe de hachage créé à partir du contenu de l'objet Principal, approprié pour une utilisation dans les algorithmes de hachage et des structures de données telles qu'une table de hachage.Retrieves the hash created from the contents of the principal object, suited for use in hashing algorithms and data structures like a hash table.

(Hérité de Principal)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetUnderlyingObject()

Retourne l’objet DirectoryEntry sous-jacent qui fournit les données de contact de l’objet principal.Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

(Hérité de Principal)
GetUnderlyingObjectType()

Retourne le type d'objet sous-jacent.Returns the underlying object type.

(Hérité de Principal)
IsAccountLockedOut()

Retourne une valeur booléenne qui spécifie si le compte est actuellement verrouillé.Returns a Boolean value that specifies whether the account is currently locked out.

(Hérité de AuthenticablePrincipal)
IsMemberOf(GroupPrincipal)

Retourne une valeur de type Boolean qui spécifie si l'entité de sécurité est membre du groupe spécifié.Returns a Boolean value that specifies whether the principal is a member of the specified group.

(Hérité de Principal)
IsMemberOf(PrincipalContext, IdentityType, String)

Retourne une valeur de type Boolean qui spécifie si l'entité de sécurité est membre du groupe spécifié par le type et la valeur d'identité.Returns a Boolean value that specifies whether the principal is a member of the group specified by identity type and value.

(Hérité de Principal)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
RefreshExpiredPassword()

Actualise un mot de passe qui a expiré.Refreshes an expired password.

(Hérité de AuthenticablePrincipal)
Save()

Enregistre les modifications apportées à l'objet Principal dans le magasin.Saves the changes that were made on the principal object to the store. S'il s'agit d'un nouvel objet Principal, cette méthode l'insère dans le magasin.If this is a new principal object, this method inserts it into the store.

(Hérité de Principal)
Save(PrincipalContext)

Enregistre les modifications apportées à l'objet Principal dans le magasin.Saves the changes that were made on the principal object to the store. S'il s'agit d'un nouvel objet Principal, cette méthode l'insère dans le contexte spécifié.If this is a new principal object, this method inserts it into the specified context. Si l'entité de sécurité a déjà été rendue persistante, elle est déplacée du contexte d'origine au contexte spécifié.If the principal has already been persisted, it is moved from the original context to the specified context.

(Hérité de Principal)
SetPassword(String)

Affecte la valeur spécifiée au mot de passe du compte.Sets the account password to the specified value.

(Hérité de AuthenticablePrincipal)
ToString()

Retourne une représentation sous la forme d'une chaîne conviviale de l'objet Principal actuel.Returns a user friendly string representation of the current principal object.

(Hérité de Principal)
UnlockAccount()

Déverrouille le compte s'il est actuellement verrouillé.Unlocks the account if it is currently locked out.

(Hérité de AuthenticablePrincipal)

S’applique à