Konfigurieren von Websitepostfächern in SharePoint Server

GILT FÜR:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

In diesem Artikel wird beschrieben, wie Sie Websitepostfächer in SharePoint Server und Exchange Server konfigurieren. Über die Funktion "Websitepostfächer" können SharePoint Server-Benutzer die Team-E-Mail-Funktion auf einer Website nutzen. Zudem stellen Websitepostfächer Links zu SharePoint-Dokumentbibliotheken in Microsoft Outlook bereit, sodass die Benutzer Dateien und E-Mail-Nachrichten mit anderen Mitgliedern ihres Teams teilen können, mit denen sie gemeinsam an einem Projekt arbeiten.

Bevor Sie beginnen:

Informieren Sie sich zunächst über die Voraussetzungen, die erfüllt sein müssen, ehe Sie mit diesem Vorgang beginnen:

• Websitepostfächer erfordern Exchange Server 2013 oder höher.

• Alle vorherigen Versionen der Exchange-Webdienste (Exchange Web Services, EWS) müssen von den SharePoint-Servern deinstalliert werden.

  Hinweis

  [!HINWEIS] Möglicherweise müssen Sie herausfinden, ob eine frühere Version von EWS installiert ist. Führen Sie in diesem Fall das weiter unten in diesem Artikel erwähnte Skript "Check-SiteMailboxConfig" aus.

• Das Feature "Websitepostfächer" erfordert, dass die Benutzerprofilsynchronisierung in der Farm konfiguriert ist. Informationen zum Konfigurieren der Benutzerprofilsynchronisierung finden Sie unter Planen von Benutzerprofilen und Identitäten und Verwalten der Benutzerprofilsynchronisierung in SharePoint Server.

• Für die Funktion "Websitepostfächer" ist es erforderlich, dass die Dienstanwendung für die App-Verwaltung in der Farm konfiguriert ist. Informationen zur Konfiguration der Dienstanwendung für die App-Verwaltung finden Sie unter New-SPAppManagementServiceApplication.

• Secure Sockets Layer (SSL) mit Konfiguration für die Standardzone ist eine Anforderung für Webanwendungen, die in Szenarios bereitgestellt werden, bei denen die Server-zu-Server-Authentifizierung und die App-Authentifizierung unterstützt wird. Dies ist solch ein Szenario. Als Voraussetzung für die Konfiguration von Websitepostfächern muss für den Computer, auf dem SharePoint Server ausgeführt wird, SSL konfiguriert sein. Weitere Informationen finden Sie unter Erstellen von anspruchsbasierten Webanwendungen in SharePoint Server , und führen Sie die Schritte zum Erstellen einer SSL-Websitesammlung und eines Serverzertifikats aus.

Beachten Sie, dass Sie möglicherweise das Exchange Server SSL-Zertifikat aus Exchange Server in SharePoint Server und von SharePoint Server in Exchange Server importieren müssen. Dies ist nur erforderlich, wenn das Zertifikat für die API-Endpunkte (z. B. ein Self-SSL-Zertifikat in einer Labumgebung) nicht vertrauenswürdig ist. So importieren Sie ein nicht vertrauenswürdiges SSL-Zertifikat auf einen neuen Server

• Öffnen Sie Internet Explorer, und navigieren Sie zu Outlook Web App (wenn sich die Bereitstellung auf SharePoint Server befindet) oder zur SSL-SharePoint-Website (wenn sich die Bereitstellung auf Exchange Server befindet): https://<ExServerName>/owa oder https://<SP_FQDN>.

• Akzeptieren Sie das Zertifikat als vertrauenswürdig, indem Sie auf Continue to website (Zu dieser Website wechseln) klicken.

• Klicken Sie in Internet Explorer neben der Adressleiste auf die Info Zertifikatfehler und dann auf Zertifikate anzeigen.

• Wählen Sie die Option Zertifikat installieren und dann Alle Zertifikate in folgendem Speicher speichern.

• Aktivieren Sie das Kontrollkästchen zum Anzeigen der physischen Speicher.

• Installieren Sie das Zertifikat auf dem lokalen Computer der vertrauenswürdigen Stammzertifizierungsstellen > .

• Um diese Verfahren durchführen zu können, müssen Sie Mitglied der Administratorgruppen von SharePoint und Exchange Server sein und über eine betriebsbereite Version von Exchange Server mit Endbenutzerpostfächern verfügen.

• Eine SharePoint-Sicherungslösung enthält keine Exchange-Websitepostfächer. Exchange-Administratoren müssen sicherstellen, dass regelmäßige Sicherungen der Websitepostfächer erstellt werden.

• Benutzer, die über ein Websitepostfach auf Dateien in einer SharePoint-Dokumentbibliothek zugreifen, müssen die Dokumentbibliothek in ihrem Browser als vertrauenswürdige Website konfiguriert haben, oder es wird eine Warnung angezeigt, die den Benutzer fragt, ob er der Datei vertrauen möchte.

