GroupPrincipal.Members Eigenschaft

Definition

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Quelle:

Group.cs

Ruft eine Auflistung von Prinzipalobjekten ab, die die Member der Gruppe darstellen.

public:
 property System::DirectoryServices::AccountManagement::PrincipalCollection ^ Members { System::DirectoryServices::AccountManagement::PrincipalCollection ^ get(); };

public System.DirectoryServices.AccountManagement.PrincipalCollection Members { get; }

member this.Members : System.DirectoryServices.AccountManagement.PrincipalCollection

Public ReadOnly Property Members As PrincipalCollection

Eigenschaftswert

PrincipalCollection

Ein PrincipalCollection-Objekt mit den Prinzipalobjekten, die die Member der Gruppe darstellen.

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.

Es wird eine Suche 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, wird der Benutzer mit dem Namen "John Smith" aus der Gruppe entfernt, und der Benutzer mit dem Namen "Jim Daly" wird der Gruppe hinzugefügt.

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)  
{  
    grp.Members.Remove(ctx, IdentityType.Name, "John Smith");            
    grp.Members.Add(ctx, IdentityType.Name, "Jim Daly");  
    grp.Save();  
    grp.Dispose();  
}  
ctx.Dispose();  

Hinweise

Für AD DS-Gruppen enthält die Members -Eigenschaft Benutzerprinzipale, die aufgrund ihres primaryId-Attributs Mitglieder der Gruppe sind. Wenn die Gruppe diese Membertypen enthält, gelten die folgenden Einschränkungen:

• Die Remove -Methode kann nicht verwendet werden, um Mitglieder zu entfernen, die Teil der Gruppe sind, aufgrund ihres primaryId-Attributs.

• Die Clear -Methode kann aufgrund ihres primaryId-Attributs nicht zum Löschen von Elementen verwendet werden, die Teil der Gruppe sind.