Hosted Email 2007::AddFolderPermission

This procedure adds permission to an existing public folder.

Arguments

Input Arguments	Required	Description
<organization>	Yes	The Lightweight Directory Access Protocol (LDAP) path of the organization.
<preferredDomainController>	Yes	The domain controller to use for Active Directory actions.
<user>	Yes	The LDAP path of the object to grant folder permissions to.
<name>	Yes	The name of the Public Folder.
<allowedRights>	Yes	The collection of one or more allowedRight definitions.
<allowedRights/ allowedRight>	Yes	One or more allowedRight definitions.
<server>	No	This parameter specifies the path of the hosted organization that contains the AL, GAL, and OAB as well-known-objects. By default, it is the LDAP parent container of the object. Note parameter server is obsolete in Hosted Messaging and Collaboration version 4.5.

Remarks

In cases where there are multiple Exchange Servers that home the Public Folder Tree Hierarchy, it will be necessary to always pass the optional <server> parameter.

Security

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

Schema Definition

Input

<executeData>  
<organization>1..1 </organization> 
<preferredDomainController>1..1 </preferredDomainController> 
<user>1..1 </user> 
<name>1..1 </name> 
<allowedRights>1..1  
<allowedRight>1..unbounded </allowedRight> 
</allowedRights> 
<server>0..1 </server> 
</executeData> 

Output

<executeData>1..1 </executeData>

Sample Code

Example XML Request

<request> 
  <data> 
    <!--The LDAP Path of the organization--> 
    <organization>LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</organization> 
    <!--The domain controller to use for Active Directory actions.--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
    <!--The LDAP path of the object to grant folder permissions to.--> 
    <user>LDAP://CN=Admins@AlpineSkiHouse,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</user> 
    <!--The name of the Public Folder.--> 
    <name>Legal</name> 
    <!--Collection of one or more allowedRight definitions.--> 
    <allowedRights> 
      <!--One or more allowedRight definitions.--> 
      <allowedRight>Publishing Editor</allowedRight> 
    </allowedRights> 
    <!--Obsolete. Specifies the server on which the public folder resides.--> 
    <server>EXMBXOAB01</server> 
  </data> 
  <procedure> 
    <execute namespace="Hosted Email 2007" procedure="AddFolderPermission" impersonate="1"> 
      <before source="data" sourcePath="organization" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="user" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="name" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="allowedRights" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="server" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request> 

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::CreateFolder
Hosted Email 2007::DeleteFolder
Hosted Email 2007::MailEnableFolder
Hosted Email 2007::MailDisableFolder
Hosted Email 2007::ModifyFolder
Hosted Email 2007::RemoveFolderPermission