Configuring SharePoint 2013 and Exchange 2013 to support Site Mailboxes
The next post in this multi-part series will outline the remaining steps required to prepare our environment for Site Mailboxes in Wave15.
Establish OAuth Trust and Service Permissions on SharePoint Server 2013
The next step is to copy the two scripts that are accessible here and save each as a .ps1 file to be executed. The first script should be named, “Set-SiteMailboxConfig.ps1” and the second named, “Check-SiteMailboxConfig.ps1”. These files should be stored in the same directory on the web front end server as the first script will call and execute the second script. The second script, “Check-SiteMailboxConfig.ps1” can also be run independently to validate the setup of site mailboxes in an existing environment.
The scripts will allow for the following:
- Retrieve and install the Exchange metadata, giving the Exchange service principal full control permissions to the SharePoint site subscription
- Enable the site mailbox feature in the SharePoint environment
- (optional) Set the Exchange site mailbox target domain, if DNS for the domain has not been configured for AutoDiscover
Navigate to the location where the two powershell scripts have been stored (my example is c:\scripts\) and execute the following command to execute the scripts. Ensure that you launch the SharePoint shell as an administrator.
.\Set-SiteMailboxConfig.ps1 -ExchangeSiteMailboxDomain <Domain> -ExchangeAutodiscoverDomain [Exchange Server] -WebApplicationUrl [URL]
For the sake of demo purposes, my screenshot has environment specific information removed. A sample cmdlet with optional parameters is shown below.
.\Set-SiteMailboxConfig.ps1 -ExchangeSiteMailboxDomain tailspintoys.com -ExchangeAutodiscoverDomain exchange1.tailspintoys.com -WebApplicationUrl https://tailspintoys.com
After executing the above command, I was presented with the error and explanation shown below.
After some certificate cleanup and ensuring that there were no self-signed certificates in use on either the Exchange or SharePoint server by leveraging the internal certificate authority, I was able to rerun the scripts and produce the following success results.
After successful execution of the above scripts on the SharePoint 2013, the below script must be executed on the Exchange 2013 server. The script is present in the scripts directory on Exchange located at C:\Program Files\Microsoft\Exchange Server\v15\Scripts. A sample of executing this script with parameters is shown below. Ensure that <SP_FQDN> is replaced with the proper values for your environment.
.\Configure-EnterprisePartnerApplication.ps1 -ApplicationType Sharepoint -AuthMetadataUrl https://<SP_FQDN>/_layouts/15/metadata/json/1
Part 5 will walk through enabling the site mailbox app on the SharePoint site that will be leveraged for demonstration purposes.