UserPrincipal Klasa

Definicja

Hermetyzuje podmioty zabezpieczeń będące kontami użytkowników.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
Dziedziczenie
Atrybuty

Konstruktory

UserPrincipal(PrincipalContext)

Inicjuje nowe wystąpienie klasy UserPrincipal przy użyciu określonego kontekstu.Initializes a new instance of the UserPrincipal class by using the specified context.

UserPrincipal(PrincipalContext, String, String, Boolean)

Inicjuje nowe wystąpienie klasy UserPrincipal przy użyciu określonego kontekstu, nazwy konta SAM, hasła i włączonej wartości.Initializes a new instance of the UserPrincipal class by using the specified context, SAM account name, password, and enabled value.

Właściwości

AccountExpirationDate

Pobiera lub ustawia wartość null DateTime, która określa datę i godzinę wygaśnięcia konta.Gets or sets a Nullable DateTime that specifies the date and time that the account expires.

(Odziedziczone po AuthenticablePrincipal)
AccountLockoutTime

Pobiera wartość null DateTime, która określa datę i godzinę, o której konto zostało zablokowane.Gets the Nullable DateTime that specifies the date and time that the account was locked out.

(Odziedziczone po AuthenticablePrincipal)
AdvancedSearchFilter

Zwraca obiekt AdvancedFilters, aby ustawić właściwości tylko do odczytu przed przekazaniem obiektu do PrincipalSearcher.Returns an AdvancedFilters object to set read-only properties before passing the object to the PrincipalSearcher.

AllowReversiblePasswordEncryption

Pobiera lub ustawia wartość logiczną określającą, czy jest włączone odwracalne szyfrowanie hasła dla tego konta.Gets or sets a Boolean value that specifies whether reversible password encryption is enabled for this account.

(Odziedziczone po AuthenticablePrincipal)
BadLogonCount

Pobiera liczbę prób logowania przy użyciu nieprawidłowych poświadczeń dla tego konta.Gets the number of logon attempts using incorrect credentials for this account.

(Odziedziczone po AuthenticablePrincipal)
Certificates

Pobiera X509Certificate2Collection zawierający certyfikaty x509 dla tego konta.Gets a X509Certificate2Collection that contains the X509 certificates for this account.

(Odziedziczone po AuthenticablePrincipal)
Context

Pobiera kontekst podmiotu zabezpieczeń skojarzony z podmiotem zabezpieczeń.Gets a principal context that is associated with the principal.

(Odziedziczone po Principal)
ContextRaw

Pobiera kontekst podmiotu zabezpieczeń skojarzony z tym podmiotem zabezpieczeń.Gets a principal context that is associated with this principal.

(Odziedziczone po Principal)
ContextType

Pobiera wartość wyliczenia typu kontekstu, która określa typ kontekstu podmiotu skojarzonego z tym podmiotem zabezpieczeń.Gets the context type enumeration value that specifies the type of principal context associated with this principal.

(Odziedziczone po Principal)
Current

Pobiera obiekt główny użytkownika reprezentujący bieżącego użytkownika, w ramach którego jest uruchomiony wątek.Gets a user principal object that represents the current user under which the thread is running.

DelegationPermitted

Pobiera lub ustawia wartość logiczną null, która określa, czy konto może być delegowane.Gets or sets a Nullable Boolean value that specifies whether the account may be delegated.

(Odziedziczone po AuthenticablePrincipal)
Description

Pobiera lub ustawia opis podmiotu zabezpieczeń.Gets or sets the description of the principal.

(Odziedziczone po Principal)
DisplayName

Pobiera lub ustawia nazwę wyświetlaną dla tego podmiotu zabezpieczeń.Gets or sets the display name for this principal.

(Odziedziczone po Principal)
DistinguishedName

Pobiera nazwę wyróżniającą (DN) dla tego podmiotu zabezpieczeń.Gets the distinguished name (DN) for this principal.

(Odziedziczone po Principal)
EmailAddress

Pobiera lub ustawia adres e-mail dla tego konta.Gets or sets the email address for this account.

EmployeeId

