Konfigurieren von MAPI über HTTP in Exchange Server

  • Artikel

In Exchange 2016 und Exchange 2019 können Sie MAPI über HTTP auf Organisationsebene oder auf Postfachebene 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
Upgrade von einer Exchange 2016-Umgebung MAPI über HTTP ist standardmäßig aktiviert. n/v
Upgrade von einer Umgebung, die Exchange 2013-Server enthält MAPI über HTTP ist standardmäßig deaktiviert. MAPI über HTTP ist standardmäßig deaktiviert.
Upgrade 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 MapI über HTTP für Exchange-Organisationen, die Exchange 2013-Server enthalten, oder für jede Topologie, in der MAPI über HTTP zuvor deaktiviert wurde, konfiguriert und anschließend aktiviert wird. Sie können die Verfahren in diesem Artikel auch verwenden, um MAPI über HTTP auf Unternehmensebene zu deaktivieren.

In diesem Thema wird auch beschrieben, wie MapI über HTTP für ein einzelnes Postfach aktiviert oder deaktiviert wird. Auf Postfachebene haben Sie die Möglichkeit, MAPI über HTTP-Verbindungen intern, extern oder beides zuzulassen oder zu blockieren. In allen Fällen, wenn 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 Organisation zu konfigurieren. Bei diesen Schritten wird davon ausgegangen, dass Sie die unter MAPI über HTTP in Exchange Server beschriebenen Voraussetzungen bereits konfiguriert haben. Verwenden Sie nach der Konfiguration (Schritte 1 bis 3) Schritt 4, um bestimmte Berechtigungsszenarien auf Organisationsebene, auf Postfachebene oder beides zu aktivieren oder zu deaktivieren.

  1. Konfiguration des virtuellen Verzeichnisses: 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.

    Führen Sie beispielsweise den folgenden Befehl aus, um das virtuelle MapI-Standardverzeichnis auf dem lokalen Exchange-Server zu konfigurieren, indem Sie den wert für die interne URL auf https://contoso.com/mapiund die Authentifizierungsmethode auf Negotiatefestlegen:

    Set-MapiVirtualDirectory -Identity "Contoso\mapi (Default Web Site)" -InternalUrl https://Contoso.com/mapi -IISAuthenticationMethods Negotiate

  2. Zertifikatkonfiguration: Das von Ihrer Exchange-Umgebung verwendete digitale Zertifikat muss die gleichen 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. Aktualisieren von Serverregeln: Überprüfen Sie, ob Ihre Lastenausgleichsmodule, Reverseproxys und Firewalls so konfiguriert sind, dass sie den Zugriff auf das virtuelle MAPI-Verzeichnis über HTTP 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, wird für Outlook-Clients, für die MAPI über HTTP aktiviert ist, eine Meldung zum Neustarten von Outlook angezeigt, um MAPI über HTTP zu verwenden.

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

    Um MAPI über HTTP auf Organisationsebene zu aktivieren oder zu deaktivieren, verwenden Sie 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 Organisation 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 Organisation 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 Sie MAPI über HTTP für ein einzelnes Postfach:

    Um MAPI über HTTP auf Postfachebene zu aktivieren oder zu deaktivieren, verwenden Sie das Cmdlet Set-CasMailbox mit dem MapiHttpEnabled-Parameter . Gültige Werte sind:

    • $null: Das Postfach folgt den Einstellungen auf Organisationsebene. Dies ist der Standardwert.

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

    • $false: Deaktivieren Sie MAPI über HTTP für das Postfach. Wenn MAPI über HTTP auf Organisationsebene aktiviert ist, ist sie 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 Organisations- und Postfacheinstellungen können Sie den MapiBlockOutlookExternalConnectivity-Parameter im Cmdlet Set-CasMailbox verwenden, um externe Outlook Anywhere- oder MAPI-Verbindungen über HTTP-Verbindungen mit einem bestimmten Postfach zuzulassen oder zu verweigern. Gültige Werte sind:

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

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

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

MapiHttpEnabled-Wert für Set-OrganizationConfig MapiHttpEnabled-Wert für 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: