Install the Azure AD Connect cloud provisioning agent

This document walks you through the installation process for the Azure Active Directory (Azure AD) Connect provisioning agent and how to initially configure it in the Azure portal.


The following installation instructions assume that all of the Prerequisites have been met.

Installing and configuring Azure AD Connect provisioning is accomplished in the following steps:

Install the agent

To install the agent, follow these steps.

  1. Sign in to the server you'll use with enterprise admin permissions.

  2. Sign in to the Azure portal, and then go to Azure Active Directory.

  3. In the left menu, select Azure AD Connect.

  4. Select Manage provisioning (preview) > Review all agents.

  5. Download the Azure AD Connect provisioning agent from the Azure portal.

    Download on-premises agent

  6. Run the Azure AD Connect provisioning installer (AADConnectProvisioningAgent.Installer).

  7. On the Microsoft Azure AD Connect Provisioning Agent Package screen, accept the licensing terms and select Install.

    Microsoft Azure AD Connect Provisioning Agent Package screen

  8. After this operation finishes, the configuration wizard starts. Sign in with your Azure AD global administrator account.

  9. On the Connect Active Directory screen, select Add Directory. Then sign in with your Active Directory administrator account. This operation adds your on-premises directory. Select Next.

    Connect Active Directory screen

  10. On the Configuration complete screen, select Confirm. This operation registers and restarts the agent.

    Configuration complete screen

  11. After this operation finishes, you should see the notice Your agent configuration was successfully verified. Select Exit.

    Exit button

  12. If you still see the initial Microsoft Azure AD Connect Provisioning Agent Package screen, select Close.

Verify agent installation

Agent verification occurs in the Azure portal and on the local server that's running the agent.

Azure portal agent verification

To verify the agent is being seen by Azure, follow these steps.

  1. Sign in to the Azure portal.

  2. On the left, select Azure Active Directory > Azure AD Connect. In the center, select Manage provisioning (preview).

    Azure portal

  3. On the Azure AD Provisioning (preview) screen, select Review all agents.

    Review all agents option

  4. On the On-premises provisioning agents screen, you see the agents you installed. Verify that the agent in question is there and is marked active.

    On-premises provisioning agents screen

On the local server

To verify that the agent is running, follow these steps.

  1. Sign in to the server with an administrator account.

  2. Open Services by either navigating to it or by going to Start > Run > Services.msc.

  3. Under Services, make sure Microsoft Azure AD Connect Agent Updater and Microsoft Azure AD Connect Provisioning Agent are there and their status is Running.

    Services screen


The agent has been installed but it must be configured and enabled before it will start synchronizing users. To configure a new agent, see Create a new configuration for Azure AD Connect cloud-based provisioning.

Next steps