Pobiera lub ustawia identyfikator pracownika dla tego podmiotu użytkownika.Gets or sets the employee ID for this user principal.

Enabled

Pobiera lub ustawia wartość logiczną null, która określa, czy to konto jest włączone na potrzeby uwierzytelniania.Gets or sets a Nullable Boolean value that specifies whether this account is enabled for authentication.

(Odziedziczone po AuthenticablePrincipal)
GivenName

Pobiera lub ustawia nazwę podmiotu użytkownika.Gets or sets the given name for the user principal.

Guid

Pobiera identyfikator GUID skojarzony z tym podmiotem zabezpieczeń.Gets the GUID associated with this principal.

(Odziedziczone po Principal)
HomeDirectory

Pobiera lub ustawia katalog macierzysty dla tego konta.Gets or sets the home directory for this account.

(Odziedziczone po AuthenticablePrincipal)
HomeDrive

Pobiera lub ustawia dysk macierzysty dla tego konta.Gets or sets the home drive for this account.

(Odziedziczone po AuthenticablePrincipal)
LastBadPasswordAttempt

Pobiera wartość null DateTime, która określa datę i godzinę ostatniej nieudanej próby użycia tego konta.Gets the Nullable DateTime that specifies the date and time of the last incorrect password attempt on this account.

(Odziedziczone po AuthenticablePrincipal)
LastLogon

Pobiera wartość null DateTime, która określa datę i godzinę ostatniego logowania dla tego konta.Gets the Nullable DateTime that specifies the date and time of the last logon for this account.

(Odziedziczone po AuthenticablePrincipal)
LastPasswordSet

Pobiera wartość null DateTime, która określa ostatnią datę i godzinę ustawienia hasła dla tego konta.Gets the Nullable DateTime that specifies the last date and time that the password was set for this account.

(Odziedziczone po AuthenticablePrincipal)
MiddleName

Pobiera lub ustawia nazwę środkową podmiotu zabezpieczeń.Gets or sets the middle name for the user principal.

Name

Pobiera lub ustawia nazwę tego podmiotu zabezpieczeń.Gets or sets the name of this principal.

(Odziedziczone po Principal)
PasswordNeverExpires

Pobiera lub ustawia wartość logiczną określającą, czy hasło wygasa dla tego konta.Gets or sets a Boolean value that specifies whether the password expires for this account.

(Odziedziczone po AuthenticablePrincipal)
PasswordNotRequired

Pobiera lub ustawia wartość logiczną określającą, czy dla tego konta jest wymagane hasło.Gets or sets a Boolean value that specifies whether a password is required for this account.

(Odziedziczone po AuthenticablePrincipal)
PermittedLogonTimes

Pobiera lub ustawia czas, kiedy podmiot zabezpieczeń może się zalogować.Gets or sets the times when the principal can logon.

(Odziedziczone po AuthenticablePrincipal)
PermittedWorkstations

Pobiera listę stacji roboczych, do których ten podmiot zabezpieczeń może się zalogować.Gets the list of workstations that this principal is permitted to log into.

(Odziedziczone po AuthenticablePrincipal)
SamAccountName

Pobiera lub ustawia nazwę konta SAM dla tego podmiotu zabezpieczeń.Gets or sets the SAM account name for this principal.

(Odziedziczone po Principal)
ScriptPath

Pobiera lub ustawia ścieżkę skryptu dla tego konta.Gets or sets the script path for this account.

(Odziedziczone po AuthenticablePrincipal)
Sid

Pobiera identyfikator zabezpieczeń (SID) obiektu głównego.Gets the Security ID (SID) of the principal.

(Odziedziczone po Principal)
SmartcardLogonRequired

Pobiera lub ustawia wartość logiczną określającą, czy karta inteligentna jest wymagana do logowania się do konta.Gets or sets a Boolean value that specifies whether a smartcard is required to log on to the account.

(Odziedziczone po AuthenticablePrincipal)
StructuralObjectClass

Pobiera atrybut katalogu klasy obiektu strukturalnego.Gets the structural object class directory attribute.

(Odziedziczone po Principal)
Surname

Pobiera lub ustawia nazwisko dla podmiotu zabezpieczeń użytkownika.Gets or sets the surname for the user principal.

UserCannotChangePassword

Pobiera lub ustawia wartość logiczną określającą, czy użytkownik może zmienić hasło dla tego konta.Gets or sets a Boolean value that specifies whether the user can change the password for this account. Nie należy używać go z ComputerPrincipal.Do not use this with a ComputerPrincipal.

(Odziedziczone po AuthenticablePrincipal)
UserPrincipalName

Pobiera lub ustawia główną nazwę użytkownika (UPN) skojarzoną z tym podmiotem zabezpieczeń.Gets or sets the user principal name (UPN) associated with this principal.

(Odziedziczone po Principal)
VoiceTelephoneNumber

Pobiera lub ustawia numer telefonu głosowego dla podmiotu zabezpieczeń.Gets or sets the voice telephone number for the user principal.

Metody

ChangePassword(String, String)

Zmienia hasło konta ze starego hasła na nowe hasło.Changes the account password from the old password to the new password. Nie należy używać go z ComputerPrincipal.Do not use this with a ComputerPrincipal.

(Odziedziczone po AuthenticablePrincipal)
CheckDisposedOrDeleted()

Określa, Dispose() czy metody Delete() lub zostały wywołane dla tej klasy.Determines whether the Dispose() or Delete() methods have been called on this class. Ta metoda jest wywoływana przez klasy, które pochodzą z tej klasy głównej.This method is called by classes that derive from this principal class.

(Odziedziczone po Principal)
Delete()

Usuwa obiekt Principal ze sklepu.Deletes the principal object from the store.

(Odziedziczone po Principal)
Dispose()

Usuwa bieżące wystąpienie Principal obiektu.Disposes the current instance of the Principal object.

(Odziedziczone po Principal)
Equals(Object)

Zwraca wartość logiczną określającą, czy dostarczony obiekt jest równy bieżącemu obiektowi.Returns a Boolean value that specifies whether the supplied object is equal to the current object.

(Odziedziczone po Principal)
ExpirePasswordNow()

Wygasa hasło dla tego konta.Expires the password for this account. Spowoduje to wymuszenie zmiany hasła przy następnym logowaniu.This will force the user to change his/her password at the next logon.

(Odziedziczone po AuthenticablePrincipal)
ExtensionGet(String)

Pobiera atrybut obiektu klasy rozszerzonej.Retrieves an attribute of an extended class object.

(Odziedziczone po Principal)
ExtensionSet(String, Object)

Ustawia wartość atrybutu w klasie rozszerzonej.Sets the value of an attribute in an extended class.

(Odziedziczone po Principal)
FindByBadPasswordAttempt(PrincipalContext, DateTime, MatchType)

Zwraca kolekcję obiektów PrincipalSearchResult<T> dla użytkowników, którzy mają niepoprawną próbę hasła zarejestrowano w określonym zakresie dat i godzin.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)

Zwraca kolekcję obiektów PrincipalSearchResult<T> dla użytkowników, którzy mają czas wygaśnięcia konta w określonym zakresie dat i godzin.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)

Zwraca obiekt główny użytkownika, który odpowiada określonemu typowi tożsamości i wartości.Returns a user principal object that matches the specified identity type, and value. Ta wersja metody FindByIdentity określa format wartości tożsamości.This version of the FindByIdentity method determines the format of the identity value.

FindByIdentity(PrincipalContext, String)

Zwraca obiekt główny użytkownika, który jest zgodny z określoną wartością tożsamości.Returns a user principal object that matches the specified identity value.

FindByLockoutTime(PrincipalContext, DateTime, MatchType)

Zwraca kolekcję obiektów PrincipalSearchResult<T> dla użytkowników, którzy mają czas blokady konta w określonym zakresie dat i godzin.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)

Zwraca kolekcję obiektów PrincipalSearchResult<T> dla użytkowników, którzy mają logowanie do konta zarejestrowano w określonym zakresie dat i godzin.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)

Zwraca kolekcję obiektów PrincipalSearchResult<T> dla użytkowników, którzy ustawili swoje hasło w określonym zakresie dat i godzin.Returns a collection of PrincipalSearchResult<T> objects for users that have set their password within the specified date and time range.

