Share via

Managed Email 2007::AddMailboxPermission

  • Article

Adds specific permissions for users or groups to the Specified Mailbox.

Arguments

Input Arguments Required Description

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions.

<user>

Yes

Specifies the LDAP path of the user object for which the mailbox will be created.

<trustee>

Yes

Specifies the mailbox that the permissions are being granted to on the other mailbox.

<database>

No

The unique path of the Exchange Database store..

<accessRights>

Yes

Specifies the rights applied to the mailbox.

<accessRights/ value>

Yes

Specifies the rights applied to the mailbox.

Enum

  • ChangeOwner

  • ChangePermission

  • DeleteItem

  • ExternalAccount

  • FullAccess

  • ReadPermission

<deny>

No

Deny permissions to the mailbox for the specified user.

<inheritanceType>

No

Specifies whether permissions are inherited to folders within the mailbox.

Enum

  • None

  • All

  • Descendents

  • SelfAndChildren

  • Children

Remarks

Security

Caller must be at least a member of role: UserCreators.

Sample Code

Example XML Request

<request> 
  <data> 
    <!--The domain controller to use for Active Directory actions.--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
    <!--The LDAP path of the user mailbox that will get permissions added.--> 
    <user>LDAP://CN=johnc@alpineskihouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</user> 
    <!--Specifies the  mailbox that the permissions are being granted to on the other mailbox.--> 
    <trustee>LDAP://CN=kima@alpineskihouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</trustee> 
    <!--Specifies the rights applied to the mailbox.--> 
    <accessRights> 
      <!--Specifies the rights applied to the mailbox.--> 
      <value>FullAccess</value> 
    </accessRights> 
    <!--Deny permissions to the mailbox for the specified user.--> 
    <deny>true</deny> 
    <!--Specifies whether permissions are inherited to folders within the mailbox.--> 
    <inheritanceType>All</inheritanceType> 
  </data> 
  <procedure> 
    <execute namespace="Managed Email 2007" procedure="AddMailboxPermission" impersonate="1"> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="user" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="trustee" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="accessRights" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="deny" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="inheritanceType" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request>

Applies To

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Other Resources

API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]