Compartilhar via


Principal.GetGroups Método

Definição

Retorna uma coleção de objetos de grupo que especificam os grupos dos quais a entidade atual é membro.

Sobrecargas

GetGroups()

Retorna uma coleção de objetos de grupo que especificam os grupos dos quais a entidade atual é membro.

GetGroups(PrincipalContext)

Retorna uma coleção de objetos de grupo da qual a entidade de segurança é um membro e que existe no repositório fornecido pelo parâmetro de contexto especificado.

Comentários

Esse método sobrecarregado retorna apenas os grupos dos quais a entidade de segurança é diretamente um membro; nenhuma pesquisa recursiva é executada. Os resultados da pesquisa recursiva estão disponíveis para objetos de entidade de segurança do usuário. Para obter mais informações, consulte o método GetAuthorizationGroups.

Se o repositório principal for AD DS, a lista de grupos conterá o grupo primário do usuário identificado pelo atributo ID do grupo primário no objeto do AD DS.

GetGroups()

Origem:
Principal.cs
Origem:
Principal.cs
Origem:
Principal.cs

Retorna uma coleção de objetos de grupo que especificam os grupos dos quais a entidade atual é membro.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetGroups();
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups ();
[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups ();
member this.GetGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
[<System.Security.SecurityCritical>]
member this.GetGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
Public Function GetGroups () As PrincipalSearchResult(Of Principal)

Retornos

Uma coleção de objetos GroupPrincipal que especificam os grupos dos quais a entidade atual é membro.

Atributos

Comentários

Esse método retorna apenas os grupos dos quais a entidade de segurança é diretamente um membro; nenhuma pesquisa recursiva é executada. Os resultados da pesquisa recursiva estão disponíveis para objetos de entidade de segurança do usuário. Para obter mais informações, consulte o método GetAuthorizationGroups.

Os grupos retornados por esse método podem incluir grupos de um escopo e repositório diferentes do principal. Por exemplo, se a entidade de segurança for um objeto AD DS que tenha um DN de "CN=SpecialGroups,DC=Fabrikam,DC=com, o conjunto retornado poderá conter grupos que pertencem a "CN=NormalGroups,DC=Fabrikam,DC=com.

Se a entidade de segurança atual for uma entidade de segurança do AD DS, os grupos retornados incluirão o grupo primário de entidades de segurança, conforme indicado pelo atributo "primaryGroupId" no objeto AD DS.

Confira também

Aplica-se a

GetGroups(PrincipalContext)

Origem:
Principal.cs
Origem:
Principal.cs
Origem:
Principal.cs

Retorna uma coleção de objetos de grupo da qual a entidade de segurança é um membro e que existe no repositório fornecido pelo parâmetro de contexto especificado.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetGroups(System::DirectoryServices::AccountManagement::PrincipalContext ^ contextToQuery);
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups (System.DirectoryServices.AccountManagement.PrincipalContext contextToQuery);
[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups (System.DirectoryServices.AccountManagement.PrincipalContext contextToQuery);
member this.GetGroups : System.DirectoryServices.AccountManagement.PrincipalContext -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
[<System.Security.SecurityCritical>]
member this.GetGroups : System.DirectoryServices.AccountManagement.PrincipalContext -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
Public Function GetGroups (contextToQuery As PrincipalContext) As PrincipalSearchResult(Of Principal)

Parâmetros

contextToQuery
PrincipalContext

O objeto PrincipalContext que especifica o contexto no qual a consulta é realizada.

Quando o contexto está localizado em outro domínio, a consulta é realizada na representação dos objetos da entidade de segurança no contexto especificado.

Retornos

Uma coleção de objetos GroupPrincipal que especificam os grupos dos quais a entidade atual é membro.

Atributos

Comentários

Esse método retorna apenas os grupos dos quais a entidade de segurança é diretamente um membro; nenhuma pesquisa recursiva é executada. Os resultados da pesquisa recursiva estão disponíveis para objetos de entidade de segurança do usuário. Para obter mais informações, consulte o método GetAuthorizationGroups.

Os grupos retornados por esse método podem incluir grupos de um escopo e repositório diferentes do principal. Por exemplo, se a entidade de segurança for um objeto AD DS que tenha um DN de "CN=SpecialGroups,DC=Fabrikam,DC=com, o conjunto retornado poderá conter grupos que pertencem a "CN=NormalGroups,DC=Fabrikam,DC=com.

Se a entidade de segurança atual for uma entidade de segurança do AD DS, os grupos retornados incluirão o grupo primário de entidades de segurança, conforme indicado pelo atributo ID do grupo primário no objeto do AD DS.

Confira também

Aplica-se a