Merge pull request #296399 from v-thepet/dtl5

Freshness Edit: Azure DevTest Labs Set #2

Author: ShannonLeavitt

articles/devtest-labs/devtest-lab-add-vm.md

@@ -1,38 +1,38 @@
 ---
-title: Attach & detach data disks for lab VMs
-description: Learn how to attach or detach a data disk for a lab virtual machine in Azure DevTest Labs.
+title: Attach or detach data disks for lab VMs
+description: Learn how to use the Azure portal to attach or detach a data disk for an Azure DevTest Labs virtual machine (VM).
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 09/30/2023
+ms.date: 03/20/2025
 ms.custom: UpdateFrequency2
+
+#customer intent: As a lab user, I want to attach and detach data disks for my DevTest Labs VMs so I can manage storage or software separately from individual VMs.
 ---
 
-# Attach or detach a data disk for a lab virtual machine in Azure DevTest Labs
+# Attach or detach a data disk for a lab VM in Azure DevTest Labs
 
-This article explains how to attach and detach a lab virtual machine (VM) data disk in Azure DevTest Labs. You can create, attach, detach, and reattach multiple [data disks](/azure/virtual-machines/managed-disks-overview) for lab VMs that you own. This functionality is useful for managing storage or software separately from individual VMs.
+This article explains how to attach and detach a lab virtual machine (VM) data disk in Azure DevTest Labs by using the Azure portal. Depending on the VM size, you can create, attach, detach, and reattach multiple [data disks](/azure/virtual-machines/managed-disks-overview). Data disks let you manage storage or software separately from individual VMs.
 
 ## Prerequisites
 
-To attach or detach a data disk, you need to own the lab VM, and the VM must be running. The VM size determines how many data disks you can attach. For more information, see [Sizes for virtual machines](/azure/virtual-machines/sizes).
+To attach or detach a data disk, you must have ownership permissions on the lab VM, and the VM must be running. The VM size determines how many data disks you can attach. For more information, see [Sizes for virtual machines](/azure/virtual-machines/sizes).
 
 ## Create and attach a new data disk
 
 Follow these steps to create and attach a new managed data disk for a DevTest Labs VM.
 
-1. Select your VM from the **My virtual machines** list on the lab **Overview** page.
-
+1. In the Azure portal, select your VM from the **My virtual machines** list on your lab **Overview** page.
 1. On the VM **Overview** page, select **Disks** under **Settings** in the left navigation.
- 
 1. On the **Disks** page, select **Attach new**.
 
    :::image type="content" source="./media/devtest-lab-attach-detach-data-disk/devtest-lab-attach-new.png" alt-text="Screenshot of Attach new on the V M's Disk page.":::
 
-1. Fill out the **Attach new disk** form as follows:
+1. On the **Attach new disk** page:
 
    - For **Name**, enter a unique name.
-   - For **Disk type**, select a [disk type](/azure/virtual-machines/disks-types) from the drop-down list.
-   - For **Size (GiB)**, enter a size in gigabytes.
+   - For **Disk type**, select a [disk type](/azure/virtual-machines/disks-types) from the dropdown list.
+   - For **Size (GiB)**, enter the disk size in gigabytes.
 
 1. Select **OK**.
 
@@ -46,13 +46,11 @@ Follow these steps to create and attach a new managed data disk for a DevTest La
 
 Follow these steps to attach an existing available data disk to a running VM.
 
-1. Select your VM from the **My virtual machines** list on the lab **Overview** page.
-
+1. In the Azure portal, select your VM from the **My virtual machines** list on the lab **Overview** page.
 1. On the VM **Overview** page, select **Disks** under **Settings** in the left navigation.
- 
 1. On the **Disks** page, select **Attach existing**.
 
-   :::image type="content" source="./media/devtest-lab-attach-detach-data-disk/devtest-lab-attach-existing-button.png" alt-text="Screenshot of Attach existing on the V M's Disk page.":::
+   :::image type="content" source="./media/devtest-lab-attach-detach-data-disk/devtest-lab-attach-existing-button.png" alt-text="Screenshot of Attach existing on the VM's Disk page.":::
 
 1. On the **Attach existing disk** page, select a disk, and then select **OK**.
 
@@ -74,30 +72,28 @@ Follow these steps to detach an attached data disk from a running VM.
 
    :::image type="content" source="./media/devtest-lab-attach-detach-data-disk/devtest-lab-detach-button.png" alt-text="Screenshot of selecting a data disk to detach.":::
 
-1. On the data disk's page, select **Detach**, and then select **OK**.
+1. On the data disk's page, select **Detach**, then respond **OK** to **Are you sure you want to detach it**.
 
    :::image type="content" source="./media/devtest-lab-attach-detach-data-disk/devtest-lab-detach-data-disk-2.png" alt-text="Screenshot showing Detach on the Data disk page.":::
 
-The disk is detached, and is available to reattach to this or another VM. 
+The disk detaches, and is available to reattach to this or another VM. 
 
-### Detach or delete a data disk on the lab management page
+### Detach or delete a data disk from the lab page
 
-You can also detach or delete a data disk without navigating to the VM's page.
+You can also detach or delete a data disk by using the lab's **Overview** page.
 
-1. In the left navigation for your lab's **Overview** page, select **My data disks** under **My Lab**.
+1. On the lab **Overview** page in the Azure portal, select **My data disks** under **My Lab** in the left navigation.
 
 1. On the **My data disks** page, either:
 
-   - Select the disk you want to detach, and then on the data disk's page, select **Detach** and then select **OK**.
-
-     or
-
    - Select the ellipsis (**...**) next to the disk you want to detach, select **Detach** from the context menu, and then select **Yes**.
 
-     :::image type="content" source="./media/devtest-lab-attach-detach-data-disk/devtest-lab-detach-data-disk.png" alt-text="Screenshot of detaching a data disk from the listing's context menu.":::
+   - Or, select the disk name, and on the disk's page, select **Detach** and then select **OK**.
+
+   :::image type="content" source="./media/devtest-lab-attach-detach-data-disk/devtest-lab-detach-data-disk.png" alt-text="Screenshot of detaching a data disk from the listing's context menu.":::
 
-You can also delete a detached data disk, by selecting **Delete** from the context menu or from the data disk page. When you delete a data disk, it is removed from storage and can't be reattached anymore.
+To delete a detached data disk, select **Delete** from the context menu on the **My data disks** page, or select **Delete** on the disk's page. Deleting a data disk removes it from storage. If you want to attach the disk again, you must add it as a new disk.
 
-## Next steps
+## Related content
 
 For information about transferring data disks for claimable lab VMs, see [Transfer the data disk](devtest-lab-add-claimable-vm.md#transfer-the-data-disk).