Share via


Managed Active Directory::GroupAdd

The GroupAdd procedure adds a member to a group in Active Directory.

Arguments

Input Arguments Required Description

<group>

Yes

The Lightweight Directory Access Protocol (LDAP) path of the group to which you want to add a member.

<newMember>

Yes

The LDAP path of the object (for example, a user or another group) that you want to add to the group.

<preferredDomainController>

No

The domain controller that you want to use for this request. Using a single preferred domain controller eliminates replication delays that arise between multiple controllers.

Remarks

Security

  • Impersonate Caller.

Sample Code

Example XML Request

<request> 
  <procedure> 
    <execute namespace="Managed Active Directory" procedure="GroupAdd" impersonate="1"> 
      <executeData> 
        <group>LDAP://CN=Administrators,CN=Users,DC=contoso,DC=com</group> 
        <newMember>LDAP://CN=myUser1,CN=Users,DC=contoso,DC=com</newMember> 
        <preferredDomainController>myPrimaryDC.contoso.com</preferredDomainController> 
      </executeData> 
    </execute> 
  </procedure> 
</request> 

Applies To

Managed Active Directory Namespace APIManaged Active Directory Namespace API for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Managed Active Directory::GroupRemove