Konfigurieren von MAPI über HTTP in Exchange Server

GILT FÜR:yes-img-162016 yes-img-192019 yes-img-seSubscription Edition

In Exchange 2016 und Exchange 2019 können Sie MAPI über HTTP auf der Ebene der Organisation oder der einzelnen Postfächer konfigurieren. Die Einstellungen auf Postfachebene haben immer Vorrang vor organisationsweiten Einstellungen.

Die Szenarien, in denen MAPI über HTTP auf Organisationsebene standardmäßig aktiviert oder deaktiviert ist, werden in der folgenden Tabelle beschrieben:

Szenario Exchange 2019 Exchange 2016
Aktualisieren von einer Exchange 2016-Umgebung MAPI über HTTP ist standardmäßig aktiviert n/v
Aktualisieren von einer Umgebung, die beliebige Exchange 2013-Server enthält MAPI über HTTP ist standardmäßig deaktiviert MAPI über HTTP ist standardmäßig deaktiviert
Aktualisieren von einer Exchange 2010-Umgebung n/v MAPI über HTTP ist standardmäßig aktiviert

Hinweis

Wenn MAPI über HTTP auf Organisationsebene aktiviert ist, lautet der MapiHttpEnabled-Eigenschaftswert, der vom Cmdlet Get-OrganizationConfig zurückgegeben wird, .True

In diesem Thema wird beschrieben, wie Sie MAPI über HTTP für Exchange-Organisationen konfigurieren und aktivieren, die Exchange 2013-Server enthalten, oder für Topologien, in denen MAPI über HTTP zuvor deaktiviert wurde. Sie können die Verfahren in diesem Artikel auch verwenden, um MAPI über HTTP auf Unternehmensebene zu deaktivieren.

In diesem Thema wird außerdem beschrieben, wie Sie MAPI über HTTP für ein einzelnes Postfach aktivieren oder deaktivieren. Auf Postfachebene haben Sie die Möglichkeit, MAPI-über-HTTP-Verbindungen intern, extern oder beides zuzulassen oder zu blockieren. In allen Fällen, in denen MAPI über HTTP deaktiviert ist, werden Verbindungen mit Outlook Anywhere hergestellt.

Konfigurieren von MAPI über HTTP

Führen Sie die folgenden Schritte aus, um MAPI über HTTP für Ihre organization zu konfigurieren. Bei diesen Schritten wird davon ausgegangen, dass Sie die unter MAPI über HTTP in Exchange Server beschriebenen Voraussetzungen bereits konfiguriert haben. Nach der Konfiguration (Schritte 1-3) verwenden Sie Schritt 4, um bestimmte Berechtigungsszenarien auf Organisationsebene, Postfachebene oder auf beiderlei Ebene zu aktivieren oder zu deaktivieren.

  1. Konfiguration virtueller Verzeichnisse: Exchange erstellt standardmäßig ein virtuelles Verzeichnis für MAPI über HTTP. Verwenden Sie das Cmdlet Set-MapiVirtualDirectory, um das virtuelle Verzeichnis zu konfigurieren. Sie müssen eine interne URL, eine externe URL oder beides konfigurieren. Weitere Informationen finden Sie unter Set-MapiVirtualDirectory.

    Um beispielsweise das virtuelle MAPI-Standardverzeichnis auf dem lokalen Exchange-Server zu konfigurieren, indem Sie den internen URL-Wert auf https://contoso.com/mapiund die Authentifizierungsmethode auf Negotiatefestlegen, führen Sie den folgenden Befehl aus:

    Set-MapiVirtualDirectory -Identity "Contoso\mapi (Default Web Site)" -InternalUrl https://Contoso.com/mapi -IISAuthenticationMethods Negotiate
    
  2. Zertifikatkonfiguration: Das digitale Zertifikat, das von Ihrer Exchange-Umgebung verwendet wird, muss dieselben InternalURL- und ExternalURL-Werte enthalten, die im virtuellen MAPI-Verzeichnis definiert sind. Weitere Informationen zur Exchange-Zertifikatverwaltung finden Sie unter Digitale Zertifikate und Verschlüsselung in Exchange Server. Stellen Sie sicher, dass das Exchange-Zertifikat auf der Outlook-Clientarbeitsstation vertrauenswürdig ist und dass keine Zertifikatfehler vorliegen, vor allem wenn Sie die im virtuellen MAPI-Verzeichnis konfigurierten URLs aufrufen.

  3. Serverregeln aktualisieren: Stellen Sie sicher, dass Ihre Load Balancer, Reverseproxys und Firewalls so konfiguriert sind, dass sie Zugriff auf das virtuelle MAPI-über-HTTP-Verzeichnis zulassen.

  4. Gehen Sie folgendermaßen vor, um MAPI über HTTP in der gesamten Exchange-Organisation zu aktivieren, oder aktivieren Sie MAPI über HTTP für ein oder mehrere einzelne Postfächer.

    Hinweis

    Nachdem Sie die folgenden Befehle ausgeführt haben, erhalten Outlook-Clients mit aktiviertem MAPI über HTTP eine Meldung, dass Outlook neu gestartet werden soll, um MAPI über HTTP zu verwenden.

    Aktivieren Sie MAPI über HTTP in Ihrer Exchange-organization:

    Verwenden Sie zum Aktivieren oder Deaktivieren von MAPI über HTTP auf Organisationsebene das Cmdlet Set-OrganizationConfig mit dem Parameter MapiHttpEnabled . Gültige Werte sind:

    • $true: MAPI über HTTP-Verbindungen sind für alle Postfächer in der organization zulässig (es sei denn, MAPI über HTTP ist für ein bestimmtes Postfach deaktiviert).

    • $false: MAPI-über-HTTP-Verbindungen sind nicht für alle Postfächer in der organization zulässig (es sei denn, MAPI über HTTP ist für ein bestimmtes Postfach aktiviert).

    Im folgenden Beispiel werden MAPI über HTTP-Verbindungen für die gesamte Organisation aktiviert:

    Set-OrganizationConfig -MapiHttpEnabled $true
    

    Aktivieren von MAPI über HTTP für ein einzelnes Postfach:

    Verwenden Sie zum Aktivieren oder Deaktivieren von MAPI über HTTP auf Postfachebene das Cmdlet Set-CasMailbox mit dem Parameter MapiHttpEnabled . Gültige Werte sind:

    • $null: Das Postfach folgt den Einstellungen auf organization-Ebene. Dies ist der Standardwert.

    • $true: Aktivieren Sie MAPI über HTTP für das Postfach. Wenn MAPI über HTTP auf Organisationsebene deaktiviert ist, ist es für das Postfach aktiviert.

    • $false: Deaktivieren Sie MAPI über HTTP für das Postfach. Wenn MAPI über HTTP auf Organisationsebene aktiviert ist, ist es für das Postfach deaktiviert, sodass das Postfach Outlook Anywhere-Verbindungen verwendet.

    Im folgenden Beispiel werden MAPI über HTTP-Verbindungen für ein einzelnes Postfach aktiviert:

    Set-CasMailbox <user or mailbox ID> -MapiHttpEnabled $true
    

