Create and manage projects

This article shows you how to create, manage, and delete projects. A project is used to store discovery, business case, assessment, and migration metadata collected from the environment you're assessing or migrating. Within a project, you can track discovered assets, create business cases, conduct assessments, and orchestrate migrations to Azure.

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.

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.

   

4. In Servers, databases and web apps, select Create 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 region 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 region.
   • Review supported regions 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.

   

Wait for a few minutes for the project to deploy.

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.

   

4. In Servers, databases and web apps, select Create 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.

   

Wait for a few minutes for the project to deploy.

After you have created the project, perform the following steps to try out the new agentless dependency analysis enhancements:

Ensure that you have installed Az CLI to execute the required commands by following the steps provided in the documentation here.

After you install the Az CLI (in PowerShell), open PowerShell on your system as an Administrator and execute the following commands:

1. Log in to the Azure tenant and set the Subscription.
   • az login --tenant <TENANT_ID>
   • az account set --subscription <SUBSCRIPTION_ID>
2. Register the Dependency Map private preview feature on the Subscription.
   • az feature registration create --name PrivatePreview --namespace Microsoft.DependencyMap
3. Ensure that the feature is in registered state. 

• az feature registration show --name PrivatePreview --provider-namespace Microsoft.DependencyMap - Output contains - "state": "Registered"

1. Register the new Dependency Map resource provider. 
   • az provider register --namespace Microsoft.DependencyMap
2. Ensure that the provider is in registered state.
   • az provider show -n Microsoft.DependencyMap
   • Output contains - "registrationState": "Registered"

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.

   

1. In the Azure public portal or Azure Government, search for Azure Migrate.
2. On the Azure Migrate dashboard, select Servers, databases and web apps > Create project on the upper left
3. To create a new project, select Click here.

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.

   

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.

   

5. The window appears to Delete project.

   

   Note

   You can't delete or manage the associated Azure Active Directory (AAD) app from this Azure Migrate project level. To delete this resource, visit the AAD 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.

   

8. Review the list of resources to be deleted.

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

   

To delete a project, follow these steps:

1. Open the Azure resource group in which the project was created.

2. In the Resource Groups page, select Show hidden types.

3. Select the project that you want to delete and its associated resources.

   • The resource type is Microsoft.Migrate/migrateprojects.
   • If the resource group is exclusively used by the project, you can delete the entire resource group.

   Note

   • When you delete, both the project and the metadata about discovered servers are deleted.
   • If you're using the older version of Azure Migrate, open the Azure resource group in which the project was created. Select the project you want to delete (the resource type is Migration project).
   • If you're using dependency analysis with an Azure Log Analytics workspace:
   • If you've attached a Log Analytics workspace to the Server Assessment tool, the workspace isn't automatically deleted. The same Log Analytics workspace can be used for multiple scenarios.
   • If you want to delete the Log Analytics workspace, do that manually.
   • Project deletion is irreversible. Deleted objects can't be recovered.

Delete a workspace manually

1. Browse to the Log Analytics workspace attached to the project.

   • If you haven't deleted the project, you can find the link to the workspace in Essentials > Server Assessment.

   • If you've already deleted the project, select Resource Groups in the left pane of the Azure portal and find the workspace.

2. Follow the instructions to delete the workspace.