Merge pull request #298107 from habibaum/11Apr-new-updates

New updates

Author: Stacyrch140

articles/migrate/create-manage-projects.md

@@ -13,15 +13,11 @@ ms.custom: engagement-fy23
 
 ::: moniker range="migrate"
 
-This article describes how to create, manage, and delete [projects](migrate-services-overview.md). 
-
 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.
 ::: moniker-end
 
 ::: moniker range="migrate-classic"
 
-This article describes how to create, manage, and delete [projects](migrate-services-overview.md).
-
 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](./resources-faq.md#i-have-a-project-with-the-previous-classic-experience-of-azure-migrate-how-do-i-start-using-the-new-version) 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.  
@@ -104,7 +100,7 @@ PUT /subscriptions/<subid>/resourceGroups/<rg>/providers/Microsoft.Migrate/Migra
 
 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](https://learn.microsoft.com/cli/azure/install-azure-cli)
+Ensure that you have installed Az CLI to execute the required commands by following the steps provided in the documentation [here](/cli/azure/install-azure-cli).
 
 After you install the Az CLI (in PowerShell), open PowerShell on your system as an Administrator and execute the following commands:
 

articles/migrate/create-project.md

@@ -0,0 +1,142 @@
+---
+title: Create project
+description: Describes how to create project
+author: ankitsurkar06
+ms.author: v-uhabiba
+ms.service: azure-migrate
+ms.topic: how-to
+ms.date: 04/11/2025
+---
+
+# Create project
+
+::: moniker range="migrate"
+
+This article shows you how to create a project. 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.
+::: moniker-end
+
+::: moniker range="migrate-classic"
+
+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](./resources-faq.md#i-have-a-project-with-the-previous-classic-experience-of-azure-migrate-how-do-i-start-using-the-new-version) 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.  
+::: moniker-end
+
+## 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
+
+::: moniker range="migrate"
+
+Set up a new project in an Azure subscription.
+
+1. In the Azure portal, search for *Azure Migrate*.
+1. In **Services**, select **Azure Migrate**.
+1. In **Get started**, select **Discover, assess and migrate**.
+
+    :::image type="content" source="./media/create-manage-projects/create-project.png" alt-text="Screenshot shows how to create project." lightbox="./media/create-manage-projects/create-project.png" :::
+
+1. In Servers, databases and web apps, select **Create project**.
+   :::image type="content" source="./media/create-manage-projects/create-project-inline.png" alt-text="Screenshot of button to start creating a project." lightbox="./media/create-manage-projects/create-project-expanded.png":::
+1. In **Create project**, select the Azure subscription and resource group. Create a resource group if you don't have one.
+1. 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](supported-geographies.md#public-cloud) and [government clouds](supported-geographies.md#azure-government). 
+
+    > [!Note]
+    > Use the **Advanced** configuration section to create an Azure Migrate project with private endpoint connectivity. [Learn more](discover-and-assess-using-private-endpoints.md#create-a-project-with-private-endpoint-connectivity). 
+
+6. Select **Create**.
+
+    :::image type="content" source="./media/create-manage-projects/create-project-subscription.png" alt-text="Image of Azure Migrate page to create project." lightbox="./media/create-manage-projects/create-project-subscription.png":::
+
+Wait for a few minutes for the project to deploy.
+::: moniker-end
+
+::: moniker range="migrate-classic"
+
+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**.
+
+    :::image type="content" source="./media/create-manage-projects/assess-migrate-servers-inline.png" alt-text="Screenshot displays the options in Overview." lightbox="./media/create-manage-projects/assess-migrate-servers-expanded.png":::
+
+4. In **Servers, databases and web apps**, select **Create project**.
+
+    :::image type="content" source="./media/create-manage-projects/create-project-inline.png" alt-text="Screenshot of button to start creating a project." lightbox="./media/create-manage-projects/create-project-expanded.png":::
+
+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](migrate-support-matrix.md#public-cloud) and [government clouds](migrate-support-matrix.md#azure-government).
+
+    > [!Note]
+    > Use the **Advanced** configuration section to create an Azure Migrate project with private endpoint connectivity. [Learn more](discover-and-assess-using-private-endpoints.md#create-a-project-with-private-endpoint-connectivity).
+
+7. Select **Create**.
+
+     :::image type="content" source="./media/create-manage-projects/project-details.png" alt-text="Image of Azure Migrate page to input project settings.":::
+
+Wait for a few minutes for the project to deploy.
+::: moniker-end
+
+## 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.
+
+```rest
+PUT /subscriptions/<subid>/resourceGroups/<rg>/providers/Microsoft.Migrate/MigrateProjects/<mymigrateprojectname>?api-version=2018-09-01-preview "{location: 'centralus', properties: {}}"
+```
+
+::: moniker range="migrate"
+
+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](/cli/azure/install-azure-cli).
+
+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>
+1. Register the Dependency Map private preview feature on the Subscription.
+    - az feature registration create --name PrivatePreview --namespace Microsoft.DependencyMap
+1. 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
+1. Ensure that the provider is in registered state.
+    - az provider show -n Microsoft.DependencyMap
+    - Output contains - "registrationState": "Registered"
+::: moniker-end
+
+## Create additional projects
+
+If you already have a project and you want to create an additional project, do the following:  
+
+::: moniker range="migrate-classic"
+1. In the [Azure public portal](https://portal.azure.com) or [Azure Government](https://portal.azure.us), search for **Azure Migrate**.
+1. On the Azure Migrate dashboard, select **All Projects** on the upper left.
+1. Select a **Create Project**. 
+
+   :::image type="content" source="./media/create-manage-projects/create-a-project.png" alt-text="Screenshot shows how to create a project by selecting the create project button." lightbox="./media/create-manage-projects/create-a-project.png" :::
+::: moniker-end
+
+::: moniker range="migrate"
+1. In the [Azure public portal](https://portal.azure.com) or [Azure Government](https://portal.azure.us), search for **Azure Migrate**.
+1. On the Azure Migrate dashboard, select **Servers, databases and web apps** > **Create project** on the upper left
+   :::image type="content" source="./media/create-manage-projects/switch-project.png" alt-text="Screenshot that contains information on how to create a project." lightbox="./media/create-manage-projects/switch-project.png" :::
+1. To create a new project, select **Click here**.
+::: moniker-end
+
+## Next steps
+
+Add [assessment](how-to-assess.md) or [migration](how-to-migrate.md) tools to projects.