Change connection to Azure AD

Azure DevOps Services

If you need to switch your organization connection from one Azure Active Directory (Azure AD) to another, complete the following steps.

For more information about using Azure AD with Azure DevOps, see the Conceptual overview.

Prerequisites

Before you disconnect your organization from your directory, and then connect to a new directory, make sure the following is true:

  • You're using a Microsoft account, not a school or work account
  • You're the organization Owner
  • You're in the Project Collection Administrator group (in Organization settings) for the organization
  • You're in the source Azure AD and destination Azure AD as a member. For more information, see how you can convert an Azure AD guest into a member.

Change the Azure AD connection

  1. Sign in to your organization (https://dev.azure.com/{yourorganization}).

  2. Select gear icon Organization settings.

    Open Organization settings

  3. Select Disconnect directory.

    Select the Disconnect directory button

  4. Sign out, and then sign back in to Azure DevOps.

  5. Prepare your mapping list for inviting users to Azure AD.

    1. Sign in to your organization (https://dev.azure.com/{yourorganization}).

    2. Select gear icon Organization settings.

      Open Organization settings

    3. Select Users.

      Open organization settings, users

    4. Compare your Azure DevOps email list with your Azure AD email list. Create an Azure AD email address entry for every user who is in the Azure DevOps organization and NOT in the Azure AD. For any user that you don't create an Azure AD email address for, be prepared to invite these users as guests to the Azure AD in future steps.

  6. Connect to Azure AD, so users can regain access.

    Select Azure AD Connect directory