UserPrincipal.FindByIdentity Método

Definición

Espacio de nombres:

System.DirectoryServices.AccountManagement

Ensamblado:

System.DirectoryServices.AccountManagement.dll

Paquete:

System.DirectoryServices.AccountManagement v8.0.0

Devuelve un objeto principal que coincide con el valor de identidad especificado.

Sobrecargas

FindByIdentity(PrincipalContext, IdentityType, String)	Devuelve un objeto principal del usuario que coincide con el tipo de identidad especificado y el valor. Esta versión del método FindByIdentity determina el formato del valor de identidad.
FindByIdentity(PrincipalContext, String)	Devuelve un objeto principal que coincide con el valor de identidad especificado.

FindByIdentity(PrincipalContext, IdentityType, String)

Source:

User.cs

Devuelve un objeto principal del usuario que coincide con el tipo de identidad especificado y el valor. Esta versión del método FindByIdentity determina el formato del valor de identidad.

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

Parámetros

context

PrincipalContext

PrincipalContext que especifica el servidor o dominio en el que se realizan las operaciones.

identityType

IdentityType

Valor de enumeración IdentityType que especifica el formato del parámetro identityValue.

identityValue

String

Identidad de la entidad de seguridad de usuario. Este parámetro puede ser cualquier formato que se encuentra en la enumeración IdentityType.

Devoluciones

UserPrincipal

Objeto UserPrincipal que coincide con el valor y tipo de identidad especificado, o null si no se encuentra ninguna coincidencia.

Excepciones

MultipleMatchesException

Se encontraron varios objetos principales de usuario que coinciden con el objeto de usuario actual.

InvalidEnumArgumentException

El valor de identidad no es un valor de enumeración IdentityType válido.

Ejemplos

El código siguiente se conecta al almacén de equipos local. Dado que las credenciales no se especifican en el PrincipalContext constructor, se usan las credenciales del usuario que ejecuta el subproceso actual.

Se realiza una búsqueda para buscar al usuario que tiene SamAccountName "Guest".

Si se encuentra el usuario, se realiza una comprobación para determinar si la cuenta de este usuario está habilitada. Si la cuenta no está habilitada, el código de ejemplo lo habilita.

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)

Source:

User.cs

Devuelve un objeto principal que coincide con el valor de identidad especificado.

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

Parámetros

context

PrincipalContext

PrincipalContext que especifica el servidor o dominio en el que se realizan las operaciones.

identityValue

String

Identidad de la entidad de seguridad de usuario. Este parámetro puede ser cualquier formato que se encuentra en la enumeración IdentityType.

Devoluciones

UserPrincipal

Objeto UserPrincipal que coincide con el valor de identidad especificado, o null si no se encuentra ninguna coincidencia.

Excepciones

MultipleMatchesException

Se encontraron varios objetos principales de usuario que coinciden con el objeto de usuario actual.