GroupPrincipal.GetMembers Método

Definição

Retorna uma coleção de objetos de entidade de segurança que está contida no grupo.Returns a collection of the principal objects that is contained in the group.

Sobrecargas

GetMembers()

Retorna uma coleção de objetos de entidade de segurança que está contida no grupo.Returns a collection of the principal objects that is contained in the group.

GetMembers(Boolean)

Retorna uma coleção de objetos de entidade de segurança que está contida no grupo.Returns a collection of the principal objects that is contained in the group. Quando esse sinalizador é definido como verdadeiro, este método pesquisa recursivamente o grupo atual e retorna todos os membros do grupo.When the recursive flag is set to true, this method searches the current group recursively and returns all nested group members.

GetMembers()

Retorna uma coleção de objetos de entidade de segurança que está contida no grupo.Returns a collection of the principal objects that is contained in the group.

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)

Retornos

PrincipalSearchResult<Principal>

Um PrincipalSearchResult<T> objeto que contém os objetos de entidade de segurança que são membros do grupo ou uma coleção vazia se o grupo não tem membros.A PrincipalSearchResult<T> object that contains the principal objects that are members of the group, or an empty collection if the group has no members.

Comentários

Esse método não pesquisa o grupo atual recursivamente.This method does not search the current group recursively. Portanto, os objetos de grupo podem ser retornados na coleção de objetos principal.Therefore, group objects may be returned in the principal object collection.

Os membros são retornados sem respeitar o contexto.Members are returned without respect to the context. Por exemplo, se um contexto de AD DS baseado em "CN = SpecialUsers, DC = Fabrikam, DC = com", o conjunto de PrincipalFindResult incluirá membros do grupo que estão localizados em "CN = NormalUsers, DC = Fabrikam, DC = com" também, mesmo que estejam sob um escopo que não faça parte do contexto que é pesquisado.For example, if an AD DS context based at "CN=SpecialUsers,DC=Fabrikam,DC=com", the PrincipalFindResult set will include group members that are located under "CN=NormalUsers,DC=Fabrikam,DC=com" also, even though they fall under a scope that is not part of the context that is searched. A coleção de entidades de segurança retornada também pode conter membros que estão localizados em um repositório diferente do grupo.The returned principal collection may also contain members that are located in a different store than the group.

Aplica-se a

GetMembers(Boolean)

Retorna uma coleção de objetos de entidade de segurança que está contida no grupo.Returns a collection of the principal objects that is contained in the group. Quando esse sinalizador é definido como verdadeiro, este método pesquisa recursivamente o grupo atual e retorna todos os membros do grupo.When the recursive flag is set to true, this method searches the current group recursively and returns all nested group members.

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

Um valor booliano que especifica se o grupo é pesquisado recursivamente.A Boolean value that specifies whether the group is searched recursively.

Retornos

PrincipalSearchResult<Principal>

Um PrincipalSearchResult<T> objeto que contém os objetos de entidade de segurança que são membros do grupo ou uma coleção vazia se o grupo não tem membros.A PrincipalSearchResult<T> object that contains the principal objects that are members of the group, or an empty collection if the group has no members.

Exemplos

O código a seguir se conecta ao domínio LDAP "fabrikam.com" com o nome de usuário definido como "administrador" e a senha definida como "SecretPwd123" no PrincipalContext Construtor.The following code connects to the LDAP domain "fabrikam.com" with the username set to "administrator" and the password set to "SecretPwd123" in the PrincipalContext constructor.

Uma pesquisa é executada para localizar o grupo que tem o nome "admins. do domínio" no contêiner especificado no PrincipalContext Construtor "DC = Fabrikam, DC = com".A search is performed to find the group that has the name "Domain Admins" under the container specified in the PrincipalContext constructor "DC=fabrikam,DC=com." Se o grupo for encontrado, todas as entidades de segurança que forem membros desse grupo, que incluem membros recursivos, serão enumeradasIf the group is found, all the principals that are members of this group, which includes recursive members, are then enumerated

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

Comentários

A coleção de entidades de segurança retornada não contém objetos de grupo quando o sinalizador recursivo é definido como true ; somente nós folha são retornados.The returned principal collection does not contain group objects when the recursive flag is set to true; only leaf nodes are returned. Por exemplo, quando um grupo que contém um objeto de computador e um objeto de grupo (com apenas entidades de usuário) é pesquisado recursivamente, a coleção retornada contém o objeto de computador e os objetos de entidade de usuário no grupo aninhado.For example, when a group that contains a computer object and a group object (with only user principals) is searched recursively, the returned collection contains the computer object and the user principal objects in the nested group. Como o objeto Group não é uma folha, mesmo quando está vazio, ele não é retornado na pesquisa recursiva.Since the group object is not a leaf, even when it is empty, it is not returned in the recursive search. Quando o sinalizador recursivo é definido como false , a coleção retornada pode conter objetos de grupo.When the recursive flag is set to false, the returned collection may contain group objects.

Os membros são retornados sem respeitar o contexto.Members are returned without respect to the context. Por exemplo, se um contexto de AD DS baseado em "CN = SpecialUsers, DC = Fabrikam, DC = com", o conjunto de PrincipalFindResult incluirá membros do grupo que estão localizados em "CN = NormalUsers, DC = Fabrikam, DC = com" também, mesmo que estejam sob um escopo que não faça parte do contexto que é pesquisado.For example, if an AD DS context based at "CN=SpecialUsers,DC=Fabrikam,DC=com", the PrincipalFindResult set will include group members that are located under "CN=NormalUsers,DC=Fabrikam,DC=com" also, even though they fall under a scope that is not part of the context that is searched. A coleção de entidades de segurança retornada também pode conter membros que estão localizados em um repositório diferente do grupo.The returned principal collection may also contain members that are located in a different store than the group.

Aplica-se a