Share via


Managed Active Directory::DistributeGroupMemberships

The DistributeGroupMemberships method redistributes the group membership for the next group pending. This procedure must be called once for each group that is pending. Use the GetWin2KCapacityPending procedure to return the groups whose membership needs to be redistributed after a call to ExpandWin2KCapacity.

Arguments

Input Arguments Required Description

<organization>

Yes

The Lightweight Directory Access Protocol (LDAP) path of the organization for which group membership needs to be distributed

<capacityType>

Yes

The capacity type of the group. Possible values are:

  • UserN: This type is used to limit the users per organization.

  • ChildOrgN: This type is used to limit the child organizations per organization.

<preferredDomainController>

No

The domain controller to be used for this request

Remarks

Security

  • Impersonate caller.

Sample Code

Example XML Request

<request> 
  <procedure> 
    <execute namespace="Managed Active Directory" procedure="DistributeGroupMemberships" impersonate="1"> 
      <executeData> 
        <organization>LDAP://ou=Hosting,dc=contoso01,dc=com</organization> 
        <capacityType>UserN</capacityType> 
      </executeData> 
      <after source="executeData" destination="data"  /> 
    </execute>     
  </procedure> 
</request> 

Example XML Response

<response> 
  <data> 
    <executeData> 
      <organization>LDAP://ou=Hosting,dc=contoso01,dc=com</organization> 
      <capacityType>UserN</capacityType> 
      <processed>LDAP://CN=AllUsers@Hosting,CN=_Private,OU=Hosting,DC=contoso01,DC=com</processed> 
    </executeData> 
  </data> 
</response>

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