UserPrincipal.FindByIdentity UserPrincipal.FindByIdentity UserPrincipal.FindByIdentity UserPrincipal.FindByIdentity Method

Definition

Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätswert entspricht.Returns a user principal object that matches the specified identity value.

Überlädt

FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String)

Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht.Returns a user principal object that matches the specified identity type, and value. Diese Version der FindByIdentity-Methode bestimmt das Format des Identitätswerts.This version of the FindByIdentity method determines the format of the identity value.

FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String)

Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätswert entspricht.Returns a user principal object that matches the specified identity value.

FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String)

Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht.Returns a user principal object that matches the specified identity type, and value. Diese Version der FindByIdentity-Methode bestimmt das Format des Identitätswerts.This version of the FindByIdentity method determines the format of the identity value.

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

Parameter

context
PrincipalContext PrincipalContext PrincipalContext PrincipalContext

Der PrincipalContext, der den Server oder die Domäne angibt, für den bzw. die Vorgänge ausgeführt werden.The PrincipalContext that specifies the server or domain against which operations are performed.

identityType
IdentityType IdentityType IdentityType IdentityType

Ein IdentityType-Enumerationswert, der das Format des identityValue-Parameters angibt.A IdentityType enumeration value that specifies the format of the identityValue parameter.

identityValue
String String String String

Die Identität des Benutzerprinzipals.The identity of the user principal. Dieser Parameter kann ein beliebiges Format aufweisen, das in der IdentityType-Enumeration enthalten ist.This parameter can be any format that is contained in the IdentityType enumeration.

Gibt zurück

Ein UserPrincipal-Objekt, das dem angegebenen Identitätswert und -typ entspricht, oder NULL, wenn keine Übereinstimmungen gefunden werden.A UserPrincipal object that matches the specified identity value and type, or null if no matches are found.

Ausnahmen

Es wurden mehrere Benutzerprinzipalobjekte gefunden, die dem aktuellen Benutzerobjekt entsprechen.Multiple user principal objects matching the current user object were found.

Der Identitätswert ist kein gültiger IdentityType-Enumerationswert.The identity value is not a valid IdentityType enumeration value.

Beispiele

Der folgende Code eine Verbindung mit den lokalen Computerspeicher.The following code connects to the local computer store. Da die Anmeldeinformationen nicht, in angegeben werden der PrincipalContext Konstruktor verwenden, die Anmeldeinformationen der Benutzer ausführt, die den aktuellen Thread verwendet werden.Since the credentials are not specified in the PrincipalContext constructor, the credentials of the user running the current thread are used.

Um den Benutzer zu suchen, der "sAMAccountName", "Gast" hat, wird eine Suche ausgeführt.A search is performed to find the user who has SamAccountName "Guest".

Wenn der Benutzer gefunden wird, wird eine Überprüfung ausgeführt, um zu bestimmen, ob das Konto des Benutzers aktiviert ist.If the user is found, a check is performed to determine whether this user's account is enabled. Wenn das Konto nicht aktiviert ist, kann der Beispielcode es aus.If the account is not enabled, the example code enables it.

PrincipalContext ctx = new PrincipalContext(ContextType.Machine);  

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

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

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

FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String)

Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätswert entspricht.Returns a user principal object that matches the specified identity value.

public:
 static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::String ^ identityValue);
public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, string identityValue);
static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * string -> System.DirectoryServices.AccountManagement.UserPrincipal
Public Shared Function FindByIdentity (context As PrincipalContext, identityValue As String) As UserPrincipal

Parameter

context
PrincipalContext PrincipalContext PrincipalContext PrincipalContext

Der PrincipalContext, der den Server oder die Domäne angibt, für den bzw. die Vorgänge ausgeführt werden.The PrincipalContext that specifies the server or domain against which operations are performed.

identityValue
String String String String

Die Identität des Benutzerprinzipals.The identity of the user principal. Dieser Parameter kann ein beliebiges Format aufweisen, das in der IdentityType-Enumeration enthalten ist.This parameter can be any format that is contained in the IdentityType enumeration.

Gibt zurück

Ein UserPrincipal-Objekt, das dem angegebenen Identitätswert entspricht, oder NULL, wenn keine Übereinstimmungen gefunden werden.A UserPrincipal object that matches the specified identity value, or null if no matches are found.

Ausnahmen

Es wurden mehrere Benutzerprinzipalobjekte gefunden, die dem aktuellen Benutzerobjekt entsprechen.Multiple user principal objects matching the current user object were found.

Gilt für: