GroupPrincipal.GetMembers Methode

Definition

Gibt eine Auflistung der Prinzipalobjekte zurück, die in der Gruppe enthalten ist.

Überlädt

GetMembers()

Gibt eine Auflistung der Prinzipalobjekte zurück, die in der Gruppe enthalten ist.

GetMembers(Boolean)

Gibt eine Auflistung der Prinzipalobjekte zurück, die in der Gruppe enthalten ist. Wenn das rekursive Flag auf true festgelegt ist, wird die aktuelle Gruppe von der Methode rekursiv durchsucht und alle geschachtelten Gruppenmember werden zurückgegeben.

GetMembers()

Gibt eine Auflistung der Prinzipalobjekte zurück, die in der Gruppe enthalten ist.

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)

Gibt zurück

Ein PrincipalSearchResult<T>-Objekt mit den Prinzipalobjekten, die Member der Gruppe sind, oder eine leere Auflistung, wenn die Gruppe keine Member aufweist.

Hinweise

Diese Methode durchsucht die aktuelle Gruppe nicht rekursiv. Daher können Gruppenobjekte in der Prinzipalobjektauflistung zurückgegeben werden.

Member werden ohne Berücksichtigung des Kontexts zurückgegeben. Wenn beispielsweise ein AD DS-Kontext auf der Grundlage von "CN=SpecialUsers,DC=Fabrikam,DC=com" basiert, enthält der PrincipalFindResult-Satz auch Gruppenmitglieder, die sich unter "CN=NormalUsers,DC=Fabrikam,DC=com" befinden, auch wenn sie unter einen Bereich fallen, der nicht Teil des durchsuchten Kontexts ist. Die zurückgegebene Prinzipalauflistung kann auch Mitglieder enthalten, die sich in einem anderen Speicher als die Gruppe befinden.

Gilt für:

GetMembers(Boolean)

Gibt eine Auflistung der Prinzipalobjekte zurück, die in der Gruppe enthalten ist. Wenn das rekursive Flag auf true festgelegt ist, wird die aktuelle Gruppe von der Methode rekursiv durchsucht und alle geschachtelten Gruppenmember werden zurückgegeben.

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)

Parameter

recursive
Boolean

Ein boolescher Wert, der angibt, ob die Gruppe rekursiv durchsucht wird.

Gibt zurück

Ein PrincipalSearchResult<T>-Objekt mit den Prinzipalobjekten, die Member der Gruppe sind, oder eine leere Auflistung, wenn die Gruppe keine Member aufweist.

Beispiele

Der folgende Code stellt eine Verbindung mit der LDAP-Domäne "fabrikam.com" her, wobei der Benutzername auf "administrator" und das Kennwort im PrincipalContext Konstruktor auf "SecretPwd123" festgelegt ist.

Eine Suche wird durchgeführt, um die Gruppe mit dem Namen "Domänenadministratoren" unter dem Container zu finden, der PrincipalContext im Konstruktor "DC=fabrikam,DC=com" angegeben ist. Wenn die Gruppe gefunden wird, werden alle Prinzipale, die Mitglieder dieser Gruppe sind, einschließlich rekursiver Elemente, aufgelistet.

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

Hinweise

Die zurückgegebene Prinzipalauflistung enthält keine Gruppenobjekte, wenn das rekursive Flag auf truefestgelegt ist. Es werden nur Blattknoten zurückgegeben. Wenn beispielsweise eine Gruppe rekursiv durchsucht wird, die ein Computerobjekt und ein Gruppenobjekt (nur mit Benutzerprinzipalen) enthält, enthält die zurückgegebene Auflistung das Computerobjekt und die Benutzerprinzipalobjekte in der geschachtelten Gruppe. Da das Gruppenobjekt kein Blatt ist, wird es in der rekursiven Suche nicht zurückgegeben, auch wenn es leer ist. Wenn das rekursive Flag auf falsefestgelegt ist, kann die zurückgegebene Auflistung Gruppenobjekte enthalten.

Member werden ohne Berücksichtigung des Kontexts zurückgegeben. Wenn beispielsweise ein AD DS-Kontext auf der Grundlage von "CN=SpecialUsers,DC=Fabrikam,DC=com" basiert, enthält der PrincipalFindResult-Satz auch Gruppenmitglieder, die sich unter "CN=NormalUsers,DC=Fabrikam,DC=com" befinden, auch wenn sie unter einen Bereich fallen, der nicht Teil des durchsuchten Kontexts ist. Die zurückgegebene Prinzipalauflistung kann auch Mitglieder enthalten, die sich in einem anderen Speicher als die Gruppe befinden.

Gilt für: