Agente ibrido Microsoft

L'agente ibrido elimina alcune delle sfide che si potrebbe dover affrontare durante la configurazione di un ambiente ibrido di Exchange. L'agente, che si basa sulla stessa tecnologia dell'Microsoft Entra Application Proxy, rimuove alcuni dei requisiti di configurazione per l'ambiente ibrido. Ad esempio:

• Voci DNS esterne.
• Aggiornamenti dei certificati.
• Connessioni di rete in ingresso attraverso il firewall per abilitare le funzionalità ibride di Exchange.

L'agente ibrido supporta la condivisione della disponibilità, le migrazioni delle cassette postali, la sincronizzazione delle directory e altre funzionalità ibride.

La modalità ibrida moderna non è supportata negli ambienti cloud Microsoft, inclusi GCC, GCCH e Gallatin. Inoltre, la pubblicazione di Outlook Web App (OWA) ed Exchange Pannello di controllo (ECP) tramite Microsoft Entra Application Proxy non è supportata.

Posizione e requisiti dell'agente

L'installazione dell'agente e della configurazione ibrida tramite la Configurazione guidata ibrida (HCW) è supportata in una delle posizioni seguenti:

• In un computer autonomo (progettato come "server agente").
• In un server Exchange Server:

  • Exchange 2016 o versione successiva: ruolo Cassetta postale.

  • Exchange 2013: Ruolo Accesso client (CAS).

    Nota

    Per informazioni sull'installazione dell'agente ibrido in un ambiente in cui è abilitata la protezione estesa di Windows per Exchange, vedere Configurare la protezione estesa di Windows in Exchange Server.

Requisiti di sistema

L'agente ibrido ha più metodi di installazione con requisiti diversi. In tutti i casi, i requisiti principali del computer sono gli stessi descritti nell'elenco seguente:

• Windows Server 2012 R2, Windows Server 2016, Windows Server 2019 o Windows Server 2022

  • .NET Framework 4.7.2 o versione successiva.
  • TLS 1.2 abilitato.
  • Application Proxy in Microsoft Entra ID
  • In grado di stabilire connessioni HTTPS in uscita a Internet.
  • In grado di stabilire connessioni HTTPS con l'Exchange Server scelto per la configurazione ibrida.

L'operatore sanitario può scaricare e installare automaticamente l'MSI dell'agente, purché siano soddisfatti i seguenti requisiti:

• Il computer è membro di un dominio di Active Directory.

• Il computer è in grado di stabilire connessioni remote di PowerShell con il server Exchange Server scelto per la configurazione ibrida.

• Il computer usa un browser che supporta la tecnologia ClickOnce, ad esempio Microsoft Edge.

• L'account Active Directory locale in uso deve soddisfare i requisiti seguenti:

  • Appartenenza al gruppo di ruoli Gestione organizzazione nell'organizzazione di Exchange locale.
  • Appartenenza al gruppo Administrators locale nel computer in cui si sta installando l'agente ibrido.

Il download e l'installazione automatica dell'MSI dell'agente da parte dell'operatore sanitario è l'ideale se si installa l'agente direttamente su un server CAS.

Requisiti relativi a porte e protocolli

• Le porte in uscita HTTPS (TCP) 443 e 80 devono essere aperte tra il computer in cui è installato l'agente ibrido e Internet, come illustrato di seguito.

• Porte Le porte TCP 443, 80, 5985 e 5986 devono essere aperte tra il computer in cui è installato l'agente ibrido e il server di sicurezza elettronica selezionato nella configurazione guidata ibrida.

Considerazioni sui server proxy

Se l'ambiente di rete utilizza server proxy in uscita, è necessario eseguire alcune operazioni di configurazione aggiuntive, come descritto in questa sezione. L'elenco potrebbe non essere esaustivo.

Agente

L'agente supporta i server proxy non autenticati in uscita, ma è necessario eseguire più configurazioni dopo l'installazione. Eseguire lo ConfigureOutBoundProxy.ps1 script che si trova nel \Program Files\Microsoft Hybrid Service\ computer in cui è installato l'agente. Ad esempio:

PS C:\Program Files\Microsoft Hybrid Service\>.\ConfigureOutBoundProxy.ps1 -ProxyAddress http://proxyserver:8080

