Hosted Email 2007::ModifyDistributionList

  • Article

This procedure modifies a distribution list.

Arguments

Input Arguments Required Description

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions.

<group>

Yes

The Lightweight Directory Access Protocol (LDAP) path of an existing universal group.

<managedBy>

Yes

The principal name of the user with the managedBy rights to the group--for example,user1@alpineskihouse.com.

Remarks

Security

The caller must be at least a member of role: Business Users.

Schema Definition

Input

<executeData>  
<group>1..1 </group> 
<preferredDomainController>1..1 </preferredDomainController> 
<managedBy>1..1 </managedBy> 
</executeData>

Output

<executeData>1..1 </executeData>

Sample Code

Example XML Request

<request> 
  <data> 
    <!--LDAP path of the distribution list. --> 
    <group>LDAP://CN=Sales@AlpineSkiHouse,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</group> 
    <!--FQDN of a domain controller. --> 
    <preferredDomainController>AD01.Fabrikam.com</preferredDomainController> 
    <!--UserPrincipalName of the user with the managedBy rights to the group. For example: johnc@AlpineSkiHouse.com--> 
    <managedBy>johnc@AlpineSkiHouse.com</managedBy> 
  </data> 
  <procedure> 
    <execute namespace="Hosted Email 2007" procedure="ModifyDistributionList" impersonate="1"> 
      <before source="data" sourcePath="group" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="managedBy" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request>

Example XML Response

<response>  
        <data /> 
</response>

Applies To

Hosted Email 2007 Namespace for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Tasks

Hosted Email 2007::ModifyDistributionList
Hosted Email 2007::CreateDistributionList
Hosted Email 2007::DeleteDistributionList
Hosted Email 2007::MailDisableGroup
Hosted Email 2007::MailEnableGroup