Edit

Create and manage projects

Classic Azure Migrate is retiring in Feb 2024. After Feb 2024, the classic version of Azure Migrate will no longer be supported and the inventory metadata in the classic project will be deleted. If you're using classic projects, delete those projects and follow the steps to create a new project. You can't upgrade classic projects or components to Azure Migrate. View FAQ before you start the creation process.

A project is used to store discovery, assessment, and migration metadata collected from the environment you're assessing or migrating. In a project, you can track discovered assets, create assessments, and orchestrate migrations to Azure.

Verify permissions

Ensure you have the correct permissions to create a project using the following steps:

  1. In the Azure portal, open the relevant subscription, and select Access control (IAM).
  2. In Check access, find the relevant account, and select it and view permissions. You should have Contributor or Owner permissions.

Create a project for the first time

Set up a new project in an Azure subscription.

  1. In the Azure portal, search for Azure Migrate.

  2. In Services, select Azure Migrate.

  3. In Get started, select Discover, assess and migrate.

    Screenshot displays the options in Overview.

  4. In Servers, databases and web apps, select Create project.

    Screenshot of button to start creating a project.

  5. In Create project, select the Azure subscription and resource group. Create a resource group if you don't have one.

  6. In Project Details, specify the project name and the geography in which you want to create the project.

    • The geography is only used to store the metadata gathered from on-premises servers. You can assess or migrate servers for any target region regardless of the selected geography.
    • Review supported geographies for public and government clouds.

    Note

    Use the Advanced configuration section to create an Azure Migrate project with private endpoint connectivity. Learn more.

  7. Select Create.

    Image of Azure Migrate page to input project settings.

Wait for a few minutes for the project to deploy.

Create a project in a specific region

In the portal, you can select the geography in which you want to create the project. If you want to create the project within a specific Azure region, use the following API command to create the project.

PUT /subscriptions/<subid>/resourceGroups/<rg>/providers/Microsoft.Migrate/MigrateProjects/<mymigrateprojectname>?api-version=2018-09-01-preview "{location: 'centralus', properties: {}}"

Create additional projects

If you already have a project and you want to create an additional project, do the following:

  1. In the Azure public portal or Azure Government, search for Azure Migrate.

  2. On the Azure Migrate dashboard, select All Projects on the upper left.

  3. Select a Create Project.

    Screenshot shows how to create a project by selecting the create project button.

Find a project

Follow the steps to find a project:

  1. In the Azure portal, search for Azure Migrate.

  2. Select All Projects from the upper left.

  3. Filter and select the project of your choice.

    Screenshot shows how to filter and select the project.

  1. In the Azure portal, search for Azure Migrate.

  2. In Azure Migrate dashboard, select Servers, databases and webapps > Current project from the upper right corner.

    Screenshot to select the current project.

  3. Select the appropriate subscription and project.

Find a classic project

If you created the project in the previous version of Azure Migrate, find it as follows:

  1. In the Azure portal, search for Azure Migrate.

  2. In the Azure Migrate dashboard, if you've created a project in the previous version, a banner referencing older projects appears. Select the banner.

    Screenshot to access already existing projects.

  3. Review the list of old projects. ::: moniker-end

Delete a project

Follow the steps to delete a project:

  1. In the Azure public portal or Azure Government, search for Azure Migrate.

  2. Select All Projects from the upper left.

  3. Find the project you want to delete.

  4. Select More options and then select Delete Project.

    Screenshot shows how to delete a project.

  5. The window appears to Delete project.

    Window appears to delete a project.

    Note

    You can't delete or manage the associated Microsoft Entra app from this Azure Migrate project level. To delete this resource, visit the Microsoft Entra app details or use the Azure Command Line Interface (AzCLI). az ad app delete --id <aad app id>

  6. When you delete a project, both the project and its metadata about discovered servers are deleted. If you want to keep resources such as key vaults or storage vaults, you can deselect them

  7. After you finalize the list of resources to delete, select Next.

    Window appears to delete a project with selected resource.

  8. Review the list of resources to be deleted.

  9. Enter the name of project and then select Delete.

    Window appears to review and delete a project.

Note

When you delete, both the project and the metadata about discovered servers are permanently removed. This action is irreversible and deleted objects can't be restored.

Next steps

Add assessment or migration tools to projects.

  • Last updated on