Microsoft Entra ID
General

Connect Install Automatic Upgrade

In brief

The page now correctly closes the TLS version error table row. The servicing guidance and event-log troubleshooting instructions remain unchanged.

What Entra admins need to know

No administrator action is required; the troubleshooting information is easier to read.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Result Message Description
UpgradeNotSupportedTLSVersionIncorrect Your TLS version is lower than 1.2. Follow our guide to update your TLS.
UpgradeNotSupportedCustomizedSyncRules There are custom synchronization rules configured in Microsoft Entra Connect.
Note: After version 2.2.1.0, this condition no longer prevents auto upgrade.
UpgradeNotSupportedInvalidPersistedState The installation isn't an Express settings or a DirSync upgrade.
UpgradeNotSupportedNonLocalDbInstall You aren't using a SQL Server Express LocalDB database.

Then, make sure you allow the required URLs in your proxy or firewall. Automatic update is using Microsoft Entra Connect Health as described in the overview. If you use a proxy, make sure Health is configured to use a proxy server. Also test the Health connectivity to Microsoft Entra ID.

With the connectivity to Microsoft Entra ID verified, it's time to look into the eventlogs. Start the event viewer and look in the Application eventlog. Add an eventlog filter for the source Microsoft Entra Connect Upgrade and the event ID range 300-399.
Screenshot that shows the "Filter Current Log" window with "Event sources" and the "Include/Exclude" Event IDs box highlighted.

You can now see the eventlogs associated with the status for automatic upgrade.
Eventlog filter for automatic upgrade

The result code has a prefix with an overview of the state.

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…