Applies to: Exchange Server 2013

Topic Last Modified: 2013-02-21

Site mailbox provisioning policies apply only to email that’s sent to and from the site mailbox and to the size of the site mailbox on the Exchange server.

To learn more about site mailboxes, see Site Mailboxes.

What do you need to know before you begin?

  • Estimated time to complete each procedure: 5 minutes.

  • You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the"Site mailboxes" entry in the Sharing and Collaboration Permissions topic.

  • For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard Shortcuts in the Exchange Admin Center.

  • Although you can create multiple site mailbox provisioning policies, only the default provisioning policy will be applied to all site mailboxes. You can’t apply multiple policies within your organization.

  • You can’t use the Exchange Administration Center (EAC) to perform this procedure. You must use the Shell.

Having problems? Ask for help in the Exchange forums. Visit the forums at: Exchange Server, Exchange Online, or Exchange Online Protection

What do you want to do?

Create a site mailbox provisioning policy

This example creates the default provisioning policy SM_ProvisioningPolicy with the following settings:

  • The warning quota for the site mailboxes is 9 GB.

  • The site mailboxes are prohibited from receiving messages when the mailbox size reaches 10 GB.

  • The maximum size of email messages that can be sent to site mailboxes is 50 MB.

Copy Code
New-SiteMailboxProvisioningPolicy -Name SM_ProvisioningPolicy -IsDefault -IssueWarningQuota 9GB -ProhibitSendReceiveQuota 10GB -MaxReceiveSize 50MB

View the settings of a site mailbox provisioning policy

This example returns detailed information about all site mailbox provisioning policies in your organization.

Copy Code
Get-SiteMailboxProvisioningPolicy | Format-List

This example returns all policies in your organization, but only displays the IsDefault information to identify which policy is the default policy.

Copy Code
Get-SiteMailboxProvisioningPolicy | Format-List IsDefault

Make changes to an existing site mailbox provisioning policy

This example changes the site mailbox provisioning policy named Default to allow the maximum size of email messages that can be received by the site mailbox to 25 MB. (When you install Exchange, a provisioning policy is created with the name Default.)

Copy Code
Set-SiteMailboxProvisioningPolicy -Identity Default -MaxReceiveSize 25MB

This example changes the warning quota to 9.5 GB and the prohibit send and receive quota to 10 GB.

Copy Code
Set-SiteMailboxProvisioningPolicy -Identity Default -IssueWarningQuota 9GB -ProhibitSendReceiveQuota 10GB

Configure a site mailbox name prefix

When a new site mailbox is created, by default its email address will have a prefix. The email address prefix allows you to easily search for and query site mailboxes and may help users recognize them as well. If you choose, you can disable the prefix, or change the prefix for your tenant in Office 365 or for a given forest in an on-premises deployment. With the default prefix behavior, if your site mailbox is created in Office 365, the default prefix is SMO-. Alternatively, if your site mailbox is created in your on-premises deployment, the prefix is SM-. The default behavior differs between these premises so that hybrid customers will not experience conflicts if site mailboxes are created in both locations and are then synced cross-premises.

This example disables the prefix naming by setting the DefaultAliasPrefixEnabled parameter to $false.

Copy Code
Set-SiteMailboxProvisioningPolicy -Identity Default -DefaultAliasPrefixEnabled $false -AliasPrefix $null

This example changes the default provisioning policy and sets the AliasPrefix to FOREST01.

For deployments with multiple forests, it is recommended that a different prefix is used in each forest in order to prevent conflicts when objects are synced across forests, in the event that site mailboxes have been created with the same name in two or more forests.
Copy Code
Set-SiteMailboxProvisioningPolicy -Identity Default -AliasPrefix FOREST01 -DefaultAliasPrefixEnabled $false
In the case of a hybrid deployment where you have Exchange on-premises and in Office 365, all cloud-based site mailboxes are created with the prefix SMO-. The prefixes are different in Office 365 and Exchange on-premises so that hybrid customers will not experience conflicts if site mailboxes are created in both locations and are then synced cross-premises.The AliasPrefix parameter takes precedence over the DefaultAliasPrefixEnabled parameter; therefore, if the AliasPrefix parameter is set to a valid, non-null string, each new site mailbox will have that string prepended to the alias.

Delete a site mailbox provisioning policy

This example deletes the default site mailbox policy that was created during Exchange Setup.

Copy Code
Remove-SiteMailboxProvisioningPolicy -Identity Default
You must first create and designate another default policy before you can remove the policy named Default.

For more information