Compartir vía


UserPrincipal.FindByIdentity Método

Definición

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
Source:
User.cs
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

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

Excepciones

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

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();   

Se aplica a

FindByIdentity(PrincipalContext, String)

Source:
User.cs
Source:
User.cs
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

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

Excepciones

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

Se aplica a