Assign owner to orphaned organization

Azure DevOps Services

When the Owner and all Project Collection Administrators are inactive, the organization is considered orphaned. An orphaned organization doesn't have an administrator, so there's no way of transferring administrator rights to another user.

For organizations connected to Azure AD, if the Owner and all other Project Collection Administrators are inactive in Azure AD, you can transfer ownership to another user.

Note

If your organization isn't considered orphaned and you want to change the owner, then see Change organization owner.

Prerequisites

  • You must be an Azure DevOps Administrator in Azure AD. It isn't a requirement to be a Project Collection Administrator.
  • The Azure DevOps Administrator role can only claim ownership of organizations in the following instances:
    • when the current owner and all members of the Project Collection Administrators group are inactive in the backing Azure AD
    • when individual users, rather than groups, are assigned to the Azure DevOps Administrator role

Find your Azure DevOps Administrator

If you don't know who the Azure DevOps Administrator is for your organization, follow these steps to find out.

  1. To find your Azure DevOps Administrator, go to the Azure portal, as described in View and assign administrator roles in Azure AD. To learn more about Azure AD roles, see Administrator role permissions in Azure AD.
  2. The Azure DevOps Administrator can now complete the steps in Change Azure DevOps owner to claim ownership of the target Azure DevOps organization.

When you don't have an Azure DevOps Administrator

When your Azure AD tenant hasn't assigned an Azure DevOps Administrator, complete the following steps.

  1. Find your Azure AD Global Administrator or Privileged Role Administrator. These administrators can be found in the Azure portal, as described in View and assign administrator roles in Azure AD. To learn more about Azure AD roles, see Administrator role permissions in Azure AD.

  2. Ask the Azure AD Global Administrator or Privileged Role Administrator to assign the Azure DevOps Administrator role to the appropriate user(s).

    Note

    Any changes to role membership may take up to an hour to propagate to Azure DevOps.

  3. The Azure DevOps Administrator can now complete the steps in Change Azure DevOps owner to claim ownership of the target Azure DevOps organization.

When your Azure DevOps Administrator is a member of the target organization

Complete the following steps when your Azure DevOps Administrator in Azure AD is a member of the target Azure DevOps organization.

  1. As the Azure DevOps Administrator, sign in to your organization (https://dev.azure.com/{yourorganization}).

  2. Select Organization settings, and then Overview.

  3. Within the warning message, select Change owner.

    Warning PCA and Owner inactive in Azure AD

  4. Select a user from the dropdown menu, or search for a user by entering the user's name, provide a short justification, and then select Change.

    Change the organization owner

A notification of the ownership transfer with your provided justification is sent to all Azure DevOps Administrators in your Azure AD.

When your Azure DevOps Administrator isn't a member of the target organization

Complete the following steps when your Azure DevOps Administrator in Azure AD isn't a member of the target Azure DevOps organization.

  1. Sign in to your organization (https://dev.azure.com/{yourorganization}) using the credentials granted to the Azure DevOps Administrator role in Azure AD. An error page appears where you can Claim Ownership.

    Azure AD Administrator not member of organization

  2. Select Claim Ownership. Provide a short justification, and then select Claim Ownership once again. All Azure DevOps Administrators in your Azure AD receive a notification of the ownership transfer, which includes your provided justification.

    Provide justification and claim ownership of the organization

    A notification of the ownership transfer with your provided justification is sent to all Azure DevOps Administrators in your Azure AD.

    You're redirected to the organization overview page. If you want to transfer ownership to another user, see Change organization Owner.