Share via

SharePoint 2013: Site Mailboxes [1/4 - Configuration]

  • Article

This article is part of a series dedicated to the "Site Mailboxes":

Introduction

The "Site Mailboxes" are a new feature of SharePoint 2013, which allows you access – with Outlook 2013 – to:

  • Emails: managed by Exchange (2013)
  • Documents: managed by SharePoint (2013)

In the screenshot below, the "Site Mailboxes" have been configured on a site named "Racine"; the user can, with his Outlook client, view emails ("Inbox") and documents coming from SharePoint site ("Documents").

http://spasipe.files.wordpress.com/2013/03/11.png?w=595&h=408

This feature is interesting especially for a team work on a project because the team members can easily share emails and documents without leaving Outlook.

More information's about the use of "Site mailboxes" in the third article of this series.

Prerequisites

  • Exchange Server 2013 installed and configured
  • EWS (Exchange Web Services) API installed
  • User profiles synchronization configured
  • "App management" service application created
  • Server-To-Server (S2S) Trust configured between SharePoint and Exchange servers
  • Configure Exchange 2013 for the Site Mailboxes

Step 1: Install and configure Exchange Server 2013

Please see the following articles:

Step 2: Install the EWS (Exchange Web Services) API

1. Check if an older version of the EWS is not installed on the SharePoint server(s) by executing the "Check-SiteMailboxConfig.ps1" script you can find on this page.

Here there are no problems as the EWS are not installed.

http://spasipe.files.wordpress.com/2013/02/112.png?w=595

2. Download "EWSManagedAPI.msi" here.

Launch the following command:

msiexec /i EwsManagedApi.msi addlocal="ExchangeWebServicesApi_Feature,ExchangeWebServicesApi_Gac"

Click on "Next".

http://spasipe.files.wordpress.com/2013/02/211.png?w=595

Click on "I accept …","Next", Next", then "Close" at the end.

http://spasipe.files.wordpress.com/2013/02/44.png?w=595

3. Launch "IISReset"

4. Launch the script again to verify if the EWS installation is validated.

http://spasipe.files.wordpress.com/2013/02/53.png?w=595

 

Step 3: Create a web application which use SSL

http://spasipe.files.wordpress.com/2013/03/1.png?w=595&h=152

 

Step 4: Configure user profiles synchronization

Please see this article.

Step 5: Configure the "App management" service application

Please see this article.

Step 6: Configure the S2S trust

1. Copy the scripts named "Set-SiteMailboxConfig.ps1" and  "Check-SiteMailboxConfig.ps1" from this page to SharePoint server folder.

Launch "Set-SiteMailboxConfig.ps1", by using the following syntax:

.\Set-SiteMailboxConfig.ps1 -ExchangeSiteMailboxDomain Domain -ExchangeAutodiscoverDomain ExchangeServerAddress -WebApplicationUrl WebApplicationWebURL

Example:

\Set-SiteMailboxConfig.ps1 -ExchangeSiteMailboxDomain spasipe.local -ExchangeAutodiscoverDomain Exchange13.spasipe.local -WebApplicationUrlhttps://sitemailboxes.spasipe.local/

http://spasipe.files.wordpress.com/2013/03/5.png?w=595

Note : This step can cause some problems (with the associated error messages ...) – please see the "TroubleShooting" section at the dnd of this article.

Step 7: Configure Exchange 2013 for the Site Mailboxes

1. On the Exchange server, launch the "Exchange Management Shell", then navigate to the "C:\Program Files\Microsoft\Exchange Server\V15\Scripts" directory.

http://spasipe.files.wordpress.com/2013/03/6.png?w=595

2. Launch the following command:

.\Configure-EnterprisePartnerApplication.ps1 -ApplicationType Sharepoint -AuthMetadataUrl
<a href="https://webapplicationurl/_layouts/15/metadata/json/1">https://<;i style="padding:0px; margin:0px">WebApplicationURL</i>/_layouts/15/metadata/json/1</a>

Example:

.\Configure-EnterprisePartnerApplication.ps1 -ApplicationType Sharepoint -AuthMetadataUrl https://sitemailboxes.spasipe.local/_layouts/15/metadata/json/1

http://spasipe.files.wordpress.com/2013/03/7.png?w=595&h=218

The "Site Mailboxes" configuration is done. Next step: activate them on a site!

TroubleShooting

The sixth step (S2S trust) can cause some problems, like this one ("Unable to establish trust with Exchange Server"):

http://spasipe.files.wordpress.com/2013/03/13.png?w=595

If you launch the URL highlighted in yellow, you get this:

http://spasipe.files.wordpress.com/2013/03/24.png?w=595

And if you continue:

http://spasipe.files.wordpress.com/2013/03/4.png?w=595&h=187

To fix this problem we replaced the Exchange 2013 base certificate with a domain certificate.

Reference

Other languages

This article is also available in the following language: