Configurer des boîtes aux lettres de site dans SharePoint Server

**Sapplique à :**Exchange Server, SharePoint Server 2013, SharePoint Server 2016

**Dernière rubrique modifiée :**2017-09-19

Résumé : Configurez Exchange Server, SharePoint Server 2016 et SharePoint Server 2013 pour la messagerie d’équipe à l’aide de la fonctionnalité de boîtes aux lettres de site.

Cet article explique comment configurer des boîtes aux lettres de site dans SharePoint Server et Exchange Server. La fonctionnalité Boîtes aux lettres de site procure aux utilisateurs de SharePoint Server une messagerie d’équipe sur un site SharePoint, ainsi que des liens vers les bibliothèques de documents SharePoint dans Microsoft Outlook, ce qui leur permet de partager des fichiers et des messages électroniques avec d’autres membres d’une équipe qui travaillent sur un projet commun.

Avant de commencer

Avant de commencer cette opération, lisez les informations suivantes sur les éléments prérequis :

• Les boîtes aux lettres de site requièrent Exchange Server 2016 ou Exchange Server 2013.

• Toute version antérieure des services web Exchange doit être désinstallée des serveurs SharePoint.

  Notes

  Vous devrez peut-être déterminer si une version antérieure des services web Exchange est installée. Si tel est le cas, exécutez le script Check-SiteMailboxConfig référencé ci-dessous.

• La fonctionnalité Boîtes aux lettres du site nécessite la configuration de la synchronisation des profils utilisateur dans la batterie. Pour plus d’informations sur la configuration de la synchronisation des profils utilisateur, voir Planifier les profils utilisateur et les identités et Gérer la synchronisation des profils utilisateur dans SharePoint Server.

• La fonctionnalité Boîtes aux lettres du site nécessite que l’application de service Gestion des applications soit configurée dans la batterie de serveurs. Pour plus d’informations sur la configuration de l’application de service Gestion des applications, voir New-SPAppManagementServiceApplication.

• Le protocole SSL (Secure Sockets Layer) configuré pour la zone par défaut est une condition requise pour les applications web déployées dans les scénarios qui prennent en charge l’authentification serveur à serveur et l’authentification des applications. Il s’agit d’un scénario de ce type. En guise de condition préalable à la configuration des boîtes aux lettres de site, le protocole SSL doit être configuré sur l’ordinateur qui exécute SharePoint Server. Pour plus d’informations, consultez l’article Create claims-based web applications in SharePoint Server et suivez les étapes de création d’une collection de sites SSL et d’un certificat de serveur.

  Notes

  Vous devrez peut-être importer le certificat SSL Exchange Server de Exchange Server vers SharePoint Server et de SharePoint Server vers Exchange Server. Ceci est nécessaire uniquement si le certificat n’est pas approuvé pour les points de terminaison d’API (tel qu’un certificat auto-signé SelfSSL dans un environnement de laboratoire).
  Pour importer un certificat SSL non approuvé vers un nouveau serveur :

  • Ouvrez Internet Explorer et naviguez jusqu’à Outlook Web App (si le déploiement est sur SharePoint Server) ou jusqu’au site SSL SharePoint (si le déploiement est sur Exchange Server) : https://<NomServeurExchange>/owa ou https://<FQDN_SP>.

  • Acceptez d’approuver le certificat en cliquant sur Poursuivre vers le site web.

  • Cliquez sur les informations Erreur de certificat dans Internet Explorer en regard de la barre d’adresse, puis cliquez sur Afficher les certificats.

  • Sélectionnez Installer le certificat, puis Placer tous les certificats dans le magasin suivant.

  • Activez cette case à cocher pour afficher les magasins physiques.

  • Installez le certificat dans Autorités de certification racines de confiance > Ordinateur local.

• Pour pouvoir appliquer ces procédures, vous devez être membre des groupes d’administrateurs SharePoint et Exchange Server et disposer d’un système Exchange Server opérationnel avec des boîtes aux lettres d’utilisateurs finals.

• Une solution de sauvegarde SharePoint n’incorpore pas les boîtes aux lettres du site Exchange. Un administrateur Exchange doit s’assurer que les sauvegardes des boîtes aux lettres du site s’effectuent au moment opportun.

• Les utilisateurs qui accèdent à des fichiers dans une bibliothèque de documents SharePoint à partir d’une boîte aux lettres du site doivent faire en sorte que la bibliothèque de documents soit configurée en tant que site approuvé dans leur navigateur, sinon un avertissement s’affiche pour les inviter à confirmer s’ils approuvent le fichier.

Configurer SharePoint pour les boîtes aux lettres de site dans UNRESOLVED_TOKEN_VAL(MOSS_2nd_CNoVer)

La première étape de configuration des boîtes aux lettres de site consiste à installer l’API Services web Exchange Server sur chaque serveur web et d’applications dans la batterie SharePoint Server.

Installer l’API Services web Exchange sur SharePoint Server

1. Téléchargez le fichier EWSManagedAPI.msi à partir du centre de téléchargement Microsoft et enregistrez-le dans un dossier sur chaque serveur web et d’applications.

2. Ouvrez une invite de commandes en tant qu’administrateur et naviguez jusqu’au dossier où vous avez enregistré EWSManagedAPI.msi.

3. Exécutez la commande suivante :

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

4. Réinitialisez IIS depuis la ligne de commande en tapant IISReset.

Établir une approbation OAuth et des autorisations de service sur SharePoint Server

L’étape suivante consiste à copier les deux scripts suivants. Le premier doit être enregistré sous le nom Set-SiteMailboxConfig.ps1 et le second doit être enregistré sous le nom Check-SiteMailboxConfig.ps1.

Set-SiteMailboxConfig.ps1 :

# .SYNOPSIS
# Set-SiteMailboxConfig helps configure Site Mailboxes for a SharePoint farm
# .DESCRIPTION
# Establishes trust with an Exchange Server, sets Site Mailbox settings and enables Site Mailboxes for a farm.
# .PARAMETER ExchangeSiteMailboxDomain
# The FQDN of the Exchange Organization where Site Mailboxes will be created
# .PARAMETER ExchangeAutodiscoverDomain
# [Optional] The FQDN of an Exchange Autodiscover Virtual Directory
# .PARAMETER WebApplicationUrl
# [Optional] The URL of a specific web application to configure. If not specified all Web Applications will be configured
# .PARAMETER Force
# [Optional] Indicate that the script should ignore any configuration issues and enable Site Mailboxes anyway

Param
(
   [Parameter(Mandatory=$true)]
   [ValidateNotNullOrEmpty()]   
   [string]$ExchangeSiteMailboxDomain,
   [Parameter(Mandatory=$false)]
   [ValidateNotNullOrEmpty()]   
   [string]$ExchangeAutodiscoverDomain,
   [Parameter(Mandatory=$false)]
   [ValidateNotNullOrEmpty()]   
   [string]$WebApplicationUrl,
   [Parameter(Mandatory=$false)]
   [switch]$Force
)

$script:currentDirectory = Split-Path $MyInvocation.MyCommand.Path

if($WebApplicationUrl -ne $NULL -and $WebApplicationUrl -ne "")
{
    $webapps = Get-SPWebApplication $WebApplicationUrl
}
else
{
    $webapps = Get-SPWebApplication
}

if($webapps -eq $NULL)
{
    if($WebApplicationUrl -ne $NULL)
    {
        Write-Warning "No Web Application Found at $($WebApplicationUrl). Please create a web application and re-run Set-SiteMailboxConfig"
    }
    else
    {
        Write-Warning "No Web Applications Found. Please create a web application and re-run Set-SiteMailboxConfig"
    }
    
    return
}

$rootWeb = $NULL

foreach($webapp in $webapps)
{
    if($rootWeb -eq $NULL)
    {
        $rootWeb = Get-SPWeb $webApp.Url -EA SilentlyContinue
    }
}

if($rootWeb -eq $NULL)
{
    Write-Warning "Unable to find a root site collection. Please create a root site collection on a web application and re-run Set-SiteMailboxConfig"
    return
}

$exchangeServer = $ExchangeAutodiscoverDomain

if($exchangeServer -eq $NULL -or $exchangeServer -eq "")
{
    $exchangeServer = "autodiscover.$($ExchangeSiteMailboxDomain)"
}

Write-Host "Establishing Trust with Exchange Server: $($exchangeServer)"

$metadataEndpoint = "https://$($exchangeServer)/autodiscover/metadata/json/1"

$exchange = Get-SPTrustedSecurityTokenIssuer | Where-Object { $_.MetadataEndpoint -eq $metadataEndpoint }

if($exchange -eq $NULL)  
{
    $exchange = New-SPTrustedSecurityTokenIssuer -Name $exchangeServer -MetadataEndPoint $metadataEndpoint
}

if($exchange -eq $NULL)
{
    Write-Warning "Unable to establish trust with Exchange Server $($exchangeServer). Ensure that $($metadataEndpoint) is accessible."

    if($ExchangeAutodiscoverDomain -eq $NULL -or $ExchangeAutodiscoverDomain -eq "")
    {
        Write-Warning "If $($metadataEndpoint) does not exist you may specify an alternate FQDN using ExchangeAutodiscoverDomain."
    }
    return
}

Write-Host "Granting Permissions to Exchange Server: $($exchangeServer)"
$appPrincipal = Get-SPAppPrincipal -Site $rootWeb.Url -NameIdentifier $exchange.NameId
Set-SPAppPrincipalPermission -AppPrincipal $appPrincipal -Site $rootWeb -Scope SiteSubscription -Right FullControl -EnableAppOnlyPolicy

Write-Host
Write-Host

Write-Host "Verifying Site Mailbox Configuration"
$warnings = & $script:currentDirectory\Check-SiteMailboxConfig.ps1 -ReturnWarningState

if($warnings -and -not $Force)
{
    Write-Warning "Pre-requisites not satisfied. Stopping Set-SiteMailboxConfig. Use -Force to override"
    return
}
elseif($warnings)
{
    Write-Warning "Pre-requisites not satisfied. -Force used to override"
}

foreach($webapp in $webapps)
{
    Write-Host "Configuring Web Application: $($webapp.Url)"
    Write-Host "Setting Exchange Site Mailbox Domain to $($ExchangeSiteMailboxDomain)"
    $webapp.Properties["ExchangeTeamMailboxDomain"] = $ExchangeSiteMailboxDomain
        
    if($ExchangeAutodiscoverDomain -ne $NULL -and $ExchangeAutodiscoverDomain -ne "")
    {
        Write-Host "Setting Exchange Autodiscover Domain to $($ExchangeAutodiscoverDomain)"
        $webapp.Properties["ExchangeAutodiscoverDomain"] = $ExchangeAutodiscoverDomain;
    }

    $webapp.Update()
}

$feature = Get-SPFeature CollaborationMailboxFarm -Farm -ErrorAction Ignore

if($feature -eq $NULL)
{
    Write-Host "Enabling Site Mailboxes for Farm"
    Enable-SPFeature CollaborationMailboxFarm
}
else
{
    Write-Host "Site Mailboxes already enabled for Farm"
}

Check-SiteMailboxConfig.ps1:

Param
(
   [Parameter(Mandatory=$false)]
   [ValidateNotNullOrEmpty()]   
   [switch]$ReturnWarningState
)

Add-PSSnapin Microsoft.SharePoint.Powershell

$anyWarnings = $false

Write-Host "Step 1: Checking for Exchange Web Services"

try
{
    $assm = [System.Reflection.Assembly]::Load("Microsoft.Exchange.WebServices, Version=15.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")
    if($assm.GlobalAssemblyCache)
    {
        Write-Host -Foreground Green "Found Exchange Web Services in Global Assembly Cache"
        Write-Host "Exchange Web Services Version: $([System.Diagnostics.FileVersionInfo]::GetVersionInfo($assm.Location).FileVersion)"
    }
    else
    {
        Write-Warning "Unable to find Exchange Web Services in Global Assembly Cache"
        $anyWarnings = $true
    }
}
catch
{
    Write-Warning "Unable to find Exchange Web Services in Global Assembly Cache"
    $anyWarnings = $true
}


Write-Host
Write-Host

Write-Host "Step 2: Checking for https web application"

$webapps = Get-SPWebApplication -EA SilentlyContinue

$rootWeb = $NULL

if($webapps -ne $NULL)
{
    $sslWebAppExists = $false
    foreach($webapp in $webapps)
    {
        if($rootWeb -eq $NULL)
        {
            $rootWeb = Get-SPWeb $webApp.Url -EA SilentlyContinue
        }

        if(-not $webapp.Url.StartsWith("https://"))
        {
            Write-Warning "Web Application at $($webapp.Url) does not use HTTPS. Site Mailboxes will not work on this Web Application."
        }
        else
        {
            $sslWebAppExists = $true
            Write-Host -Foreground Green "Found Web Application at $($webapp.Url) that uses HTTPS"
        }
    }

    if(-not $sslWebAppExists)
    {
        Write-Warning "At least one Web Application must be configured for HTTPS in the default zone."
        $anyWarnings = $true
    }
}
else
{
    Write-Warning "No Web Applications Found. Please create a web application and re-run Check-SiteMailboxConfig"
    $anyWarnings = $true
    if($ReturnWarningState)
    {
        return $anyWarnings
    }
    return;
}