Eseguendo lo script, la sezione seguente viene aggiunta al Microsoft.Online.EME.Hybrid.Agent.Service.exe.config file che si trova nella stessa cartella:

  <system.net>
    <defaultProxy>
      <proxy proxyaddress="http://proxyserver:8080" bypassonlocal="True" usesystemdefault="True" />
    </defaultProxy>
  </system.net>

Exchange Server

L'operatore sanitario stabilisce connessioni dal tuo Exchange Server per domains.live.com scambiare metadati e stabilire trust. Poiché le connessioni provengono dal server CAS, le impostazioni proxy su tale server (da Get-ExchangeServer | Format-List internetWebProxy) devono essere impostate correttamente o la disponibilità in uscita potrebbe non riuscire. Oltre agli errori di connessione, l'operatore sanitario non può configurare l'autenticazione delegata se l'impostazione del proxy non è corretta.

Requisiti di disponibilità

La procedura guidata ibrida gestisce automaticamente le informazioni sulla disponibilità necessarie in Exchange locale ed Exchange Online.

Se è necessario configurare la condivisione della disponibilità con una terza parte, passare alla scheda Organizzazione nell'interfaccia di amministrazione di Exchange e configurare la condivisione individuale o dell'organizzazione tra i due sistemi (Exchange Online ed Exchange locale o Exchange locale ed Exchange locale).

Se si verificano problemi, vedere Come risolvere i problemi di disponibilità in una distribuzione ibrida.

Vincoli

Prima di installare l'agente ibrido, tenere presenti i seguenti problemi:

• L'autenticazione moderna ibrida non è supportata con l'agente ibrido. È necessario usare la topologia ibrida di Exchange classica e pubblicare gli endpoint di individuazione automatica, EWS, ActiveSync, MAPI e Rubrica offline affinché l'autenticazione moderna ibrida funzioni con diversi client Outlook.

• Per le funzionalità di calendario di Teams che richiedono l'accesso alle cassette postali locali, è consigliabile la topologia ibrida di Exchange classica completa. Per altre informazioni, vedere Interazione tra Exchange e Microsoft Teams.

• La verifica dei messaggi e la ricerca in più cassette postali non attraversano l'agente ibrido. Queste funzionalità ibride richiedono il modello di connettività classico in cui Exchange Web Services (EWS) e l'individuazione automatica vengono pubblicati in locale e sono disponibili esternamente per Exchange Online.

• L'agente ibrido registra il nome di dominio completo interno del server CAS selezionato durante l'esecuzione della Configurazione guidata ibrida nell'infrastruttura proxy ibrida di Entra Hybrid. Se il server CAS registrato è offline, le ricerche di disponibilità da Exchange Online all'ambiente locale e la migrazione delle cassette postali da e verso Exchange Online non funzioneranno. Se il server di sicurezza di accesso selezionato è permanentemente offline, è necessario registrare un nuovo server di sicurezza di sistema eseguendo di nuovo la procedura guidata di configurazione ibrida.

• L'agente ibrido supporta un singolo endpoint di migrazione con i limiti predefiniti del servizio. Gli endpoint di migrazione multipli che usano endpoint o URL personalizzati non sono supportati.

• L'agente ibrido supporta una singola organizzazione di Exchange. Non sono supportate più organizzazioni di Exchange.

Configurazione in esecuzione

È necessario eseguire HCW nel computer in cui si desidera installare l'agente. Dopo aver installato e configurato l'agente, l'operatore sanitario individuerà un server preferito a cui connettersi ed eseguirà la procedura di configurazione ibrida standard. Non è necessario eseguire HCW direttamente dal server Exchange. Tuttavia, il computer in cui viene eseguito HCW deve essere in grado di connettersi a Exchange Server sulle porte specificate nella sezione Porte e protocolli.

Prerequisiti per l'installazione

