Installare gli agenti di Microsoft Entra Connect Health

Questo articolo illustra come installare e configurare gli agenti di Microsoft Entra Connect Health.

Informazioni su come scaricare gli agenti.

Requisiti

La tabella seguente elenca i requisiti per l'uso di Microsoft Entra Connect Health:

Nuove versioni dell'agente e aggiornamento automatico

Se viene rilasciata una nuova versione dell'agente integrità, eventuali agenti già installati vengono aggiornati automaticamente.

Connettività in uscita agli endpoint di servizio di Azure

Durante l'installazione e il runtime, l'agente richiede la connettività agli endpoint servizio di Microsoft Entra Connect Health. Se i firewall bloccano la connettività in uscita, assicurarsi che gli URL nella tabella seguente non siano bloccati per impostazione predefinita.

Non disabilitare il monitoraggio della sicurezza o l'analisi di questi URL. Al contrario, consentirli come si farebbe con il traffico Internet.

Questi URL consentono la comunicazione con gli endpoint di servizio di Microsoft Entra Connect Health. Più avanti in questo articolo si apprenderà come controllare la connettività in uscita usando Test-MicrosoftEntraConnectHealthConnectivity.

Download degli agenti

Per scaricare e installare l'agente di Microsoft Entra Connect Health:

• Verificare che siano soddisfatti i requisiti per installare Microsoft Entra Connect Health.
• Introduzione all'uso di Microsoft Entra Connect Health per AD FS:
  • Scaricare l'agente di Microsoft Entra Connect Health per AD FS.
  • Vedere le istruzioni per l'installazione.
• Introduzione all'uso di Microsoft Entra Connect Health per la sincronizzazione:
  • Scaricare e installare l'ultima versione di Microsoft Entra Connect. L'agente integrità per la sincronizzazione forma parte dell'installazione di Microsoft Entra Connect (versione 1.0.9125.0 o successive).
• Introduzione all'uso di Microsoft Entra Connect Health per Active Directory Domain Services:
  • Scaricare l'agente di Microsoft Entra Connect Health per Active Directory Domain Services.
  • Vedere le istruzioni per l'installazione.

Installare l'agente per AD FS

Per informazioni sull'installazione e il monitoraggio di AD FS con l'agente Microsoft Entra Connect Health, vedere Agenti Microsoft Entra Connect Health per AD FS.

Installare l'agente per la sincronizzazione

L'agente di Microsoft Entra Connect Health per la sincronizzazione viene installato automaticamente nella versione più recente di Microsoft Entra Connect. Per utilizzare Microsoft Entra Connect per la sincronizzazione, scaricare l'ultima versione di Microsoft Entra Connect e installarla.

Per verificare che l'agente sia stato installato, cercare i servizi seguenti nel server. Se la configurazione è stata completata, i servizi dovrebbero già essere in esecuzione. In caso contrario, vengono arrestati fino al completamento della configurazione.

• Aggiornamento dell'agente di Microsoft Entra Connect
• Agente di Microsoft Entra Connect Health

Registrare manualmente Microsoft Entra Connect Health per la sincronizzazione

Se la registrazione dell'agente Microsoft Entra Connect Health per la sincronizzazione ha esito negativo pur dopo aver installato correttamente Microsoft Entra Connect, è possibile usare un comando di PowerShell per registrare manualmente l'agente.

Registrare manualmente l'agente Microsoft Entra Connect Health per la sincronizzazione usando il comando di PowerShell seguente. I servizi di Microsoft Entra Connect Health verranno avviati dopo la corretta registrazione dell'agente.

Register-MicrosoftEntraConnectHealthAgent -AttributeFiltering $true -StagingMode $false

Il comando accetta i parametri seguenti:

• AttributeFiltering: $true (impostazione predefinita) se Microsoft Entra Connect non sincronizza il set di attributi predefiniti ed è stato personalizzato per usare un set di attributi filtrati. In caso contrario, usare $false.
• StagingMode: $false (impostazione predefinita) se il server Microsoft Entra Connect non è in modalità di gestione temporanea. Se il server è configurato per essere in modalità di gestione temporanea, usare $true.

Quando viene richiesta l'autenticazione, usare lo stesso account amministratore globale, (come admin@domain.onmicrosoft.com) usato per configurare Microsoft Entra Connect.

Installare l'agente per Active Directory Domain Services

Per avviare l'installazione dell'agente, fare doppio clic sul file EXE scaricato. Nella prima finestra selezionare Installa.

Quando viene richiesto, accedere usando un account Microsoft Entra che dispone delle autorizzazioni per registrare l'agente. Per impostazione predefinita, l'account Amministratore delle identità ibride dispone delle autorizzazioni.

Dopo l'accesso, il processo di installazione viene completato ed è possibile chiudere la finestra.

A questo punto, i servizi dell'agente devono iniziare a consentire automaticamente all'agente di caricare in modo sicuro i dati necessari nel servizio cloud.

Per verificare che l'agente sia stato installato, cercare i servizi seguenti nel server. Questi servizi dovrebbero essere già in esecuzione se la configurazione è stata completata. In caso contrario, vengono arrestati fino al completamento della configurazione.

• Aggiornamento dell'agente di Microsoft Entra Connect
• Agente di Microsoft Entra Connect Health

Installare rapidamente l'agente su più server

1. Creare un account utente in Microsoft Entra ID. Proteggere l'account usando una password.

2. Assegnare il ruolo Proprietario per questo account Microsoft Entra locale in Microsoft Entra Connect Health usando il portale. Assegnare il ruolo a tutte le istanze del servizio.

3. Scaricare il file MSI .exe nel controller di dominio locale per l'installazione.

