Freigeben über


Principal.GetGroups Methode

Definition

Gibt eine Auflistung von Gruppenobjekten zurück, die die Gruppen angeben, deren Member der aktuelle Prinzipal ist.

Überlädt

GetGroups()

Gibt eine Auflistung von Gruppenobjekten zurück, die die Gruppen angeben, deren Member der aktuelle Prinzipal ist.

GetGroups(PrincipalContext)

Gibt eine Auflistung von Gruppenobjekten zurück, deren Member der Prinzipal ist und die im Speicher vorhanden sind, der vom angegebenen Kontextparameter bereitgestellt wird.

Hinweise

Diese überladene Methode gibt nur die Gruppen zurück, deren Element der Prinzipal direkt ist. es werden keine rekursiven Suchvorgänge ausgeführt. Rekursive Suchergebnisse sind für Benutzerprinzipalobjekte verfügbar. Weitere Informationen finden Sie unter der Methode GetAuthorizationGroups.

Wenn der Prinzipalspeicher AD DS ist, enthält die Liste der Gruppen die primäre Gruppe des Benutzers, die durch das Attribut der primären Gruppen-ID im AD DS-Objekt identifiziert wird.

GetGroups()

Quelle:
Principal.cs
Quelle:
Principal.cs
Quelle:
Principal.cs

Gibt eine Auflistung von Gruppenobjekten zurück, die die Gruppen angeben, deren Member der aktuelle Prinzipal ist.

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)

Gibt zurück

Eine Auflistung von GroupPrincipal-Objekten, die die Gruppen angeben, deren Member der aktuelle Prinzipal ist.

Attribute

Hinweise

Diese Methode gibt nur die Gruppen zurück, deren Element der Prinzipal direkt ist. es werden keine rekursiven Suchvorgänge ausgeführt. Rekursive Suchergebnisse sind für Benutzerprinzipalobjekte verfügbar. Weitere Informationen finden Sie unter der Methode GetAuthorizationGroups.

Die Gruppen, die von dieser Methode zurückgegeben werden, können Gruppen aus einem anderen Bereich und Speicher als der Prinzipal enthalten. Wenn der Prinzipal beispielsweise ein AD DS-Objekt mit dem DN "CN=SpecialGroups,DC=Fabrikam,DC=com" ist, kann der zurückgegebene Satz Gruppen enthalten, die zu "CN=NormalGroups,DC=Fabrikam,DC=com" gehören.

Wenn der aktuelle Prinzipal ein AD DS-Prinzipal ist, enthalten die zurückgegebenen Gruppen die primäre Gruppe der Prinzipale, wie das Attribut "primaryGroupId" für das AD DS-Objekt angibt.

Weitere Informationen

Gilt für:

GetGroups(PrincipalContext)

Quelle:
Principal.cs
Quelle:
Principal.cs
Quelle:
Principal.cs

Gibt eine Auflistung von Gruppenobjekten zurück, deren Member der Prinzipal ist und die im Speicher vorhanden sind, der vom angegebenen Kontextparameter bereitgestellt wird.

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)

Parameter

contextToQuery
PrincipalContext

Das PrincipalContext-Objekt, das den Kontext angibt, für den die Abfrage durchgeführt wird.

Wenn sich der Kontext in einer anderen Domäne befindet, wird die Abfrage für die Darstellung des Prinzipalobjekts im angegebenen Kontext durchgeführt.

Gibt zurück

Eine Auflistung von GroupPrincipal-Objekten, die die Gruppen angeben, deren Member der aktuelle Prinzipal ist.

Attribute

Hinweise

Diese Methode gibt nur die Gruppen zurück, deren Element der Prinzipal direkt ist. es werden keine rekursiven Suchvorgänge ausgeführt. Rekursive Suchergebnisse sind für Benutzerprinzipalobjekte verfügbar. Weitere Informationen finden Sie unter der Methode GetAuthorizationGroups.

Die Gruppen, die von dieser Methode zurückgegeben werden, können Gruppen aus einem anderen Bereich und Speicher als der Prinzipal enthalten. Wenn der Prinzipal beispielsweise ein AD DS-Objekt mit dem DN "CN=SpecialGroups,DC=Fabrikam,DC=com" ist, kann der zurückgegebene Satz Gruppen enthalten, die zu "CN=NormalGroups,DC=Fabrikam,DC=com" gehören.

Wenn der aktuelle Prinzipal ein AD DS-Prinzipal ist, enthalten die zurückgegebenen Gruppen die primäre Gruppe der Prinzipale, wie durch das Attribut der primären Gruppen-ID für das AD DS-Objekt angegeben.

Weitere Informationen

Gilt für: