Hosted Email 2007::CreateMailbox

This procedure enables an existing Mailbox user.

Arguments

Input Arguments Type Required Description

<preferredDomainController>

string

Yes

The domain controller to use for Active Directory actions.

<user>

string

Yes

This parameter specifies the Lightweight Directory Access Protocol (LDAP) path of the user object for which the mailbox will be created.

<planName>

string

Yes

The Exchange Hosting Plan to apply to the user.

<alias>

string

Yes

This parameter sets the e-mail alias of the mailbox that you are enabling. The alias can be a combination of characters separated by a period with no intervening spaces. Do not use special characters in the alias.

<database>

string

No

The unique path of the Exchange Database store.

<emailAddresses>

complexType

Yes

This parameter specifies all the proxy addresses of the mailbox. The primary Simple Mail Transfer Protocol (SMTP) address is the first in the list of proxy addresses.

<emailAddresses/ value>

string

Yes

One or more proxy addresses.

<owningOrganization>

string

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.

<planOverrides>

complexType

No

This parameter is used to override default values supplied by plan.

<planOverrides/ issueWarningQuota>

string

No

This parameter specifies the mailbox size in bytes at which a warning message is sent to the user. You must specify either an integer or "unlimited." If you set this attribute on a mailbox, that mailbox setting overrides the value that is set for this attribute on the mailbox database.

<planOverrides/ maxSendSize>

string

No

This parameter specifies the maximum size of messages that this mailbox can send. You must specify either an integer or "unlimited."

<planOverrides/ maxReceiveSize>

string

No

This parameter specifies the maximum size of messages that this mailbox can receive. You must specify either an integer or "unlimited."

<planOverrides/ prohibitSendQuota>

integer

No

This parameter specifies the mailbox size in bytes at which the user associated with this mailbox can no longer send messages. You must specify a positive integer between '1000' and '2,147,483,647'. If you set this attribute on a mailbox, that mailbox setting overrides the value that is set for this attribute on the mailbox database.

<planOverrides/ prohibitSendReceiveQuota>

string

No

This parameter specifies the mailbox size in bytes at which the user associated with this mailbox can no longer send or receive messages. You must specify either an integer or "unlimited." If you set this attribute on a mailbox, that mailbox setting overrides the value that is set for this attribute on the mailbox database.

<planOverrides/ recipientLimits>

string

No

This parameter specifies the maximum number of recipients per message to which this mailbox can send. You must specify either an integer or "unlimited." If you set this attribute on a mailbox, that mailbox setting overrides the value that is set for this attribute on the mailbox database.

<planOverrides/ hiddenFromAddressListsEnabled>

boolean

No

This parameter specifies whether this mailbox is hidden from other address lists.

<planOverrides/ imapEnabled>

boolean

No

This parameter specifies whether the IMAP4 protocol is enabled for this mailbox.

<planOverrides/ popEnabled>

boolean

No

This parameter specifies whether the POP3 protocol is enabled for this mailbox.

<planOverrides/ owaEnabled>

boolean

No

This parameter enables Outlook Web Access (OWA).

<planOverrides/ mapiEnabled>

boolean

No

This parameter specifies whether the MAPI protocol is enabled for this mailbox.

<planOverrides/ activeSyncEnabled >

boolean

No

This parameter specifies whether the ActiveSync is enabled for this mailbox.

<planOverrides/ mapiBlockOutlookNonCachedMode>

boolean

No

This parameter specifies whether Outlook can be used in non-cached mode.

<planOverrides/ mapiBlockOutlookRpcHttp>

boolean

No

This parameter specifies whether clients can connect to Outlook by using Outlook Anywhere.

<planOverrides/ owaAllAddressListsEnabled>

boolean

No

This parameter specifies whether all address lists are available in Outlook Web Access.

<planOverrides/ owaContactsEnabled>

boolean

No

This parameter specifies whether contacts are enabled in Outlook Web Access.

<planOverrides/ owaCalendarEnabled>

boolean

No

This parameter specifies whether calendaring is enabled in Outlook Web Access.

<planOverrides/ owaChangePasswordEnabled>

boolean

No

This parameter specifies whether a user can change their password in Outlook Web Access.

<planOverrides/ owaJournalEnabled>

boolean

No

This parameter specifies whether the Journal folder can be accessed in Outlook Web Access.

<planOverrides/ owaTasksEnabled>

boolean

No

This parameter specifies whether tasks are enabled in Outlook Web Access.

<planOverrides/ owaNotesEnabled>

boolean

No

This parameter specifies whether Sticky Notes are enabled in Outlook Web Access.

<planOverrides/ owaRemindersAndNotificationsEnabled>

boolean

No

This parameter specifies whether calendar reminders are enabled in Outlook Web Access.

<planOverrides/ owaPremiumClientEnabled>

boolean

No

This parameter specifies whether Outlook Web Access Premium version is enabled.

<planOverrides/ owaSpellCheckerEnabled>

boolean

No

This parameter specifies whether the spelling checker is enabled in Outlook Web Access.

<planOverrides/ owaSearchFoldersEnabled>

boolean

No

This parameter specifies whether search folders are enabled in Outlook Web Access.

<planOverrides/ owaSignaturesEnabled>

boolean

No

This parameter specifies whether the signature feature is enabled in Outlook Web Access.

<planOverrides/ owaThemeSelectionEnabled>

boolean

No

This parameter specifies whether theme selection is enabled in Outlook Web Access.

<planOverrides/ owaJunkEmailEnabled>

boolean

No

This parameter specifies whether junk e-mail is enabled in Outlook Web Access.

<planOverrides/ owaUMIntegrationEnabled>

boolean

No

This parameter specifies whether Unified Messaging (UM) integration is enabled in Outlook Web Access.

<planOverrides/ owaActiveSyncIntegrationEnabled>

boolean

No

This parameter specifies whether Outlook Web Access Exchange ActiveSync mobile options are enabled.

<planOverrides/ owaUNCAccessOnPrivateComputersEnabled>

boolean

No

This parameter specifies whether Universal Naming Convention (UNC) access is permitted when users select This is a private computer on the logon page.

<planOverrides/ owaUNCAccessOnPublicComputersEnabled>

boolean

No

This parameter specifies whether UNC access is permitted when users select This is a public or shared computer on the logon page.Access.

<planOverrides/ owaWSSAccessOnPrivateComputersEnabled>

boolean

No

This parameter specifies whether SharePoint Portal Server access is permitted when users select This is a private computer on the logon page.

<planOverrides/ owaWSSAccessOnPublicComputersEnabled>

boolean

No

This parameter specifies whether SharePoint Portal Server access is permitted when users select This is a public or shared computer on the logon page.

<planOverrides/ owaPublicFoldersEnabled>

boolean

No

Specifies whether the viewing of public folders is enabled in Outlook Web Access.

<planOverrides/ owaRecoverDeletedItemsEnabled>

boolean

No

Specifies whether recovery of deleted items is enabled in Outlook Web Access.

<planOverrides/ owaRulesEnabled>

boolean

No

Specifies whether rules can be accessed in Outlook Web Access. If this parameter is set to false, server rules will continue to function, but cannot be modified in Outlook Web Access.

<planOverrides/ owaSMimeEnabled>

boolean

No

Specifies whether viewing of e-mail that is encrypted by using S/MIME is supported in Outlook Web Access.

Remarks

Security

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

Schema Definition

Input

<executeData>  
        <preferredDomainController>1..1 </preferredDomainController> 
        <user>1..1 </user> 
        <planName>1..1 </planName> 
        <alias>1..1 </alias> 
        <database>0..1 </database> 
        <emailAddresses>1..1  
                <value>1..unbounded </value> 
        </emailAddresses> 
        <owningOrganization>0..1 </owningOrganization> 
        <planOverrides>0..1  
                <issueWarningQuota>0..1 </issueWarningQuota> 
                <maxSendSize>0..1 </maxSendSize> 
                <maxReceiveSize>0..1 </maxReceiveSize> 
                <prohibitSendQuota>0..1 </prohibitSendQuota> 
                <prohibitSendReceiveQuota>0..1 </prohibitSendReceiveQuota> 
                <recipientLimits>0..1 </recipientLimits> 
                <hiddenFromAddressListsEnabled>0..1 </hiddenFromAddressListsEnabled> 
                <imapEnabled>0..1 </imapEnabled> 
                <popEnabled>0..1 </popEnabled> 
                <owaEnabled>0..1 </owaEnabled> 
                <mapiEnabled>0..1 </mapiEnabled> 
                <activeSyncEnabled>0..1 </activeSyncEnabled> 
                <mapiBlockOutlookNonCachedMode>0..1 </mapiBlockOutlookNonCachedMode> 
                <mapiBlockOutlookRpcHttp>0..1 </mapiBlockOutlookRpcHttp> 
                <owaAllAddressListsEnabled>0..1 </owaAllAddressListsEnabled> 
                <owaContactsEnabled>0..1 </owaContactsEnabled> 
                <owaCalendarEnabled>0..1 </owaCalendarEnabled> 
                <owaChangePasswordEnabled>0..1 </owaChangePasswordEnabled> 
                <owaJournalEnabled>0..1 </owaJournalEnabled> 
                <owaTasksEnabled>0..1 </owaTasksEnabled> 
                <owaNotesEnabled>0..1 </owaNotesEnabled> 
                <owaRemindersAndNotificationsEnabled>0..1 </owaRemindersAndNotificationsEnabled> 
                <owaPremiumClientEnabled>0..1 </owaPremiumClientEnabled> 
                <owaSpellCheckerEnabled>0..1 </owaSpellCheckerEnabled> 
                <owaSearchFoldersEnabled>0..1 </owaSearchFoldersEnabled> 
                <owaSignaturesEnabled>0..1 </owaSignaturesEnabled> 
                <owaThemeSelectionEnabled>0..1 </owaThemeSelectionEnabled> 
                <owaJunkEmailEnabled>0..1 </owaJunkEmailEnabled> 
                <owaUMIntegrationEnabled>0..1 </owaUMIntegrationEnabled> 
                <owaActiveSyncIntegrationEnabled>0..1 </owaActiveSyncIntegrationEnabled> 
                <owaUNCAccessOnPrivateComputersEnabled>0..1 </owaUNCAccessOnPrivateComputersEnabled> 
                <owaUNCAccessOnPublicComputersEnabled>0..1 </owaUNCAccessOnPublicComputersEnabled> 
                <owaWSSAccessOnPrivateComputersEnabled>0..1 </owaWSSAccessOnPrivateComputersEnabled> 
                <owaWSSAccessOnPublicComputersEnabled>0..1 </owaWSSAccessOnPublicComputersEnabled> 
                <owaPublicFoldersEnabled>0..1 </owaPublicFoldersEnabled> 
                <owaRecoverDeletedItemsEnabled>0..1 </owaRecoverDeletedItemsEnabled> 
                <owaRulesEnabled>0..1 </owaRulesEnabled> 
                <owaSMimeEnabled>0..1 </owaSMimeEnabled> 
        </planOverrides> 
</executeData> 
 

Output

<executeData>1..1 </executeData>

Sample Code

Example XML Request

