GroupPrincipal.Members Propriedade

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Origem:

Group.cs

Obtém uma coleção de objetos de entidade de segurança que representam os membros do grupo.

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

Valor da propriedade

PrincipalCollection

Um objeto PrincipalCollection que contém os objetos de entidade de segurança que representam os membros do grupo.

Exemplos

O código a seguir se conecta ao domínio LDAP "fabrikam.com" com o nome de usuário definido como "administrador" e a senha definida como "SecretPwd123" no PrincipalContext construtor.

Uma pesquisa é realizada para localizar o grupo que tem o nome "Administradores de Domínio" no contêiner especificado no PrincipalContext construtor , "DC=fabrikam,DC=com". Se o grupo for encontrado, o usuário que tem o nome "John Smith" será removido do grupo e o usuário que tem o nome "Jim Daly" será adicionado ao grupo

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

Comentários

Para grupos do AD DS, a Members propriedade inclui entidades de segurança de usuário que são membros do grupo devido ao atributo primaryId. Quando o grupo contém esses tipos de membros, as seguintes restrições se aplicam:

• O Remove método não pode ser usado para remover membros que fazem parte do grupo devido ao atributo primaryId.

• O Clear método não pode ser usado para limpar membros que fazem parte do grupo devido ao atributo primaryId.