Configurare MAPI su HTTP in Exchange Server

  • Articolo

In Exchange 2016 ed Exchange 2019 è possibile configurare MAPI tramite HTTP a livello di organizzazione o a livello di singola cassetta postale. Le impostazioni a livello di cassette postali hanno sempre la priorità rispetto alle impostazioni a livello di organizzazione.

Gli scenari in cui MAPI su HTTP è abilitato o disabilitato per impostazione predefinita a livello di organizzazione sono descritti nella tabella seguente:

Scenario Exchange 2019 Exchange 2016
Aggiornamento da un ambiente Exchange 2016 MAPI su HTTP è abilitato per impostazione predefinita n/d
Aggiornamento da un ambiente che contiene tutti i server Exchange 2013 MAPI su HTTP è disabilitato per impostazione predefinita MAPI su HTTP è disabilitato per impostazione predefinita
Aggiornamento da un ambiente Exchange 2010 n/d MAPI su HTTP è abilitato per impostazione predefinita

Nota

Quando MAPI su HTTP è abilitato a livello di organizzazione, il valore della proprietà MapiHttpEnabled restituito dal cmdlet Get-OrganizationConfig è True.

Questo argomento descrive come configurare e abilitare MAPI su HTTP per le organizzazioni di Exchange che contengono server Exchange 2013 o per qualsiasi topologia in cui MAPI su HTTP è stato disabilitato in precedenza. È possibile usare le procedure descritte in questo articolo anche per disabilitare MAPI su HTTP a livello di organizzazione.

Questo argomento descrive anche come abilitare o disabilitare MAPI su HTTP per una singola cassetta postale. A livello di cassetta postale, è possibile consentire o bloccare le connessioni MAPI su HTTP internamente e/o esternamente. In tutti i casi, quando MAPI su HTTP viene disattivata, le connessioni vengono effettuate con Outlook via Internet.

Configurare MAPI su HTTP

Completare la procedura seguente per configurare MAPI su HTTP per l'organizzazione. Questi passaggi presuppongono che siano già stati configurati i prerequisiti descritti in MAPI su HTTP in Exchange Server. Al termine della configurazione (passaggi 1-3), seguire il passaggio 4 per attivare o disattivare scenari di autorizzazioni specifici a livello di organizzazione e/o a livello di cassette postali.

  1. Configurazione della directory virtuale: per impostazione predefinita, Exchange crea una directory virtuale per MAPI su HTTP. È possibile utilizzare il cmdlet Set-MapiVirtualDirectory per configurare la directory virtuale. È necessario configurare un URL interno, un URL esterno o entrambi. Per ulteriori informazioni, vedere Set-MapiVirtualDirectory.

    Ad esempio, per configurare la directory virtuale MAPI predefinita nel server Exchange locale impostando il valore dell'URL interno su https://contoso.com/mapie il metodo di autenticazione su Negotiate, eseguire il comando seguente:

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

  2. Configurazione del certificato: il certificato digitale usato dall'ambiente Exchange deve includere gli stessi valori InternalURL ed ExternalURL definiti nella directory virtuale MAPI. Per altre informazioni sulla gestione dei certificati di Exchange, vedere Certificati digitali e crittografia in Exchange Server. Assicurarsi che il certificato Exchange sia affidabile sulla workstation client Outlook e che non vi siano errori del certificato, in particolar modo quando si accede agli URL configurati sulla directory virtuale MAPI.

  3. Aggiornare le regole del server: verificare che i servizi di bilanciamento del carico, i proxy inversi e i firewall siano configurati per consentire l'accesso al MAPI tramite la directory virtuale HTTP.

  4. Attenersi alla procedura seguente per attivare MAPI su HTTP nell'intera organizzazione Exchange o per attivare MAPI su HTTP per una o più singole cassette postali.

    Nota

    Dopo aver eseguito i comandi seguenti, i client di Outlook con MAPI su HTTP abilitato visualizzeranno un messaggio per riavviare Outlook per usare MAPI su HTTP.

    Abilitare MAPI su HTTP nell'organizzazione di Exchange:

    Per abilitare o disabilitare MAPI su HTTP a livello di organizzazione, usare il cmdlet Set-OrganizationConfig con il parametro MapiHttpEnabled . I valori validi sono:

    • $true: le connessioni MAPI su HTTP sono consentite per tutte le cassette postali dell'organizzazione,a meno che MAPI su HTTP non sia disabilitato in una cassetta postale specifica.

    • $false: le connessioni MAPI su HTTP non sono consentite per tutte le cassette postali dell'organizzazione,a meno che MAPI su HTTP non sia abilitato in una cassetta postale specifica.

    Nell'esempio seguente vengono attivate le connessioni MAPI su HTTP per l'intera organizzazione:

    Set-OrganizationConfig -MapiHttpEnabled $true

    Abilitare MAPI su HTTP per una singola cassetta postale:

    Per abilitare o disabilitare MAPI su HTTP a livello di cassetta postale, usare il cmdlet Set-CasMailbox con il parametro MapiHttpEnabled . I valori validi sono:

    • $null: la cassetta postale segue le impostazioni a livello di organizzazione. Questo è il valore predefinito.

    • $true: abilitare MAPI su HTTP per la cassetta postale. Se MAPI su HTTP è disabilitato a livello aziendale, viene abilitato per la cassetta postale.

    • $false: disabilitare MAPI su HTTP per la cassetta postale. Se MAPI su HTTP è abilitato a livello aziendale, è disabilitato per la cassetta postale, quindi la cassetta postale userà le connessioni Outlook Via Internet.

    Nell'esempio seguente vengono attivate le connessioni MAPI su HTTP per una singola cassetta postale:

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

Verificare MAPI su connessioni HTTP

È possibile testare l'interfaccia MAPI end-to-end tramite connessione HTTP utilizzando il cmdlet Test-OutlookConnectivity. Per utilizzare il cmdlet Test-OutlookConnectivity, deve essere avviato il servizio Microsoft Exchange Health Manager (MSExchangeHM).

L'esempio seguente prova l'interfaccia MAPI su connessione HTTP dal server di Exchange denominato ContosoMail.

Test-OutlookConnectivity -RunFromServerId ContosoMail -ProbeIdentity OutlookMapiHttpSelfTestProbe

Un test riuscito restituisce un output simile all'esempio seguente:

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

Per ulteriori informazioni, vedere Test-OutlookConnectivity.

I registri per MAPI su attività HTTP si trovano nelle posizioni seguenti:

  • %ExchangeInstallPath%Logging\MAPI Address Book Service\

  • %ExchangeInstallPath%Logging\MAPI Client Access\

  • %ExchangeInstallPath%Logging\HttpProxy\Mapi\

Combinazione delle configurazioni di MAPI su HTTP e connessioni interne o esterne

Oltre alle impostazioni dell'organizzazione e delle cassette postali descritte in precedenza in questo argomento, è possibile usare il parametro MapiBlockOutlookExternalConnectivity nel cmdlet Set-CasMailbox per consentire o negare connessioni ESTERNE di Outlook Via Internet o MAPI tramite connessioni HTTP a una cassetta postale specifica. I valori validi sono:

  • True: solo le connessioni interne sono consentite alla cassetta postale.

  • False: le connessioni interne ed esterne sono consentite alla cassetta postale. Questo è il valore predefinito.

La tabella seguente riepiloga i risultati delle diverse combinazioni di impostazioni a livello di organizzazione e nelle singole cassette postali.

Valore MapiHttpEnabled in Set-OrganizationConfig Valore MapiHttpEnabled in Set-CasMailbox Valore MapiBlockOutlookExternalConnectivity in Set-CasMailbox Risultato dell'individuazione automatica
$true, $null $false MAPI su HTTP, interna ed esterna
$true, $null $true, MAPI su HTTP, solo interna
$true, $true, $false MAPI su HTTP, interna ed esterna
$true, $true, $true, MAPI su HTTP, solo interna
$true, $false $false Outlook via Internet, interna ed esterna
$true, $false $true, Outlook via Internet, solo interna
$false $null $false Outlook via Internet, interna ed esterna
$false $null $true, Outlook via Internet, solo interna
$false $true, $false MAPI su HTTP, interna ed esterna
$false $true, $true, MAPI su HTTP, solo interna
$false $false $false Outlook via Internet, interna ed esterna
$false $false $true, Outlook via Internet, solo interna

Gestire MAPI su HTTP

È possibile gestire la configurazione di MAPI su HTTP utilizzando i cmdlet seguenti: