UserPrincipal.FindByIdentity Methode

Definition

Namespace:: System.DirectoryServices.AccountManagement

Assembly:: System.DirectoryServices.AccountManagement.dll

Paket:: System.DirectoryServices.AccountManagement v11.0.0-preview.4.26230.115

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.

Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätswert entspricht.

Überlädt

Name	Beschreibung
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.

FindByIdentity(PrincipalContext, IdentityType, String)

Quelle:: User.cs

Quelle:: User.cs

Quelle:: User.cs

Quelle:: User.cs

Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätstyp und wert entspricht. Diese Version der FindByIdentity Methode bestimmt das Format des Identitätswerts.

public:
 static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity(System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> System.DirectoryServices.AccountManagement.UserPrincipal

Public Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As UserPrincipal

Parameter

context: PrincipalContext

Die PrincipalContext, die den Server oder die Domäne angibt, für den Vorgänge ausgeführt werden.

identityType: IdentityType

Ein IdentityType Enumerationswert, der das Format des identityValue Parameters angibt.

identityValue: String

Die Identität des Benutzerprinzipals. Dieser Parameter kann ein beliebiges Format sein, das in der IdentityType Enumeration enthalten ist.

Gibt zurück

UserPrincipal

Ein UserPrincipal Objekt, das dem angegebenen Identitätswert und -typ entspricht, oder null, wenn keine Übereinstimmungen gefunden werden.

Ausnahmen

MultipleMatchesException

Es wurden mehrere Benutzerprinzipalobjekte gefunden, die dem aktuellen Benutzerobjekt entsprechen.

InvalidEnumArgumentException

Der Identitätswert ist kein gültiger IdentityType Enumerationswert.

Beispiele

Der folgende Code stellt eine Verbindung mit dem lokalen Computerspeicher bereit. Da die Anmeldeinformationen nicht im PrincipalContext Konstruktor angegeben werden, werden die Anmeldeinformationen des Benutzers verwendet, der den aktuellen Thread ausführt.

Es wird eine Suche durchgeführt, um den Benutzer zu finden, der samAccountName "Guest" hat.

Wenn der Benutzer gefunden wird, wird eine Überprüfung durchgeführt, um festzustellen, ob das Konto dieses Benutzers aktiviert ist. Wenn das Konto nicht aktiviert ist, aktiviert der Beispielcode es.

PrincipalContext ctx = new PrincipalContext(ContextType.Machine);

UserPrincipal usr = UserPrincipal.FindByIdentity(ctx,
                                           IdentityType.SamAccountName,
                                           "Guest");

if(usr != null)
{
    if (!usr.Enabled)
        usr.Enabled = true;

    usr.Save();
    usr.Dispose();
}
ctx.Dispose();

Gilt für:

FindByIdentity(PrincipalContext, String)

Quelle:: User.cs

Quelle:: User.cs

Quelle:: User.cs

Quelle:: User.cs