Hosted Exchange::ModifyDistributionList

  • Article

This procedure modifies a distribution list.

Arguments

Input argument Required Description

<path>

Yes

The Lightweight Directory Access Protocol (LDAP) path of distribution list group.

<preferredDomainController>

Yes

<managedBy>

Yes

The UserPrinciaplName of the user with the managedByrights to the group (<user>@<SMTPDomian> for example, user1@alpineskihouse.com).

Remarks

Provisioning Steps

  1. Preferred DC Active Directory Provider::Search - Get DN of the group and UPN.

  2. Preferred DC Active Directory Provider::Set Properties - Set the managedBy property of the group to the user.

Security

Impersonate caller.

Sample Code

Example XMl Request

  
<request xmlns:xsl="https://www.w3.org/1999/XSL/Transform">  
        <procedure xmlns:xsl='https://www.w3.org/1999/XSL/Transform'>  
                <execute namespace="Hosted Exchange" procedure="ModifyDistributionList" impersonate="1">  
                         <executeData>  
                                <preferredDomainController>AD01.fabrikam.com</preferredDomainController>   
                                <path>LDAP://CN=MyDistributionListName,OU=alpineskihouse,OU=WH,OU=Hosting,DC=fabrikam,DC=Com</path>  
                                <managedBy>user2@alpineskihouse.com</managedBy>  
                        </executeData>  
                        <after source="executeData" destination="data" mode="merge"/>  
                </execute>  
        </procedure>  
</request>

Applies To

Hosted Exchange Namespace API for:

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

See also

Tasks

Hosted Exchange::CreateDistributionList
Hosted Exchange::DeleteDistributionList