1. Facoltativo: verificare la connettività.

   1. Nel server in cui si esegue la procedura guidata di configurazione ibrida (installazione dell'agente ibrido e passaggi successivi della configurazione ibrida), scaricare lo script di esempio seguente e salvarlo in una directory: https://aka.ms/hybridconnectivity.

   2. Aprire Exchange Management Shell e modificare la directory nel percorso dello script.

   3. Importare i cmdlet eseguendo il comando seguente:

      Import-Module .\HybridManagement.psm1
      

   4. Eseguire il comando seguente per verificare che il computer in cui si sta eseguendo l'installazione possa raggiungere tutti gli endpoint necessari per l'installazione dell'agente ibrido e la configurazione guidata di configurazione ibrida.

      Test-HybridConnectivity -TestO365Endpoints
      

      L'output del comando avrà questo aspetto:

      

2. Per consentire l'installazione dell'agente ibrido ed eseguire le migrazioni delle cassette postali da e verso l'organizzazione di Microsoft 365 o Office 365, abilitare il proxy del servizio di replica delle cassette postali (MRS) nella directory virtuale EWS eseguendo il comando seguente:

   Set-WebServicesVirtualDirectory -Identity "EWS (Default Web Site)" -MRSProxyEnabled $true
   

   Nota

   Se non si completa questo passaggio prima di eseguire l'HCW, quest'ultimo abilita il proxy MRS. Tuttavia, è consigliabile completare questo passaggio prima di eseguire l'HCW per assicurarsi che la cache IIS abbia il tempo di cancellarsi prima che HCW convalidi l'endpoint.

3. Andare a Programmi e funzionalità nel Pannello di controllo e verificare che non sia già installata una versione precedente della Configurazione guidata ibrida. Se lo è, disinstallalo.

4. Installare .NET Framework versione 4.6.2 nel computer in cui è in esecuzione HCW. Potrebbe essere necessario installare una versione successiva di .NET Framework a seconda della versione di Exchange installata. In alternativa, se questa versione non è installata, l'operatore sanitario richiede di installarla o aggiornare la versione già installata sul computer.

Procedure di installazione

1. Accedere all'interfaccia di amministrazione di Exchange in locale, passare al nodo ibrido e quindi fare clic su Configura.

2. Selezionare il server Exchange in cui si desidera eseguire l'installazione ibrida tradizionale. Selezionare il server predefinito fornito dall'HCW o specificare un server specifico nel secondo pulsante di opzione. Seleziona Avanti.

3. Immettere le credenziali di Exchange locale e quelle di amministratore globale di Microsoft 365 o Office 365. Fare clic su Avanti.

4. Attendere che l'operatore sanitario raccolga le informazioni e la configurazione degli ambienti. Al termine, fai clic su Avanti.

5. Selezionare la configurazione ibrida minima o completa. È anche possibile scegliere Trasferimento della configurazione dell'organizzazione. Per ulteriori informazioni, vedere Trasferimento della configurazione dell'organizzazione ibrida V2. Fare clic su Avanti.

6. Seguire la procedura per abilitare la federazione. Fare clic su Avanti.

7. Selezionare Usa topologia ibrida moderna di Exchange

   

   Fare clic su Avanti.

8. L'operatore sanitario installa l'agente ibrido. Esistono quattro fasi fondamentali:

   1. Scaricare il pacchetto di installazione dell'agente.

   2. Installazione dell'agente nel computer locale (nota: questa operazione richiede di nuovo le credenziali di amministratore globale di Microsoft 365 o Office 365).

   3. Registrazione dell'Agente in Entra, inclusa la creazione dell'URL utilizzato per le richieste di proxy. L'URL ha il formato: uniqueGUID.resource.mailboxmigration.his.msappproxy.net.

   4. Test della fattibilità della migrazione dall'organizzazione di Microsoft 365 o Office 365 all'organizzazione di Exchange locale tramite l'agente.

   Nota

   Il processo di installazione dell'agente ibrido potrebbe richiedere fino a 10 minuti.

   Gli input e le azioni rimanenti di HCW sono gli stessi di una distribuzione ibrida classica.

Durante la fase di aggiornamento, l'operatore sanitario crea un endpoint di migrazione con l'URL personalizzato creato nel passaggio 8.3 precedente. Imposta anche il TargetSharingEPR valore della relazione organizzativa e/o dell'oggetto connettore intra-organizzazione sul lato Microsoft 365 o Office 365 su questo valore. Il nuovo URL viene usato per inviare richieste dall'organizzazione di Microsoft 365 o Office 365 all'organizzazione di Exchange locale per la disponibilità e le migrazioni.

È possibile visualizzare i valori specifici eseguendo Get-MigrationEndpoint e Get-OrganizationRelationship da una connessione PowerShell di Exchange Online all'organizzazione di Microsoft 365 o Office 365.

L'esempio seguente mostra l'output che potrebbe essere visualizzato quando si eseguono i cmdlet Get-MigrationEndpoint e Get-OrganizationRelationship :

Get-MigrationEndpoint | Format-List Identity,RemoteServer

Identity : Hybrid Migration Endpoint - EWS (Default Web Site)
RemoteServer : 123e4567-e89b-12d3-a456-426614174000.resource.mailboxmigration.his.msappproxy.net

Get-OrganizationRelationship | Format-List Name,TargetSharingEpr

Name : O365 to On-premises - <GUID>
TargetSharingEpr : https://123e4567-e89b-12d3-a456-426614174000.resource.mailboxmigration.his.msappproxy.net/EWS/Exchange.asmx

Modulo PowerShell dell'agente ibrido

Il modulo PowerShell per la gestione ibrida viene installato dalla procedura guidata di configurazione ibrida in *\Program Files\Microsoft Hybrid Service* nel computer in cui è installato l'agente ibrido. Questo modulo fornisce i seguenti cmdlet che ora possono essere usati con o senza un account amministratore abilitato per l'autenticazione a più fattori.

Come usare i cmdlet dell'agente ibrido con o senza account abilitati per l'autenticazione a più fattori

Per usare questi cmdlet, è necessario importare la versione più recente di HybridManagement.psm1 disponibile in **\Program Files\Microsoft Hybrid Service**. Può anche essere scaricato direttamente da https://aka.ms/HybridAgentPSM.

Per importare il modulo di gestione ibrida, eseguire il comando seguente da un prompt di Windows PowerShell come amministratore:

Import-module .\HybridManagement.psm1

Per eseguire questi cmdlet con credenziali di amministratore abilitate per l'autenticazione a più fattori, è necessario specificare un parametro userPrincipalName . Se l'account non è un account amministratore abilitato per l'autenticazione a più fattori, è anche possibile usare il parametro Credential al posto del parametro userPrincipalName , che comporta l'uso dell'autenticazione di base.

La tabella seguente mostra le differenze di utilizzo in queste due modalità:

Distribuzione di più agenti

Opzione 1: usare la procedura guidata di configurazione ibrida per installare altri agenti

È possibile installare altri agenti ibridi per la ridondanza. È sufficiente scaricare l'ultima versione dell'HCW e aprire l'applicazione sul computer in cui si desidera installare un altro agente ibrido.

1. Come per le precedenti installazioni di HCW, avviare l'applicazione e selezionare Avanti.

2. Selezionare il server desiderato contro cui eseguire e selezionare Avanti.

3. Specificare le credenziali per accedere all'organizzazione di Microsoft 365 o Office 365 e quindi selezionare Avanti.

4. L'operatore sanitario raccoglie le informazioni di configurazione e, al termine, selezionare Avanti .

5. Selezionare l'opzione predefinita disponibile per Completo o Minimo, quindi selezionare Avanti.

6. Selezionare la topologia ibrida moderna di Exchange, avanti.

7. Viene visualizzata una pagina che fornisce lo stato degli agenti esistenti o installati in precedenza. Verifica che lo stato dell'agente esistente sia corretto prima di procedere con il passaggio successivo. Selezionare Installa un agente aggiuntivo, quindi fare clic su Avanti.

   Esempio:

   

L'operatore sanitario installa l'agente ibrido aggiuntivo. Al termine dell'installazione, è possibile aprire la console dei servizi Microsoft Windows dal computer e verificare che il servizio o l'agente sia installato e in esecuzione (cercare Microsoft Hybrid Service - mshybridsvc). A questo punto, è possibile eseguire nuovamente HCW se si vogliono apportare ulteriori modifiche alla configurazione ibrida o semplicemente annullare la procedura guidata.

È possibile ripetere questo passaggio in ogni computer in cui si vuole installare un agente ibrido aggiuntivo.

Opzione 2: scarica e installa manualmente altri agenti

Una seconda opzione per l'installazione di agenti aggiuntivi è all'esterno dell'HCW stesso e viene eseguita scaricando e installando manualmente l'agente sul computer desiderato.

1. Vai a https://aka.ms/hybridagentinstaller.

2. Salvare il MSHybridService.msi in una posizione nel computer.

3. In tale computer, aprire una console dei comandi di Windows come amministratore ed eseguire il comando seguente per installare l'agente ibrido:

   Msiexec /i MSHybridService.msi
   

   Verranno richieste le credenziali di Amministrazione globale del tenant.

4. Al termine dell'installazione, è possibile aprire la console dei servizi Microsoft Windows dal computer e verificare che il servizio o l'agente sia installato e in esecuzione.

È possibile ripetere questo passaggio in ogni computer in cui si vuole installare un agente ibrido aggiuntivo.

Verifica dello stato degli agenti ibridi

Opzione 1: ottenere lo stato tramite la procedura guidata di configurazione ibrida

1. Avviare l'applicazione HCW e selezionare Avanti.

2. Selezionare un server nell'organizzazione di Exchange e selezionare Avanti.

3. Specificare le credenziali per accedere all'organizzazione di Microsoft 365 o Office 365 e quindi selezionare Avanti.

4. L'operatore sanitario raccoglierà le informazioni sulla configurazione. Al termine, selezionare Avanti .

5. Selezionare l'opzione predefinita fornita per Completa o Minima e selezionare Avanti.

6. Selezionare Topologia ibrida moderna di Exchange e selezionare Avanti.

   Verrà visualizzata una pagina che fornisce lo stato degli agenti installati esistenti.

   

7. Al termine, fare clic su Annulla .

Opzione 2: ottenere lo stato tramite il modulo PowerShell di gestione ibrida

Con ogni installazione dell'agente ibrido, l'operatore sanitario installa il modulo PowerShell di gestione ibrida in \Program Files\Microsoft Hybrid Service\ nel computer in cui è installato l'agente. Per impostazione predefinita, questo modulo non viene importato, quindi dovrai importarlo prima di poterlo usare. Questo modulo richiede anche il modulo di Azure per PowerShell, se non è già installato. Installare prima i moduli PackageManagement e quindi vedere questo argomento per le istruzioni sull'installazione dei moduli di Azure PowerShell.

Per importare il modulo di gestione ibrida, eseguire il comando seguente da un prompt di Windows PowerShell come amministratore:

Import-module .\HybridManagement.psm1

Successivamente, è possibile eseguire il comando seguente per visualizzare lo stato dell'agente:

Get-HybridAgent -Credential (Get-Credential)

L'output del comando avrà questo aspetto:

Indirizzare gli agenti ibridi al servizio di bilanciamento del carico anziché a un server specifico

È possibile usare il modulo PowerShell a gestione ibrida per configurare gli agenti ibridi in modo che indirizzino le richieste al servizio di bilanciamento del carico anziché a un Exchange Server specifico. L'agente ibrido supporta le richieste di routing al servizio di bilanciamento del carico per i server Accesso client di Exchange Server 2013 ed i server di Exchange Server 2016 o versioni successive.

1. Seguire i passaggi della sezione precedente per importare il modulo di gestione ibrida per PowerShell.

2. Utilizzare il parametro targetUri nel cmdlet Update-HybridApplication per modificare il valore di internalURL da un server specifico all'endpoint del servizio di bilanciamento del carico.

3. Usare il valore GUID dell'endpoint univoco per il tenant per il parametro appId , ad esempio 123e4567-e89b-12d3-a456-426614174000. Si noti che questo valore GUID non è l'ID agente. Per trovare il valore GUID dell'endpoint, usa una delle procedure seguenti:

   • TargetSharingEPR Dal valore:

     Get-OrganizationRelationship ((Get-OnPremisesOrganization).OrganizationRelationship) | Select-Object TargetSharingEpr
     

     L'output è simile al seguente:

     TargetSharingEpr
     ----------------
     https://123e4567-e89b-12d3-a456-426614174000.resource.mailboxmigration.his.msappproxy.net/EWS/Exchange.asmx
     

   • Dalla configurazione MRS:

     Get-MigrationEndpoint "Hybrid Migration Endpoint - EWS (Default Web Site)" | Select-Object RemoteServer
     

     L'output è simile al seguente:

     RemoteServer
     ------------
     123e4567-e89b-12d3-a456-426614174000.resource.mailboxmigration.his.msappproxy.net
     

4. Dopo aver ottenuto il valore GUID dell'endpoint per il tenant, eseguire il comando seguente:

   • targetUri: https://myloadbalancer.contoso.com in questo esempio (il valore sarà diverso).

   • appId: 123e4567-e89b-12d3-a456-426614174000 In questo esempio (il valore sarà diverso).

   Update-HybridApplication -targetUri "https://myloadbalancer.contoso.com" -appId 123e4567-e89b-12d3-a456-426614174000 -Credential (Get-Credential)
   

   Esempio:

   

Informazioni aggiuntive

È possibile visualizzare i dettagli dell'installazione dell'agente ibrido nelle posizioni seguenti nel server in cui è installato.

• Nella console Servizi:

  

• Nel registro all'indirizzo HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft Hybrid Service:

  

• Sul disco rigido:

  

• In Programmi e funzionalità nel Pannello di controllo:

  

Test e convalida dell'agente ibrido

Dopo aver eseguito correttamente la distribuzione dell'agente ibrido e della configurazione ibrida, è possibile usare la procedura seguente per convalidare il flusso di migrazione della disponibilità e delle cassette postali tramite l'agente.

1. Nel server in cui è installato l'agente ibrido aprire Monitor prestazioni.

2. Aggiungere l'oggetto Microsoft AD App Proxy Connector e il contatore delle richieste # alla visualizzazione.

   

Migrazione

1. Aprire una connessione PowerShell di Exchange Online all'organizzazione di Microsoft 365 o Office 365.

2. Sostituire il customguid> con il valore GUID dell'endpoint univoco come descritto in Indirizzare gli agenti ibridi al servizio di bilanciamento del carico anziché a un server specifico ed eseguire il comando seguente:<

   Test-MigrationServerAvailability -ExchangeRemoteMove:$true -RemoteServer '<your customguid>.resource.mailboxmigration.his.msappproxy.net' -Credentials (Get-Credential)
   

3. Immettere le credenziali locali nella finestra di dialogo visualizzata.

Dopo che il test ha restituito l'esito positivo, tornare a Monitor prestazioni e verificare che il numero di richieste sia aumentato.

È inoltre possibile eseguire uno spostamento della cassetta postale di prova dall'organizzazione di Exchange locale all'organizzazione di Microsoft 365 o Office 365.

Disponibilità

Per eseguire la stessa convalida per le informazioni sulla disponibilità, accedere a una cassetta postale di Microsoft 365 o Office 365 nel tenant, creare un invito a una riunione di prova e inviarlo a una cassetta postale locale.

Disinstallare l'agente ibrido

Per disinstallare l'agente ibrido, eseguire nuovamente la procedura guidata di configurazione ibrida dallo stesso computer in cui è stata eseguita l'installazione e selezionare Connettività classica. Selezionando la connettività classica, si disinstalla e annulla la registrazione dell'agente ibrido dal computer e da Entra. Dopo aver annullato la registrazione dell'agente ibrido, è possibile riprendere l'installazione e configurare l'ibrido in modalità classica.

Passaggio da una modalità all'altra da classica a moderna

È possibile passare all'ibrido moderno (agente ibrido) dopo aver configurato correttamente l'ibrido classico (pubblicazione dello spazio dei nomi EWS e autorizzazione in ingresso). Tuttavia, è consigliabile cambiare solo se non è possibile eseguire la migrazione delle cassette postali nel cloud dopo il completamento di questa configurazione. Se si è scelto di ripristinare l'ibrido moderno, vedere la sezione Vincoli precedente, perché non tutte le funzionalità o le esperienze ibride sono supportate con l'agente ibrido.

Se si sono valutati i pro e i contro del passaggio dal formato classico a quello moderno, procedere eliminando i batch di migrazione esistenti e l'endpoint di migrazione in Exchange Online, eseguendo nuovamente la Configurazione guidata ibrida e selezionando Ibrido moderno.