4. Eseguire lo script seguente. Sostituire i parametri con il nuovo account utente e la relativa password.

   AdHealthAddsAgentSetup.exe /quiet AddsMonitoringEnabled=1 SkipRegistration=1
   Start-Sleep 30
   $userName = "NEWUSER@DOMAIN"
   $secpasswd = ConvertTo-SecureString "PASSWORD" -AsPlainText -Force
   $myCreds = New-Object System.Management.Automation.PSCredential ($userName, $secpasswd)
   import-module "C:\Program Files\Microsoft Azure AD Connect Health Agent\Modules\AdHealthConfiguration"
   
   Register-MicrosoftEntraConnectHealthAgent -Credential $myCreds
   

Al termine, è possibile rimuovere l'accesso per l'account locale completando una o più delle attività seguenti:

• Rimuovere l'assegnazione di ruolo per l'account locale per Microsoft Entra Connect Health.
• Ruotare la password per l'account locale.
• Disabilitare l'account locale di Microsoft Entra.
• Eliminare l'account locale di Microsoft Entra.

Registrare l'agente usando PowerShell

Dopo l'installazione del file setup.exe appropriato per l'agente, è possibile eseguire registrare l'agente usando i seguenti comandi di PowerShell, in base al ruolo. Aprire PowerShell come amministratore ed eseguire il comando pertinente:

Register-MicrosoftEntraConnectHealthAgent

Register-MicrosoftEntraConnectHealthAgent -UserPrincipalName upn-of-the-user

Questi comandi accettano Credential come parametro per completare la registrazione in modo non interattivo o per completare la registrazione in un computer che esegue Server Core. Tenere presenti questi fattori:

• Il parametro Credential può essere acquisito in una variabile di PowerShell passata come parametro.
• È possibile fornire qualsiasi identità di Microsoft Entra con autorizzazioni per registrare gli agenti e che non dispone dell'autenticazione a più fattori abilitata.
• Per impostazione predefinita, gli amministratori globali dispongono delle autorizzazioni per registrare gli agenti. È anche possibile consentire a identità con privilegi inferiori di eseguire questo passaggio. Per altre informazioni, vedere Controllo degli accessi in base al ruolo di Azure.

    $cred = Get-Credential
    Register-MicrosoftEntraConnectHealthAgent -Credential $cred

Configurare gli agenti di Microsoft Entra Connect Health per l'uso del proxy HTTP

È possibile configurare gli agenti di Microsoft Entra Connect Health per l'interazione con un proxy HTTP.

Modificare la configurazione del proxy agente

Per configurare l'agente di Microsoft Entra Connect Health per l'uso di un proxy HTTP, è possibile:

• Importare le impostazioni del proxy esistenti.
• Specificare gli indirizzi proxy manualmente.
• Cancellare la configurazione del proxy esistente.

Importare le impostazioni del proxy esistenti

È possibile importare le impostazioni proxy HTTP di Internet Explorer in modo tale che gli agenti di Microsoft Entra Connect Health possano usare le impostazioni. Eseguire il seguente comando di PowerShell in ogni server che esegue l'agente per l'integrità:

Set-MicrosoftEntraConnectHealthProxySettings -ImportFromInternetSettings

È possibile importare le impostazioni proxy WinHTTP in modo che gli agenti di Microsoft Entra Connect Health possano usarle. Eseguire il seguente comando di PowerShell in ogni server che esegue l'agente per l'integrità:

Set-MicrosoftEntraConnectHealthProxySettings -ImportFromWinHttp

Specificare gli indirizzi proxy manualmente

È possibile specificare manualmente un server proxy. Eseguire il seguente comando di PowerShell in ogni server che esegue l'agente per l'integrità:

Set-MicrosoftEntraConnectHealthProxySettings -HttpsProxyAddress address:port

Ecco un esempio:

Set-MicrosoftEntraConnectHealthProxySettings -HttpsProxyAddress myproxyserver: 443

In questo esempio:

• L'impostazione address può essere un nome del server risolvibile con DNS o un indirizzo IPv4.
• È possibile omettere port. In questo caso, 443 è la porta predefinita.

Cancellare la configurazione del proxy esistente

È possibile eseguire il comando seguente per cancellare la configurazione del proxy esistente:

Set-MicrosoftEntraConnectHealthProxySettings -NoProxy

Leggere le impostazioni del proxy correnti

È possibile leggere le impostazioni attuali del proxy eseguendo il seguente comando:

Get-MicrosoftEntraConnectHealthProxySettings

Testare la connettività al servizio Microsoft Entra Connect Health

Occasionalmente, l'agente di Microsoft Entra Connect Health perde la connettività con il servizio Microsoft Entra Connect Health. Le cause di questa perdita di connettività possono includere problemi di rete, problemi di autorizzazioni e vari altri problemi.

Se l'agente non può inviare dati al servizio Microsoft Entra Connect Health per più di due ore, nel portale viene visualizzato l'avviso seguente: Dati del Servizio integrità non sono aggiornati.

Per scoprire se l'agente di Microsoft Entra Connect Health interessato può caricare i dati nel servizio Microsoft Entra Connect Health, eseguire il comando di PowerShell seguente:

Test-MicrosoftEntraConnectHealthConnectivity -Role ADFS

Il parametro Role accetta attualmente i valori seguenti:

• ADFS
• Sync
• ADDS

Passaggi successivi

Vedere i seguenti articoli correlati:

• Microsoft Entra Connect Health
• Operazioni di Microsoft Entra Connect Health
• Usare Microsoft Entra Connect Health con AD FS
• Usare Microsoft Entra Connect Health per la sincronizzazione
• Usare Microsoft Entra Connect Health con Active Directory Domain Services
• Domande frequenti su Microsoft Entra Connect Health
• Cronologia versioni di Microsoft Entra Connect Health