GetAuthorizationGroups()

Zwraca kolekcję obiektów Principal, która zawiera wszystkie grupy autoryzacji, których ten użytkownik jest członkiem.Returns a collection of principal objects that contains all the authorization groups of which this user is a member. Ta funkcja zwraca tylko grupy, które są grupami zabezpieczeń; grupy dystrybucyjne nie są zwracane.This function only returns groups that are security groups; distribution groups are not returned.

GetGroups()

Zwraca kolekcję obiektów grupy, które określają grupy, których bieżącym podmiotem jest element członkowski.Returns a collection of group objects that specify the groups of which the current principal is a member.

(Odziedziczone po Principal)
GetGroups(PrincipalContext)

Zwraca kolekcję obiektów grupy, do której należy podmiot zabezpieczeń i który istnieje w magazynie udostępnionym przez określony parametr kontekstowy.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.

(Odziedziczone po Principal)
GetHashCode()

Pobiera skrót utworzony z zawartości obiektu Principal, odpowiedni do użycia w algorytmach wyznaczania wartości skrótu i strukturach danych, takich jak tabela skrótów.Retrieves the hash created from the contents of the principal object, suited for use in hashing algorithms and data structures like a hash table.

(Odziedziczone po Principal)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
GetUnderlyingObject()

Zwraca obiekt źródłowy DirectoryEntry , który dostarcza dane osoby kontaktowej dla obiektu podmiotu zabezpieczeń.Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

(Odziedziczone po Principal)
GetUnderlyingObjectType()

Zwraca typ obiektu źródłowego.Returns the underlying object type.

(Odziedziczone po Principal)
IsAccountLockedOut()

Zwraca wartość logiczną określającą, czy konto jest obecnie zablokowane.Returns a Boolean value that specifies whether the account is currently locked out.

(Odziedziczone po AuthenticablePrincipal)
IsMemberOf(GroupPrincipal)

Zwraca wartość logiczną określającą, czy podmiot zabezpieczeń jest członkiem określonej grupy.Returns a Boolean value that specifies whether the principal is a member of the specified group.

(Odziedziczone po Principal)
IsMemberOf(PrincipalContext, IdentityType, String)

Zwraca wartość logiczną określającą, czy podmiot zabezpieczeń jest członkiem grupy określonej przez typ tożsamości i wartość.Returns a Boolean value that specifies whether the principal is a member of the group specified by identity type and value.

(Odziedziczone po Principal)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
RefreshExpiredPassword()

Odświeża wygasłe hasło.Refreshes an expired password.

(Odziedziczone po AuthenticablePrincipal)
Save()

Zapisuje zmiany wprowadzone w obiekcie Principal do magazynu.Saves the changes that were made on the principal object to the store. Jeśli jest to nowy obiekt Principal, ta metoda wstawia go do sklepu.If this is a new principal object, this method inserts it into the store.

(Odziedziczone po Principal)
Save(PrincipalContext)

Zapisuje zmiany wprowadzone w obiekcie Principal do magazynu.Saves the changes that were made on the principal object to the store. Jeśli jest to nowy obiekt Principal, ta metoda wstawia je do określonego kontekstu.If this is a new principal object, this method inserts it into the specified context. Jeśli podmiot zabezpieczeń został już utrwalony, jest przenoszony z oryginalnego kontekstu do określonego kontekstu.If the principal has already been persisted, it is moved from the original context to the specified context.

(Odziedziczone po Principal)
SetPassword(String)

Określa hasło konta dla określonej wartości.Sets the account password to the specified value.

(Odziedziczone po AuthenticablePrincipal)
ToString()

Zwraca przyjazny dla użytkownika ciąg reprezentujący bieżący obiekt Principal.Returns a user friendly string representation of the current principal object.

(Odziedziczone po Principal)
UnlockAccount()

Odblokowuje konto, jeśli jest ono aktualnie zablokowane.Unlocks the account if it is currently locked out.

(Odziedziczone po AuthenticablePrincipal)

Dotyczy