Installer les agents Microsoft Entra Connect Health

Dans cet article, vous apprendrez à installer et à configurer les agents Microsoft Entra Connect Health.

Découvrez comment télécharger les agents.

Spécifications

Le tableau suivant énumère les conditions requises pour l'utilisation de Microsoft Entra Connect Health :

Nouvelles versions de l’agent et mise à niveau automatique

Si une nouvelle version de l’agent d’intégrité est publiée, tous les agents installés existants sont automatiquement mis à jour.

Connectivité sortante vers des points de terminaison de service Azure

Pendant l’installation et l’exécution, l’agent nécessite une connectivité vers les points de terminaison de service Microsoft Entra Connect Health. Si les pare-feu bloquent la connectivité sortante, assurez-vous que les URL du tableau suivant ne sont pas bloquées par défaut.

Ne désactivez pas la supervision ou l’inspection de sécurité de ces URL. Autorisez-les plutôt comme vous le feriez pour un autre trafic Internet.

Ces URL permettent la communication avec les points de terminaison de service Microsoft Entra Connect Health. Plus loin dans cet article, vous apprendrez à vérifier la connectivité sortante à l’aide de Test-MicrosoftEntraConnectHealthConnectivity.

Télécharger les agents

Pour télécharger et installer l'agent Microsoft Entra Connect Health :

• Vérifiez que vous répondez aux exigences pour installer Microsoft Entra Connect Health.
• Commencez à utiliser Microsoft Entra Connect Health pour AD FS :
  • Téléchargez l’agent Microsoft Entra Connect Health pour AD FS.
  • Consultez les instructions d’installation.
• Commencez à utiliser Microsoft Entra Connect Health pour la synchronisation :
  • Téléchargez et installez la dernière version de Microsoft Entra Connect. L'agent Health pour la synchronisation est installé dans le cadre de l'installation de Microsoft Entra Connect (version 1.0.9125.0 ou ultérieure).
• Commencez à utiliser Microsoft Entra Connect Health pour AD Domain Services :
  • Téléchargez l’agent Microsoft Entra Connect Health pour AD Domain Services.
  • Consultez les instructions d’installation.

Installer l’agent pour AD FS

Si vous souhaitez obtenir des informations sur l’installation et le monitoring AD FS avec l’agent Microsoft Entra Connect Health, consultez Agents Microsoft Entra Connect Health pour AD FS.

Installer l’agent pour la synchronisation

L’agent Microsoft Entra Connect Health pour la synchronisation est installé automatiquement dans la dernière version de Microsoft Entra Connect. Pour utiliser Microsoft Entra Connect pour la synchronisation, téléchargez la dernière version de Microsoft Entra Connect et installez-la.

Pour vérifier que l’agent a été installé, recherchez les services suivants sur le serveur. Si vous avez terminé la configuration, les services doivent déjà être en cours d’exécution. Dans le cas contraire, les services sont arrêtés tant que la configuration n’est pas terminée.

• Microsoft Entra Connect Agent Updater
• Microsoft Entra Connect Health Agent

Enregistrer manuellement Microsoft Entra Connect Health pour la synchronisation

Si l’inscription de l’agent Microsoft Entra Connect Health pour la synchronisation échoue après l’installation correcte de Microsoft Entra Connect, vous pouvez utiliser une commande PowerShell pour inscrire l’agent manuellement.

Inscrivez manuellement l’agent Microsoft Entra Connect Health pour la synchronisation à l’aide de la commande PowerShell suivante. Les services Microsoft Entra Connect Health démarreront une fois l’agent correctement enregistré.

Register-MicrosoftEntraConnectHealthAgent -AttributeFiltering $true -StagingMode $false

La commande prend les paramètres suivants :

• AttributeFiltering : $true (par défaut), si Microsoft Entra Connect ne synchronise pas le jeu d’attributs par défaut et a été personnalisé pour utiliser un jeu d’attributs filtré. Sinon, utilisez $false.
• StagingMode : $false (par défaut), si le serveur Microsoft Entra Connect n’est pas en mode simulation. Si le serveur est configuré pour être en mode simulation, utilisez $true.

Quand vous êtes invité à vous authentifier, utilisez le même compte Administrateur général (par exemple, admin@domain.onmicrosoft.com) que celui que vous avez utilisé pour configurer Microsoft Entra.

Installer l’agent pour AD Domain Services

Pour démarrer l’installation de l’agent, double-cliquez sur le fichier .exe que vous avez téléchargé. Dans la première fenêtre, sélectionnez Installer.

Lorsque vous y êtes invité, connectez-vous à l’aide d’un compte Microsoft Entra disposant des autorisations nécessaires pour inscrire l’agent. Par défaut, le compte Administrateur d’identité hybride dispose de ces autorisations.

Une fois connecté, le processus d’installation se termine et vous pouvez fermer la fenêtre.

À ce stade, les services de l’agent doivent démarrer automatiquement pour permettre à l’agent de charger en toute sécurité les données requises pour le service cloud.

Pour vérifier que l’agent a été installé, recherchez les services suivants sur le serveur. Si vous avez terminé la configuration, ils doivent déjà être en cours d’exécution. Dans le cas contraire, ils sont arrêtés tant que la configuration n’est pas terminée.

• Microsoft Entra Connect Agent Updater
• Microsoft Entra Connect Health Agent

Installer rapidement l’agent sur plusieurs serveurs

1. Créez un compte utilisateur dans Microsoft Entra ID. Sécurisez le compte à l’aide d’un mot de passe.

