Managed Active Directory::ModifyGroup

The ModifyGroup procedure modifies a group in Active Directory.

Arguments

Input Arguments	Required	Description
<group>	Yes	The Lightweight Directory Access Protocol (LDAP) path of the group.
<groupType>	No	The type of group that you want to modify. The different group types are: GLOBAL SECURITY - A global security group can contain users, groups, and computers from its own domain as members. Global security groups can be granted rights and permissions for resources in any domain in the forest. LOCAL SECURITY - A local security group can be granted rights and permissions on only resources on the computer on which the group is created. Local groups can have any user accounts that are local to the computer as members, as well as users, groups, and computers from a domain to which the computer belongs. UNIVERSAL SECURITY - A universal security group can contain users, groups, and computers from any domain in its forest as members. Universal security groups can be granted rights and permissions on resources in any domain in the forest. Note If you do not specify a group type, the value defaults to GLOBAL SECURITY.
<description>	No	The description for the group.
<preferredDomainController>	No	The domain controller to use for this request. Using a single preferred domain controller eliminates replication delays that can arise between multiple controllers.

Remarks

Security

• Impersonate Caller.

Sample Code

Example XML Request

<request> 
  <procedure> 
    <execute namespace="Managed Active Directory" procedure="ModifyGroup" impersonate="1"> 
      <executeData> 
        <group>LDAP:// CN=myGroup1,DC=contoso,DC=com</group> 
        <groupType>UNIVERSAL SECURITY</groupType> 
        <description>Describes the modified group</description> 
        <properties> 
        </properties> 
        <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::RenameGroup