GroupPrincipal.GetMembers Método

Definición

Espacio de nombres:

System.DirectoryServices.AccountManagement

Ensamblado:

System.DirectoryServices.AccountManagement.dll

Paquete:

System.DirectoryServices.AccountManagement v8.0.0

Devuelve una colección de los objetos de entidad de seguridad contenidos en el grupo.

Sobrecargas

GetMembers()	Devuelve una colección de los objetos de entidad de seguridad contenidos en el grupo.
GetMembers(Boolean)	Devuelve una colección de los objetos de entidad de seguridad contenidos en el grupo. Cuando el marcador recursivo se establece en true, este método busca el grupo actual recursivamente y devuelve todos los miembros del grupo anidados.

GetMembers()

Source:

Group.cs

Devuelve una colección de los objetos de entidad de seguridad contenidos en el grupo.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetMembers();

public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetMembers ();

member this.GetMembers : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>

Public Function GetMembers () As PrincipalSearchResult(Of Principal)

Devoluciones

PrincipalSearchResult<Principal>

Objeto PrincipalSearchResult<T> que contiene los objetos de entidades de seguridad que son miembros del grupo o una colección vacía si el grupo no tiene miembros.

Comentarios

Este método no busca el grupo actual de forma recursiva. Por lo tanto, los objetos de grupo se pueden devolver en la colección de objetos principal.

Los miembros se devuelven sin tener en cuenta el contexto. Por ejemplo, si un contexto de AD DS basado en "CN=SpecialUsers,DC=Fabrikam,DC=com", el conjunto PrincipalFindResult incluirá miembros del grupo que se encuentran en "CN=NormalUsers,DC=Fabrikam,DC=com", aunque también se encuentren en un ámbito que no forma parte del contexto que se busca. La colección principal devuelta también puede contener miembros que se encuentran en un almacén diferente al del grupo.

GetMembers(Boolean)

Source:

Group.cs

Devuelve una colección de los objetos de entidad de seguridad contenidos en el grupo. Cuando el marcador recursivo se establece en true, este método busca el grupo actual recursivamente y devuelve todos los miembros del grupo anidados.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetMembers(bool recursive);

public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetMembers (bool recursive);

member this.GetMembers : bool -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>

Public Function GetMembers (recursive As Boolean) As PrincipalSearchResult(Of Principal)

Parámetros

recursive

Boolean

Valor booleano que especifica si se busca en el grupo recursivamente.

Devoluciones

PrincipalSearchResult<Principal>

Objeto PrincipalSearchResult<T> que contiene los objetos de entidades de seguridad que son miembros del grupo o una colección vacía si el grupo no tiene miembros.

Ejemplos

El código siguiente se conecta al dominio LDAP "fabrikam.com" con el nombre de usuario establecido en "administrador" y la contraseña establecida en "SecretPwd123" en el PrincipalContext constructor.

Se realiza una búsqueda para buscar el grupo que tiene el nombre "Administradores de dominio" en el contenedor especificado en el PrincipalContext constructor "DC=fabrikam,DC=com". Si se encuentra el grupo, se enumeran todas las entidades de seguridad que son miembros de este grupo, que incluye miembros recursivos,

PrincipalContext ctx = new PrincipalContext(ContextType.Domain,                                                                      
                                            "fabrikam.com",   
                                            "DC=fabrikam,DC=com",   
                                            "administrator",   
                                            "SecretPwd123");  

GroupPrincipal grp = GroupPrincipal.FindByIdentity(ctx,   
                                                   IdentityType.Name,   
                                                   "Domain Admins");  

if (grp != null)  
{  
    foreach (Principal p in grp.GetMembers(true))  
    {  
         Console.WriteLine(p.Name);  
    }  
    grp.Dispose();  
}  

ctx.Dispose();   

Comentarios

La colección principal devuelta no contiene objetos de grupo cuando la marca recursiva se establece trueen ; solo se devuelven los nodos hoja. Por ejemplo, cuando un grupo que contiene un objeto de equipo y un objeto de grupo (solo con entidades de seguridad de usuario) se busca de forma recursiva, la colección devuelta contiene el objeto de equipo y los objetos de entidad de seguridad de usuario del grupo anidado. Dado que el objeto de grupo no es una hoja, incluso cuando está vacío, no se devuelve en la búsqueda recursiva. Cuando la marca recursiva se establece falseen , la colección devuelta puede contener objetos de grupo.

Los miembros se devuelven sin tener en cuenta el contexto. Por ejemplo, si un contexto de AD DS basado en "CN=SpecialUsers,DC=Fabrikam,DC=com", el conjunto PrincipalFindResult incluirá miembros del grupo que se encuentran en "CN=NormalUsers,DC=Fabrikam,DC=com", aunque también se encuentren en un ámbito que no forma parte del contexto que se busca. La colección principal devuelta también puede contener miembros que se encuentran en un almacén diferente al del grupo.