2. Attribuez le rôle Propriétaire pour ce compte Microsoft Entra local dans Microsoft Entra Connect Health à l’aide du portail. Affectez le rôle à toutes les instances de services.

3. Téléchargez le fichier MSI .exe dans le contrôleur de domaine local pour l’installation.

4. Exécutez le script suivant. Remplacez les paramètres par votre nouveau compte d’utilisateur et son mot de passe.

   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
   

Lorsque vous avez terminé, vous pouvez supprimer l’accès du compte local en effectuant une ou plusieurs des tâches suivantes :

• Supprimer l’attribution de rôle au compte local pour Microsoft Entra Connect Health.
• Effectuer une rotation du mot de passe du compte local.
• Désactiver le compte local Microsoft Entra.
• Supprimer le compte local Microsoft Entra.

Inscrire l’agent à l’aide de PowerShell

Après avoir installé le fichier setup.exe approprié de l’agent approprié, vous pouvez inscrire l’agent à l’aide des commandes PowerShell suivantes, en fonction du rôle. Ouvrez PowerShell en tant qu’administrateur et exécutez la commande appropriée :

Register-MicrosoftEntraConnectHealthAgent

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

Ces commandes acceptent Credential en tant que paramètre pour terminer l’inscription de manière non interactive ou pour terminer l’inscription sur un ordinateur qui exécute Server Core. Gardez à l’esprit les points suivants :

• Vous pouvez capturer Credential dans une variable PowerShell qui est transmise en tant que paramètre.
• Vous pouvez fournir n’importe quelle identité Microsoft Entra qui dispose des autorisations nécessaires pour inscrire les agents et pour laquelle l’authentification multifacteur n’est pas activée.
• Par défaut, les administrateurs généraux sont autorisés à inscrire les agents. Vous pouvez également autoriser des identités moins privilégiées à effectuer cette étape. Pour plus d’informations, consultez Azure RBAC.

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

Configurer les agents Microsoft Entra Connect Health pour qu'ils utilisent un proxy HTTP

Vous pouvez configurer des agents Microsoft Entra Connect Health pour utiliser un proxy HTTP.

Modifier la configuration de l’agent proxy

Pour configurer l’agent Microsoft Entra Connect Health pour qu’il utilise un proxy HTTP, vous pouvez :

• Importer les paramètres de proxy existants.
• Spécifier les adresses du proxy manuellement.
• Effacer la configuration de proxy existante.

Importer les paramètres de proxy existants

Vous pouvez importer les paramètres du proxy HTTP d’Internet Explorer afin que les agents Microsoft Entra Connect Health puissent les utiliser. Sur chacun des serveurs qui exécutent l’agent d’intégrité, exécutez la commande PowerShell suivante :

Set-MicrosoftEntraConnectHealthProxySettings -ImportFromInternetSettings

Vous pouvez importer les paramètres du proxy WinHTTP afin que les agents Microsoft Entra Connect Health puissent les utiliser. Sur chacun des serveurs qui exécutent l’agent d’intégrité, exécutez la commande PowerShell suivante :

Set-MicrosoftEntraConnectHealthProxySettings -ImportFromWinHttp

Spécifier les adresses du proxy manuellement

Vous pouvez spécifier manuellement un serveur proxy. Sur chacun des serveurs qui exécutent l’agent d’intégrité, exécutez la commande PowerShell suivante :

Set-MicrosoftEntraConnectHealthProxySettings -HttpsProxyAddress address:port

Voici un exemple :

Set-MicrosoftEntraConnectHealthProxySettings -HttpsProxyAddress myproxyserver: 443

Dans cet exemple :

• Le paramètre address peut être un nom de serveur DNS pouvant être résolu ou une adresse IPv4.
• Vous pouvez omettre port. Si vous le faites, le port 443 est le port par défaut.

Effacer la configuration de proxy existante

Vous pouvez effacer la configuration du proxy en exécutant la commande suivante :

Set-MicrosoftEntraConnectHealthProxySettings -NoProxy

Lecture des paramètres de proxy actuels

Vous pouvez lire les paramètres de proxy actuels en exécutant la commande suivante :

Get-MicrosoftEntraConnectHealthProxySettings

Tester la connectivité au service Microsoft Entra Connect Health

Parfois, l’agent Microsoft Entra Connect Health perd la connectivité au service Microsoft Entra Connect Health. Les causes de cette perte de connectivité peuvent inclure des problèmes de réseau, des problèmes d’autorisation et divers autres problèmes.

Si l’agent ne peut pas envoyer de données au service Microsoft Entra Connect Health pendant plus de deux heures, l’alerte suivante s’affiche dans le portail : Les données du service Health ne sont pas à jour.

Vous pouvez savoir si l’agent Microsoft Entra Connect Health concerné peut charger des données vers le service Microsoft Entra Connect Health en exécutant la commande PowerShell suivante :

Test-MicrosoftEntraConnectHealthConnectivity -Role ADFS

Le paramètre Role peut avoir les valeurs suivantes :

• ADFS
• Sync
• ADDS

Étapes suivantes

Consultez les articles connexes suivants :

• Microsoft Entra Connect Health
• Opérations Microsoft Entra Connect Health
• Utilisation de Microsoft Entra Connect Health avec AD FS
• Utilisation de Microsoft Entra Connect Health pour la synchronisation
• Utilisant Microsoft Entra Connect Health avec les services de domaine AD
• FAQ sur Microsoft Entra Connect Health
• Historique des versions de Microsoft Entra Connect Health