Konfigurieren von SharePoint für Websitepostfächer in SharePoint Server

Der erste Schritt bei der Konfiguration von Websitepostfächern ist die Installation der Exchange Server-Webdienste-API auf jedem Webserver und jedem Anwendungsserver in der SharePoint Server-Farm.

Installieren der Exchange-Webdienste-API unter SharePoint Server

1. Laden Sie die Datei "EWSManagedAPI.msi" aus dem Microsoft Download Center herunter, und speichern Sie sie auf jedem Webserver und jedem Anwendungsserver jeweils in einem eigenen Ordner.

2. Öffnen Sie als Administrator ein Befehlsfenster, und greifen Sie auf den Ordner zu, in dem Sie die Datei "EWSManagedAPI.msi" gespeichert haben.

3. Führen Sie den folgenden Befehl aus:

   msiexec /I EwsManagedApi.msi addlocal="ExchangeWebServicesApi_Feature"
   

4. Setzen Sie IIS über die Befehlszeile zurück, indem Sie IISReseteingeben.

Einrichten einer OAuth-Vertrauensstellung sowie von Dienstberechtigungen unter SharePoint Server

Im nächsten Schritt werden die folgenden beiden Skripts kopiert. Das erste Skript wird als "Set-SiteMailboxConfig.ps1" gespeichert, und das zweite Skript wird als "Check-SiteMailboxConfig.ps1" gespeichert.

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) doesn't 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
}

Speichern Sie die beiden .ps1 Dateien in demselben Ordner auf einem SharePoint Server-Front-End- oder Anwendungsserver, da ein Skript das andere während der Ausführung aufruft. Navigieren Sie in einem Microsoft PowerShell-Fenster (klicken Sie mit der rechten Maustaste auf das PowerShell-Symbol, und wählen Sie Run As Administrator (Als Administrator ausführen ) zu dem Ordner mit den .ps1 Dateien, und führen Sie das Set-SiteMailboxConfig.ps1 Skript aus. Benutzer können dann Folgendes tun:

• Die Exchange-Metadaten abrufen und installieren, wobei sie dem Exchange-Dienstprinzipal Vollzugriff für das SharePoint-Websiteabonnement erteilen

• Die Funktion "Websitepostfächer" in der SharePoint-Umgebung aktivieren

• Optional: die Zieldomäne für das Exchange-Websitepostfach festlegen, falls in den DNS-Einstellungen für die Domäne nicht die AutoErmittlung konfiguriert wurde

"Check-SiteMailboxConfig.ps1" wird als Teil des Skripts "Set-SiteMailboxConfig" aufgerufen und verwendet, um zu bestätigen, dass die Konfiguration erfolgreich war (separate Ausführung möglich).

Das Format sollte wie folgt lauten:

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

Hierbei steht <Domain> für den FQDN der Domäne, in der sich Ihr Exchange Server befindet, und <Exchange Server> ist der Exchange Server, mit dem Sie die Verbindung herstellen möchten. Dieser Parameter ist erforderlich.

Der Parameter [Exchange Server] ist optional und gibt die Exchange Server-Instanz an, mit der eine Verbindung hergestellt werden soll. (Er ist erforderlich, wenn AutoErmittlung nicht aktiviert oder nicht korrekt konfiguriert ist.) Ebenfalls optional ist der Parameter [URL], der eine bestimmte eventuell von Ihnen konfigurierte URL angibt. (Er wird in der Regel in Umgebungen verwendet, in denen mit SSL- und Nicht-SSL-Webanwendungen gearbeitet wird.)

Beispiel:

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

Falls beim Ausführen des Skripts ein Fehler auftritt, sind die Informationen weiter unten im Abschnitt "Problembehandlung" dieses Artikels hilfreich.

Konfigurieren von Exchange Server für Websitepostfächer

Im letzten Schritt werden auf dem Exchange-Server die OAuth-Vertrauensstellung und die Dienstberechtigungen eingerichtet.

Einrichten einer OAuth-Vertrauensstellung sowie von Dienstberechtigungen unter Exchange

1. Öffnen Sie auf Ihrer Instanz von Exchange Server das Verwaltungsfenster der PowerShell als Administrator, und wechseln Sie in das Verzeichnis "C:\Programme\Microsoft\Exchange Server\V15\Scripts".

2. Führen Sie den folgenden Befehl aus:

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

   Dabei ist <SP_FQDN> die URL der SharePoint-SSL-Stammwebsitesammlung, die Sie konfigurieren möchten.

Problembehandlung

Nutzen Sie bei Fehlern die folgenden Tabelle.

Tabelle mit Fehlercodes als Referenz beim Ausführen des Skripts mit der Konfigurationscheckliste

Siehe auch

Konzepte

Plan email integration for a SharePoint Server farm

Configure email integration for a SharePoint Server farm

Weitere Ressourcen

Websitepostfächer

Zusammenarbeit