Testen von MAPI über HTTP-Verbindungen

Sie können die End-to-End-Verbindung mit MAPI über HTTP mithilfe des Cmdlets Test-OutlookConnectivity testen. Um das Cmdlet Test-OutlookConnectivity verwenden zu können, muss der Microsoft Exchange-Integritätsdienst (MSExchangeHM) gestartet werden.

Im folgenden Beispiel wird die MAPI über HTTP-Verbindung von einem Exchange-Server namens ContosoMail getestet.

Test-OutlookConnectivity -RunFromServerId ContosoMail -ProbeIdentity OutlookMapiHttpSelfTestProbe

Wenn der Test erfolgreich ist, ähnelt die Ausgabe dem folgenden Beispiel:

MonitorIdentity                                          StartTime              EndTime                Result      Error     Exception
---------------                                          ---------              -------                ------      -----     ---------
OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe    2/14/2018 7:15:00 AM   2/14/2018 7:15:10 AM   Succeeded

Weitere Informationen finden Sie unter Test-OutlookConnectivity.

Protokolle für MAPI über HTTP-Aktivitäten befinden sich in den folgenden Verzeichnissen:

  • %ExchangeInstallationspfad%Logging\MAPI Address Book Service\

  • %ExchangeInstallationspfad%Logging\MAPI Client Access\

  • %ExchangeInstallPath%Logging\HttpProxy\Mapi\

Kombinieren von MAPI über HTTP-Konfigurationen mit internen oder externen Verbindungen

Zusätzlich zu den weiter oben in diesem Thema beschriebenen Einstellungen für organization und Postfach können Sie den Parameter MapiBlockOutlookExternalConnectivity im Cmdlet Set-CasMailbox verwenden, um externe Outlook Anywhere- oder MAPI-über-HTTP-Verbindungen zu einem bestimmten Postfach zuzulassen oder zu verweigern. Gültige Werte sind:

  • True: Nur interne Verbindungen mit dem Postfach sind zulässig.

  • Falsch: Interne und externe Verbindungen mit dem Postfach sind zulässig. Dies ist der Standardwert.

In der folgenden Tabelle sind die Ergebnisse der verschiedenen Einstellungskombinationen auf Organisationsebene und für einzelne Postfächer zusammengefasst.

MapiHttpEnabled-Wert auf Set-OrganizationConfig MapiHttpEnabled-Wert auf Set-CasMailbox MapiBlockOutlookExternalConnectivity-Wert auf Set-CasMailbox Ergebnis der AutoErmittlung
$true $null $false MAPI über HTTP, intern und extern
$true $null $true MAPI über HTTP, nur intern
$true $true $false MAPI über HTTP, intern und extern
$true $true $true MAPI über HTTP, nur intern
$true $false $false Outlook Anywhere, intern und extern
$true $false $true Outlook Anywhere, nur intern
$false $null $false Outlook Anywhere, intern und extern
$false $null $true Outlook Anywhere, nur intern
$false $true $false MAPI über HTTP, intern und extern
$false $true $true MAPI über HTTP, nur intern
$false $false $false Outlook Anywhere, intern und extern
$false $false $true Outlook Anywhere, nur intern

Verwalten von MAPI über HTTP

Sie können die MAPI über HTTP-Konfiguration mithilfe der folgenden Cmdlets verwalten: