GroupPrincipal.Members 屬性

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v8.0.0

來源:

Group.cs

取得代表群組成員之主體物件的集合。

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

屬性值

PrincipalCollection

PrincipalCollection 物件，包含代表群組成員的主體物件。

範例

下列程式代碼會連線到LDAP網域 fabrikam.com“，並將使用者名稱設定為 ”administrator“，並在建構函式中 PrincipalContext 將密碼設定為 ”SecretPwd123“。

系統會執行搜尋，以在建構函式 「DC=fabrikam，DC=com」 中指定的容器下尋找名稱為 「Domain Admins」 的 PrincipalContext 群組。如果找到群組，則會從群組中移除名稱為 「John Smith」 的使用者，並將名稱為 「Jim Daly」 的使用者新增至群組

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

備註

針對 AD DS 群組， Members 屬性包含用戶主體，這些主體是群組的成員，因為其 primaryId 屬性。 當群組包含這些成員類型時，適用下列限制：

• Remove方法無法用來移除屬於群組一部分的成員，因為其 primaryId Attribute。

• Clear方法無法用來清除屬於群組一部分的成員，因為其 primaryId Attribute。