Principal.GetGroups Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