if($rootWeb -eq $NULL)
{
    Write-Warning "Unable to find any Sites. Please create a root site collection on a web application and re-run Check-SiteMailboxConfig"
    $anyWarnings = $true
    if($ReturnWarningState)
    {
        return $anyWarnings
    }
    return;
}

# Get App Permissions Management Objects
$appPrincipalManager = [Microsoft.SharePoint.SPAppPrincipalManager]::GetManager($rootWeb)
$appPrincipalPermissionsManager = New-Object -TypeName Microsoft.SharePoint.SPAppPrincipalPermissionsManager -ArgumentList $rootWeb        

Write-Host
Write-Host
Write-Host "Step 3: Checking for trusted Exchange Servers"

$trustedIssuers = Get-SPTrustedSecurityTokenIssuer
$trustedIssuerHosts = @()

if($trustedIssuers -ne $NULL)
{
    $foundTrustedIssuer = $false
    foreach($trustedIssuer in $trustedIssuers)
    {
        if($trustedIssuer.RegisteredIssuerName.StartsWith("00000002-0000-0ff1-ce00-000000000000@"))
        {
            if($trustedIssuer.IsSelfIssuer)
            {
                $foundTrustedIssuer = $true

                $uri = New-Object -TypeName System.Uri -ArgumentList $trustedIssuer.MetadataEndPoint
                
                Write-Host -Foreground Green "Found trusted Exchange Server at $($uri.Host)"
                $appPrincipalName = [Microsoft.SharePoint.SPAppPrincipalName]::CreateFromNameIdentifier($trustedIssuer.RegisteredIssuerName)
                $appPrincipal = $appPrincipalManager.LookupAppPrincipal([Microsoft.SharePoint.SPAppPrincipalIdentityProvider]::External, $appPrincipalName);
                


                if($appPrincipal -ne $NULL)
                {
                    $isValidAppPrincipal = $true;

                    if($appPrincipalPermissionsManager.GetAppPrincipalSiteSubscriptionContentPermission($appPrincipal) -eq [Microsoft.SharePoint.SPAppPrincipalPermissionKind]::FullControl)
                    {
                        Write-Host -Foreground Green "Exchange Server at $($uri.Host) has Full Control permissions"
                        
                    }
                    else
                    {
                        Write-Warning "Exchange Server at $($uri.Host) does not have Full Control permissions"
                        $isValidAppPrincipal = $false;
                        $anyWarnings = $true
                    }

                    if($appPrincipalPermissionsManager.IsAppOnlyPolicyAllowed($appPrincipal))
                    {
                        Write-Host -Foreground Green "Exchange Server at $($uri.Host) has App Only Permissions"
                    }
                    else
                    {
                        Write-Warning "Exchange Server at $($uri.Host) does not have App Only Permissions"
                        $isValidAppPrincipal = $false;
                        $anyWarnings = $true
                    }
                    
                    if($isValidAppPrincipal)
                    {
                        $trustedIssuerHosts += $uri.Host
                    }

                }
                else
                {
                    Write-Warning "Unable to get App Principal for $($uri.Host). Unable to check permissions for this Exchange Server"
                    $anyWarnings = $true
                }
            }
            else
            {
                Write-Warning "Found trusted Exchange Server at $($uri.Host) but it is not a Self Issuer"
                $anyWarnings = $true
            }
        }
    }

    if(-not $foundTrustedIssuer)
    {
        Write-Warning "Unable to find any trusted Exchange Servers"
        $anyWarnings = $true
    }
}
else
{
    Write-Warning "Unable to find any trusted Exchange Servers"
    $anyWarnings = $true
}

Write-Host
Write-Host
Write-Host "Step 4: Report current Site Mailbox Configuration"

if($webapps -ne $NULL)
{
    foreach($webapp in $webapps)
    {
        Write-Host
        Write-Host "Web Application Site Mailbox Configuration: $($webapp.Url)"
        Write-Host "Exchange Site Mailbox Domain: $($webapp.Properties["ExchangeTeamMailboxDomain"])"
        
        if($webapp.Properties["ExchangeAutodiscoverDomain"] -ne $NULL)
        {
            Write-Host "Exchange Autodiscover Domain: $($webapp.Properties["ExchangeAutodiscoverDomain"])"
        }
    }
}

Write-Host
Write-Host "Trusted Exchange Services: $([String]::Join(", ", $trustedIssuerHosts))"

$feature = Get-SPFeature CollaborationMailboxFarm -Farm -ErrorAction Ignore

if($feature -eq $NULL)
{
    Write-Host -ForegroundColor Red "Site Mailboxes are NOT enabled for Farm"
}
else
{
    Write-Host -ForegroundColor Green "Site Mailboxes are enabled for Farm"
}

if($ReturnWarningState)
{
    return $anyWarnings
}

Enregistrez les deux fichiers .ps1 dans le même dossier sur un serveur frontal ou d’applications SharePoint Server, car un script appelle l’autre lors de l’exécution. Dans une fenêtre Microsoft PowerShell (cliquez avec le bouton droit sur l’icône PowerShell et sélectionnez Exécuter en tant qu’administrateur pour ouvrir la fenêtre), accédez au dossier contenant les fichiers .ps1 et exécutez le script Set-SiteMailboxConfig.ps1. Cela permet aux utilisateurs d’effectuer les actions suivantes :

• Récupérer et installer les métadonnées Exchange, en donnant au principal du service Exchange les autorisations Contrôle total pour l’abonnement de site SharePoint

• Activer la fonctionnalité de boîte aux lettres de site dans l’environnement SharePoint

• (Facultatif) Définir le domaine cible de la boîte aux lettres de site Exchange, si le DNS du domaine n’a pas été configuré pour la découverte automatique

Check-SiteMailboxConfig.ps1 est appelé dans le cadre du script Set-SiteMailboxConfig et confirme que la configuration a été effectuée (il peut également être exécuté séparément).

Le format doit être le suivant :

.\Set-SiteMailboxConfig.ps1 -ExchangeSiteMailboxDomain <Domain> -ExchangeAutodiscoverDomain [Exchange Server] -WebApplicationUrl [URL]

Où <Domain> correspond au nom de domaine complet de votre serveur Exchange et où <Exchange Server> correspond au serveur Exchange auquel vous avez l’intention de vous connecter. Ces paramètres sont obligatoires.

Les paramètres facultatifs sont [Exchange Server], qui correspond au serveur Exchange auquel vous voulez vous connecter (ce paramètre est nécessaire si la découverte automatique n’est pas activée ou configurée correctement) et [URL], qui correspond à une URL spécifique que vous pouvez configurer (généralement utilisée dans un environnement avec des applications web SSL et non SSL).

Exemple : .\Set-SiteMailboxConfig.ps1 -ExchangeSiteMailboxDomain tailspintoys.com -ExchangeAutodiscoverDomain exchange1.tailspintoys.com -WebApplicationUrl https://tailspintoys.com

Si vous rencontrez une erreur pendant l’exécution du script, reportez-vous à la section « Résolution des problèmes » de cet article pour obtenir des instructions.

Configurer Exchange Server pour les boîtes aux lettres de site

L’étape finale consiste à établir une approbation OAuth et des autorisations de service sur le serveur Exchange.

Établir une approbation OAuth et une autorisation de service sur Exchange

1. Sur votre instance Exchange Server, ouvrez la fenêtre Exchange Management PowerShell en tant qu’administrateur et accédez au répertoire « C:\Program Files\Microsoft\Exchange Server\V15\Scripts ».

2. Exécutez la commande suivante :

   .\Configure-EnterprisePartnerApplication.ps1 -ApplicationType Sharepoint -AuthMetadataUrl https://<SP_FQDN>/_layouts/15/metadata/json/1
   

   Où <SP_FQDN> est l’URL de la collection de sites racine SSL SharePoint que vous souhaitez configurer.

Résolution des problèmes

Si vous rencontrez des problèmes, consultez le tableau suivant.

Tableau des codes d’erreur pour référence lorsque vous exécutez un script de liste de vérification de configuration

See also

Plan email integration for a SharePoint Server farm
Configure email integration for a SharePoint Server farm

Boîtes aux lettres de site
Collaboration