Principal.GetGroups Metoda

Definicja

Przestrzeń nazw:

System.DirectoryServices.AccountManagement

Zestaw:

System.DirectoryServices.AccountManagement.dll

Pakiet:

System.DirectoryServices.AccountManagement v8.0.0

Zwraca kolekcję obiektów grupy, które określają grupy, których bieżący podmiot zabezpieczeń jest członkiem.

Przeciążenia

GetGroups()	Zwraca kolekcję obiektów grupy, które określają grupy, których bieżący podmiot zabezpieczeń jest członkiem.
GetGroups(PrincipalContext)	Zwraca kolekcję obiektów grupy, które podmiot zabezpieczeń jest elementem członkowskim i które istnieją w magazynie dostarczonym przez określony parametr kontekstu.

Uwagi

Ta przeciążona metoda zwraca tylko grupy, których podmiot zabezpieczeń jest bezpośrednio członkiem; nie są wykonywane żadne cykliczne wyszukiwania. Wyniki wyszukiwania cyklicznego są dostępne dla obiektów głównych użytkownika. Aby uzyskać więcej informacji, zobacz metodę GetAuthorizationGroups .

Jeśli główny magazyn to USŁUGI AD DS, lista grup zawiera grupę podstawową użytkownika, która jest identyfikowana przez atrybut identyfikatora grupy podstawowej w obiekcie usług AD DS.

GetGroups()

Źródło:

Principal.cs

Zwraca kolekcję obiektów grupy, które określają grupy, których bieżący podmiot zabezpieczeń jest członkiem.

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

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

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

Public Function GetGroups () As PrincipalSearchResult(Of Principal)

Zwraca

PrincipalSearchResult<Principal>

Kolekcja GroupPrincipal obiektów, które określają grupy, których bieżący podmiot zabezpieczeń jest członkiem.

Uwagi

Ta metoda zwraca tylko grupy, z których podmiot zabezpieczeń jest bezpośrednio członkiem; nie są wykonywane żadne cykliczne wyszukiwania. Wyniki wyszukiwania cyklicznego są dostępne dla obiektów głównych użytkownika. Aby uzyskać więcej informacji, zobacz metodę GetAuthorizationGroups .

Grupy zwracane przez tę metodę mogą obejmować grupy z innego zakresu i magazynu niż podmiot zabezpieczeń. Jeśli na przykład podmiot zabezpieczeń jest obiektem usług AD DS, który ma dn "CN=SpecialGroups,DC=Fabrikam,DC=com, zwrócony zestaw może zawierać grupy należące do "CN=NormalGroups,DC=Fabrikam,DC=com.

Jeśli bieżący podmiot zabezpieczeń jest podmiotem zabezpieczeń usług AD DS, zwrócone grupy obejmują grupę podstawową podmiotów zabezpieczeń, wskazaną przez atrybut "primaryGroupId" w obiekcie usług AD DS.

Zobacz też

• GetGroups()

GetGroups(PrincipalContext)

Źródło:

Principal.cs

Zwraca kolekcję obiektów grupy, które podmiot zabezpieczeń jest elementem członkowskim i które istnieją w magazynie dostarczonym przez określony parametr kontekstu.

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

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)

Parametry

contextToQuery

PrincipalContext

PrincipalContext Obiekt, który określa kontekst, na którym jest wykonywane zapytanie.

Gdy kontekst znajduje się w innej domenie, zapytanie jest wykonywane względem reprezentacji obiektów głównych w określonym kontekście.

Zwraca

PrincipalSearchResult<Principal>

Kolekcja GroupPrincipal obiektów, które określają grupy, których bieżący podmiot zabezpieczeń jest członkiem.

Uwagi

Ta metoda zwraca tylko grupy, z których podmiot zabezpieczeń jest bezpośrednio członkiem; nie są wykonywane żadne cykliczne wyszukiwania. Wyniki wyszukiwania cyklicznego są dostępne dla obiektów głównych użytkownika. Aby uzyskać więcej informacji, zobacz metodę GetAuthorizationGroups .

Grupy zwracane przez tę metodę mogą obejmować grupy z innego zakresu i magazynu niż podmiot zabezpieczeń. Jeśli na przykład podmiot zabezpieczeń jest obiektem usług AD DS, który ma dn "CN=SpecialGroups,DC=Fabrikam,DC=com, zwrócony zestaw może zawierać grupy należące do "CN=NormalGroups,DC=Fabrikam,DC=com.

Jeśli bieżący podmiot zabezpieczeń jest podmiotem zabezpieczeń usług AD DS, zwrócone grupy obejmują grupę podstawową podmiotów zabezpieczeń wskazaną przez atrybut identyfikatora grupy podstawowej w obiekcie usług AD DS.

Zobacz też

• GetGroups()