Vague error when installing Entra Connect Health Agent, seeking troubleshooting tips

Question

Hello - I am attempting to install AAD Connect using express settings and at then end of the install / configuration I get the error message "Installation failed for your Microsoft Entra Connect Health Agent" There is no additional information provided as to why or pointers to resources I can explore. Trying to rule out some potentially basic issues such as disabling our endpoint client and uninstalling a reinstalling AAD connect. Neither of these helped. I have googled this but haven't really found much information. Can someone assist me with some tips or resources so I can ferret this issue out?

Answer 1

Hi @Matthew Miller ,

First I would make sure that you have a Microsoft Entra ID Premium P1 subscription since it cannot be installed without it.

If you have already confirmed this though, it sounds like it could be a connectivity issue if you are seeing the generic error.

1)I would recommend running Test-AzureADConnectHealthConnectivity -Role Sync

https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/how-to-connect-health-agent-install

2)Run this command and see if you are getting http 403 forbidden or not:

3)If you are using a proxy to connect to internet, set the proxy using the Set-AzureAdConnectHealthProxySettings -HttpsProxyAddress address:port cmdlet.

4)Make sure you are using a work or school account with global admin privileges and have at least a Premium P1 subscription.

5)I would recommend checking the requirements and connectivity to the required Azure service endpoints mentioned in below document. Make sure any outbound traffic to these endpoints are not being blocked by your corporate firewall:

• https://learn.microsoft.com/en-us/azure/active-directory/hybrid/how-to-connect-health-agent-install#requirements
• https://learn.microsoft.com/en-us/azure/active-directory/hybrid/how-to-connect-health-agent-install#outbound-connectivity-to-the-azure-service-endpoints.

6)I would recommend checking the health agent logs to get more details about the error.

If these steps do not work and you still are unable to install the agent, I would recommend reaching out to me at AzCommunity@microsoft.com ("Attn: Marilee Turscak") and include your subscription ID and a link to this thread, and I will open a one-time free support case to get this addressed.

If the information helped you, please Accept the answer. This will help us as well as others in the community who may be researching similar questions.