<request> 
  <data> 
    <!--The domain controller to use for Active Directory actions.--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
    <!--Specifies the LDAP path of the user object for which the mailbox will be created.--> 
    <user>LDAP://CN=johnc@AlpineSkiHouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</user> 
    <!--The Exchange Hosting Plan to apply to the user.--> 
    <planName>GoldMailbox</planName> 
    <!--Sets the e-mail alias of the mailbox that you are enabling.  The alias can be a combination of characters separated by a period with no intervening spaces. Do not use special characters in the alias.--> 
    <alias>johnc</alias> 
    <!--The unique path of the Exchange Database store.--> 
    <database>EXMBXCLUS01\SG01\HostedMailstore01</database> 
    <!--Specifies all the proxy addresses of the mailbox.  The primary Simple Mail Transfer Protocol (SMTP) address is the first in the list of proxy addresses.--> 
    <emailAddresses> 
      <!--One or more proxy addresses.--> 
      <value>johnc@alpineskihouse.com</value> 
    </emailAddresses> 
    <!--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.--> 
    <owningOrganization>LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</owningOrganization> 
    <!--Used to override default values supplied by plan--> 
    <planOverrides> 
      <!--Specifies the mailbox size in bytes at which a warning message is sent to the user.  You must specify either an integer or "unlimited."  If you set this attribute on a mailbox, that mailbox setting overrides the value that is set for this attribute on the mailbox database.--> 
      <issueWarningQuota>9000</issueWarningQuota> 
      <!--Specifies the maximum size of messages that this mailbox can send. You must specify either an integer or "unlimited."--> 
      <maxSendSize>10000</maxSendSize> 
      <!--Specifies the maximum size of messages that this mailbox can receive. You must specify either an integer or "unlimited."--> 
      <maxReceiveSize>10000</maxReceiveSize> 
      <!--Specifies the mailbox size in bytes at which the user associated with this mailbox can no longer send messages.  You must specify a positive integer.  If you set this attribute on a mailbox, that mailbox setting overrides the value that is set for this attribute on the mailbox database.--> 
      <prohibitSendQuota>10000</prohibitSendQuota> 
      <!--Specifies the mailbox size in bytes at which the user associated with this mailbox can no longer send or receive messages.  You must specify either an integer or "unlimited."  If you set this attribute on a mailbox, that mailbox setting overrides the value that is set for this attribute on the mailbox database.--> 
      <prohibitSendReceiveQuota>20000</prohibitSendReceiveQuota> 
      <!--Specifies the maximum number of recipients per message to which this mailbox can send.  You must specify either an integer or "unlimited."  If you set this attribute on a mailbox, that mailbox setting overrides the value that is set for this attribute on the mailbox database.--> 
      <recipientLimits>unlimited</recipientLimits> 
      <!--Specifies whether this mailbox is hidden from other address lists.--> 
      <hiddenFromAddressListsEnabled>true</hiddenFromAddressListsEnabled> 
      <!--Specifies whether the IMAP4 protocol is enabled for this mailbox.--> 
      <imapEnabled>true</imapEnabled> 
      <!--Specifies whether the POP3 protocol is enabled for this mailbox.--> 
      <popEnabled>true</popEnabled> 
      <!--Enables Outlook Web Access.--> 
      <owaEnabled>true</owaEnabled> 
      <!--Specifies whether the MAPI protocol is enabled for this mailbox.--> 
      <mapiEnabled>true</mapiEnabled> 
      <!--Specifies whether ActiveSync is enabled for this mailbox.--> 
      <activeSyncEnabled>true</activeSyncEnabled> 
      <!--Specifies whether Outlook can be used in non-cached mode.--> 
      <mapiBlockOutlookNonCachedMode>true</mapiBlockOutlookNonCachedMode> 
      <!--Specifies whether clients can connect to Outlook by using Outlook Anywhere.--> 
      <mapiBlockOutlookRpcHttp>false</mapiBlockOutlookRpcHttp> 
      <!--Specifies whether all address lists are available in Outlook Web Access.--> 
      <owaAllAddressListsEnabled>false</owaAllAddressListsEnabled> 
      <!--Specifies whether contacts are enabled in Outlook Web Access.--> 
      <owaContactsEnabled>true</owaContactsEnabled> 
      <!--Specifies whether calendaring is enabled in Outlook Web Access.--> 
      <owaCalendarEnabled>true</owaCalendarEnabled> 
      <!--Specifies whether a user can change their password in Outlook Web Access.--> 
      <owaChangePasswordEnabled>false</owaChangePasswordEnabled> 
      <!--Specifies whether the Journal folder can be accessed in Outlook Web Access.--> 
      <owaJournalEnabled>true</owaJournalEnabled> 
      <!--Specifies whether tasks are enabled in Outlook Web Access.--> 
      <owaTasksEnabled>true</owaTasksEnabled> 
      <!--Specifies whether Sticky Notes are enabled in Outlook Web Access.--> 
      <owaNotesEnabled>true</owaNotesEnabled> 
      <!--Specifies whether calendar reminders are enabled in Outlook Web Access.--> 
      <owaRemindersAndNotificationsEnabled>true</owaRemindersAndNotificationsEnabled> 
      <!--Specifies whether Outlook Web Access Premium version is enabled.--> 
      <owaPremiumClientEnabled>true</owaPremiumClientEnabled> 
      <!--Specifies whether the spelling checker is enabled in Outlook Web Access.--> 
      <owaSpellCheckerEnabled>true</owaSpellCheckerEnabled> 
      <!--Specifies whether search folders are enabled in Outlook Web Access.--> 
      <owaSearchFoldersEnabled>true</owaSearchFoldersEnabled> 
      <!--Specifies whether the signature feature is enabled in Outlook Web Access.--> 
      <owaSignaturesEnabled>true</owaSignaturesEnabled> 
      <!--Specifies whether theme selection is enabled in Outlook Web Access.--> 
      <owaThemeSelectionEnabled>true</owaThemeSelectionEnabled> 
      <!--Specifies whether junk e-mail is enabled in Outlook Web Access.--> 
      <owaJunkEmailEnabled>true</owaJunkEmailEnabled> 
      <!--Specifies whether Unified Messaging (UM) integration is enabled in Outlook Web Access.--> 
      <owaUMIntegrationEnabled>true</owaUMIntegrationEnabled> 
      <!--Specifies whether Outlook Web Access Exchange ActiveSync mobile options are enabled.--> 
      <owaActiveSyncIntegrationEnabled>true</owaActiveSyncIntegrationEnabled> 
      <!--Specifies whether Universal Naming Convention (UNC) access is permitted when users select This is a private computer on the logon page.--> 
      <owaUNCAccessOnPrivateComputersEnabled>true</owaUNCAccessOnPrivateComputersEnabled> 
      <!--Specifies whether UNC access is permitted when users select This is a public or shared computer on the logon page.--> 
      <owaUNCAccessOnPublicComputersEnabled>true</owaUNCAccessOnPublicComputersEnabled> 
      <!--Specifies whether SharePoint Portal Server access is permitted when users select This is a private computer on the logon page.--> 
      <owaWSSAccessOnPrivateComputersEnabled>true</owaWSSAccessOnPrivateComputersEnabled> 
      <!--Specifies whether SharePoint Portal Server access is permitted when users select This is a public or shared computer on the logon page.--> 
      <owaWSSAccessOnPublicComputersEnabled>true</owaWSSAccessOnPublicComputersEnabled> 
      <!--Specifies whether the viewing of public folders is enabled in Outlook Web Access.--> 
      <owaPublicFoldersEnabled>true</owaPublicFoldersEnabled> 
      <!--Specifies whether recovery of deleted items is enabled in Outlook Web Access.--> 
      <owaRecoverDeletedItemsEnabled>true</owaRecoverDeletedItemsEnabled> 
      <!--Specifies whether rules can be accessed in Outlook Web Access. If this parameter is set to false, server rules will continue to function, but cannot be modified in Outlook Web Access.--> 
      <owaRulesEnabled>true</owaRulesEnabled> 
      <!--Specifies whether viewing of e-mail that is encrypted by using S/MIME is supported in Outlook Web Access.--> 
      <owaSMimeEnabled>true</owaSMimeEnabled> 
    </planOverrides> 
    <!--Name of the OAB CAS pool, which will be used for web based OAB distribution.--> 
    <oabCASPool>CasOABPool001</oabCASPool> 
    <!--Tag of the OAB CAS pool, which will be used for web based OAB distribution.--> 
    <oabCASPoolTag>Non HA</oabCASPoolTag> 
  </data> 
  <procedure> 
    <execute namespace="Hosted Email 2007" procedure="CreateMailbox" impersonate="1"> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="user" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="planName" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="alias" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="database" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="emailAddresses" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="owningOrganization" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="planOverrides" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="oabCASPool" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="oabCASPoolTag" 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::DeleteMailbox
Hosted Email 2007::DisableMailbox
Hosted Email 2007::EnableMailbox
Hosted Email 2007::GetMailbox
Hosted Email 2007::ModifyMailbox
Hosted Email 2007::MoveMailbox