Azure Active Directory Connect FAQ

General installation

Q: Will installation work if the Azure Active Directory (Azure AD) Global Admin has two-factor authentication (2FA) enabled?
As of the February 2016 builds, this scenario is supported.

Q: Is there a way to install Azure AD Connect unattended?
Azure AD Connect installation is supported only when you use the installation wizard. An unattended, silent installation is not supported.

Q: I have a forest where one domain cannot be contacted. How do I install Azure AD Connect?
As of the February 2016 builds, this scenario is supported.

Q: Does the Azure Active Directory Domain Services (Azure AD DS) health agent work on server core?
Yes. After you install the agent, you can complete the registration process by using the following PowerShell cmdlet:

Register-AzureADConnectHealthADDSAgent -Credentials $cred

Q: Does Azure AD Connect support syncing from two domains to on Azure AD?
Yes, this scenario is supported. Refer to Multiple Domains.

Q: Can you have multiple connectors for the same Active Directory domain in Azure AD Connect?
No, multiple connectors for the same AD domain are not supported.

Q: Can I move the Azure AD Connect database from the local database to a remote SQL Server instance?
Yes, the following steps provide general guidance on how to do this. We are currently working on a more detailed document.

  1. Back up the LocalDB ADSync database. The simplest way to do this is to use SQL Server Management Studio installed on the same machine as Azure AD Connect. Connect to (localdb).\ADSync, and then back up the ADSync database.

  2. Restore the ADSync database to your remote SQL Server instance.

  3. Install Azure AD Connect against the existing remote SQL database. The article demonstrates how to migrate to using a local SQL database. If you are migrating to using a remote SQL database, in step 5 of the process you must also enter an existing service account that the Windows Sync service will run as. This sync engine service account is described here:

    Use an existing service account: By default, Azure AD Connect uses a virtual service account for the synchronization services to use. If you use a remote SQL Server instance or use a proxy that requires authentication, use a managed service account or a service account in the domain, and know the password. In those cases, enter the account to use. Make sure that users who are running the installation are system administrators in SQL so that login credentials for the service account can be created. For more information, see Azure AD Connect accounts and permissions.

    With the latest build, provisioning the database can now be performed out of band by the SQL administrator and then installed by the Azure AD Connect administrator with database owner rights. For more information, see Install Azure AD Connect by using SQL delegated administrator permissions.

To keep things simple, we recommend that users who install Azure AD Connect be system administrators in SQL. However, with recent builds you can now use delegated SQL administrators, as described in Install Azure AD Connect using SQL delegated administrator permissions.

Network

Q: I have a firewall, network device, or something else that limits the time that connections can stay open on my network. What should my client-side timeout threshold be when I use Azure AD Connect?
All networking software, physical devices, or anything else that limits the maximum time that connections can remain open should use a threshold of at least five minutes (300 seconds) for connectivity between the server where the Azure AD Connect client is installed and Azure Active Directory. This recommendation also applies to all previously released Microsoft Identity synchronization tools.

Q: Are single label domains (SLDs) supported?
While we strongly recommend against this network configuration (see article), using Azure AD Connect sync with a single label domain is supported, as long as the network configuration for the single level domain is functioning correctly.

Q: Are Forests with disjoint AD domains supported?
No, Azure AD Connect does not support on-premises forests that contain disjoint namespaces.

Q: Are "dotted" NetBIOS names supported?
No, Azure AD Connect does not support on-premises forests or domains where the NetBIOS name contains a dot (.).

Q: Is pure IPv6 environment supported?
No, Azure AD Connect does not support a pure IPv6 environment.

Federation

Q: What do I do if I receive an email that asks me to renew my Office 365 certificate?
For guidance about renewing the certificate, see renew certificates.

Q: I have "Automatically update relying party" set for the Office 365 relying party. Do I have to take any action when my token signing certificate automatically rolls over?
Use the guidance that's outlined in the article renew certificates.

Environment

Q: Is it supported to rename the server after Azure AD Connect has been installed?
No. Changing the server name renders the sync engine unable to connect to the SQL database instance, and the service cannot start.

Identity data

Q: Why doesn't the userPrincipalName (UPN) attribute in Azure AD match the on-premises UPN?
For information, see these articles:

You can also configure Azure AD to allow the sync engine to update the UPN, as described in Azure AD Connect sync service features.

Q: Is it supported to soft-match an on-premises Azure AD group or contact object with an existing Azure AD group or contact object?
Yes, this soft match is based on the proxyAddress. Soft matching is not supported for groups that are not mail-enabled.

Q: Is it supported to manually set the ImmutableId attribute on an existing Azure AD group or contact object to hard-match it to an on-premises Azure AD group or contact object?
No, manually setting the ImmutableId attribute on an existing Azure AD group or contact object to hard-match it is currently not supported.

Custom configuration

Q: Where are the PowerShell cmdlets for Azure AD Connect documented?
With the exception of the cmdlets that are documented on this site, other PowerShell cmdlets found in Azure AD Connect are not supported for customer use.

Q: Can I use the "Server export/server import" option that's found in Synchronization Service Manager to move the configuration between servers?
No. This option does not retrieve all configuration settings, and it should not be used. Instead, use the wizard to create the base configuration on the second server, and use the sync rule editor to generate PowerShell scripts to move any custom rule between servers. For more information, see Swing migration.

Q: Can passwords be cached for the Azure sign-in page, and can this caching be prevented because it contains a password input element with the autocomplete = "false" attribute?
Currently, modifying the HTML attributes of the Password field, including the autocomplete tag, is not supported. We are currently working on a feature that allows for custom JavaScript, which lets you add any attribute to the Password field.

Q: The Azure sign-in page displays the usernames of users who have previously signed in successfully. Can this behavior be turned off?
Currently, modifying the HTML attributes of the Password input field, including the autocomplete tag, is not supported. We are currently working on a feature that allows for custom JavaScript, which lets you add any attribute to the Password field.

Q: Is there a way to prevent concurrent sessions?
No.

Auto upgrade

Q: What are the advantages and consequences of using auto upgrade?
We are advising all customers to enable auto upgrade for their Azure AD Connect installation. The benefit is that you always receive the latest patches, including security updates for vulnerabilities that have been found in Azure AD Connect. The upgrade process is painless and happens automatically as soon as a new version is available. Many thousands of Azure AD Connect customers use auto upgrade with every new release.

The auto-upgrade process always first establishes whether an installation is eligible for auto upgrade. If it is eligible, the upgrade is performed and tested. The process also includes looking for custom changes to rules and specific environmental factors. If the tests show that an upgrade is unsuccessful, the previous version is automatically restored.

Depending on the size of the environment, the process can take a couple of hours. While the upgrade is in progress, no sync between Windows Server Active Directory and Azure AD happens.

Q: I received an email telling me that my auto upgrade no longer works and I need to install a new version. Why do I need to do this?
Last year, we released a version of Azure AD Connect that, under certain circumstances, might have disabled the auto-upgrade feature on your server. We have fixed the issue in Azure AD Connect version 1.1.750.0. If you have been affected by the issue, you can mitigate it by running a PowerShell script to repair it or by manually upgrading to the latest version of Azure AD Connect.

To run the PowerShell script, download the script and run it on your Azure AD Connect server in an administrative PowerShell window. To learn how to run the script, view this short video.

To manually upgrade, you must download and run the latest version of the AADConnect.msi file.

  • If your current version is older than 1.1.750.0, download and upgrade to the latest version.
  • If your Azure AD Connect version is 1.1.750.0 or later, no further action is required. You’re already using the version that contains the auto-upgrade fix.

Q: I received an email telling me to upgrade to the latest version to re-enable auto upgrade. I am using version 1.1.654.0. Do I need to upgrade?
Yes, you need to upgrade to version 1.1.750.0 or later to re-enable auto upgrade. Download and upgrade to the latest version.

Q: I received an email telling me to upgrade to the latest version to re-enable auto upgrade. If I have used PowerShell to enable auto upgrade, do I still need to install the latest version?
Yes, you still need to upgrade to version 1.1.750.0 or later. Enabling the auto-upgrade service with PowerShell does not mitigate the auto-upgrade issue found in versions before 1.1.750.0.

Q: I want to upgrade to a newer version but I’m not sure who installed Azure AD Connect, and we do not have the username and password. Do we need this? You don’t need to know the username and password that was initially used to upgrade Azure AD Connect. Use any Azure AD account that has the Global Administrator role.

Q: How can I find which version of Azure AD Connect I am using?
To verify which version of Azure AD Connect is installed on your server, go to Control Panel and look up the installed version of Microsoft Azure AD Connect by selecting Programs > Programs and Features, as shown here:

Azure AD Connect version in Control Panel

Q: How do I upgrade to the latest version of Azure AD Connect?
To learn how to upgrade to the latest version, see Azure AD Connect: Upgrade from a previous version to the latest.

Q: We already upgraded to the latest version of Azure AD Connect last year. Do we need to upgrade again?
The Azure AD Connect team makes frequent updates to the service. To benefit from bug fixes and security updates as well as new features, it is important to keep your server up to date with the latest version. If you enable auto upgrade, your software version is updated automatically. To find the version release history of Azure AD Connect, see Azure AD Connect: Version release history.

Q: How long does it take to perform the upgrade, and what is the impact on my users?
The time needed to upgrade depends on your tenant size. For larger organizations, it might be best to perform the upgrade in the evening or weekend. During the upgrade, no synchronization activity takes place.

Q: I believe I upgraded to Azure AD Connect, but the Office portal still mentions DirSync. Why is this?
The Office team is working to get the Office portal updates to reflect the current product name. It does not reflect which sync tool you are using.

Q: My auto-upgrade status says, “Suspended." Why is it suspended? Should I enable it?
A bug was introduced in a previous version that, under certain circumstances, leaves the auto-upgrade status set to “Suspended.” Manually enabling it is technically possible but would require several complex steps. The best thing you can do is install the latest version of Azure AD Connect.

Q: My company has strict change-management requirements, and I want to control when it’s pushed out. Can I control when auto upgrade is launched?
No, there is no such feature today. The feature is being evaluated for a future release.

Q: Will I get an email if the auto upgrade failed? How will I know that it was successful?
You will not be notified of the result of the upgrade. The feature is being evaluated for a future release.

Q: Do you publish a timeline for when you plan to push out auto upgrades?
Auto upgrade is the first step in the release process of a newer version. Whenever there is a new release, upgrades are pushed automatically. Newer versions of Azure AD Connect are pre-announced in the Azure AD Roadmap.

Q: Does auto upgrade also upgrade Azure AD Connect Health?
Yes, auto upgrade also upgrades Azure AD Connect Health.

Q: Do you also auto-upgrade Azure AD Connect servers in staging mode?
Yes, you can auto-upgrade an Azure AD Connect server that is in staging mode.

Q: If auto upgrade fails and my Azure AD Connect server does not start, what should I do?
In rare cases, the Azure AD Connect service does not start after you perform the upgrade. In these cases, rebooting the server usually fixes the issue. If the Azure AD Connect service still does not start, open a support ticket. For more information, see Create a service request to contact Office 365 support.

Q: I’m not sure what the risks are when I upgrade to a newer version of Azure AD Connect. Can you call me to help me with the upgrade?
If you need help upgrading to a newer version of Azure AD Connect, open a support ticket at Create a service request to contact Office 365 support.

Troubleshooting

Q: How can I get help with Azure AD Connect?

Search the Microsoft Knowledge Base (KB)

  • Search the KB for technical solutions to common break-fix issues about support for Azure AD Connect.

Azure Active Directory Forums

Get support for Azure AD