Update manage VM pool for reimage/redeploy

Author: ntrogh

articles/lab-services/how-to-manage-vm-pool.md

@@ -12,34 +12,28 @@ ms.date: 07/04/2023
 
 # Manage a lab virtual machine pool in Azure Lab Services
 
-The lab virtual machine pool represents the set of lab virtual machines (VMs) that are available for lab users to connect to. The lab VM creation starts when you publish a lab template, or when you update the lab capacity. Learn how to change the capacity of the lab and modify the number of lab virtual machines, or manage the state of individual lab VMs.
+Learn how you can manage the pool of lab virtual machines (VMs) in Azure Lab Services. Change the capacity of the lab to add or remove lab VMs, connect to a lab, or manage the state of individual lab VMs.
+
+The lab virtual machine pool represents the set of lab VMs that are available for lab users to connect to. The lab VM creation starts when you publish a lab template, or when you update the lab capacity.
 
 When you synchronize the lab user list with an Azure AD group, or create a lab in Teams or Canvas, Azure Lab Services manages the lab VM pool automatically based on membership.
 
-When you manage a lab VM pool, you can:
+## Prerequisites
+
+[!INCLUDE [Azure subscription](./includes/lab-services-prerequisite-subscription.md)]
+[!INCLUDE [Create and manage labs](./includes/lab-services-prerequisite-create-lab.md)]
+[!INCLUDE [Existing lab plan](./includes/lab-services-prerequisite-lab-plan.md)]
 
-- Start and stop all or selected lab VMs.
-- Reset a VM
-- Connect to a lab user's VM.
-- Change the lab capacity.
+## Lab VM states
 
-Lab VMs can be in one of a few states.
+A lab VM can be in one of the following states:
 
 - **Unassigned**. The lab VM is not assigned to a lab user yet. The lab VM doesn't automatically start with the lab schedule.
 - **Stopped**. The lab VM is turned off and not available for use.
 - **Starting**.  The lab VM is starting.  It's not yet available for use.
 - **Running**. The lab VM is running and is available for use.
 - **Stopping**.  The lab VM is stopping and not available for use.
 
-> [!WARNING]
-> When you start a lab VM, it doesn't affect the available [quota hours](./classroom-labs-concepts.md#quota) for the lab user. Make sure to stop all lab VMs manually or use a [schedule](how-to-create-schedules.md) to avoid unexpected costs.
-
-## Prerequisites
-
-[!INCLUDE [Azure subscription](./includes/lab-services-prerequisite-subscription.md)]
-[!INCLUDE [Create and manage labs](./includes/lab-services-prerequisite-create-lab.md)]
-[!INCLUDE [Existing lab plan](./includes/lab-services-prerequisite-lab-plan.md)]
-
 ## Change lab capacity
 
 When you synchronize the lab user list with an Azure AD group, or create a lab in Teams or Canvas, Azure Lab Services manages the lab VM pool automatically based on membership. When you add or remove a user, the lab capacity increases or decreases accordingly. Lab users are also automatically registered and assigned to their lab VM.
@@ -62,7 +56,7 @@ To manually start all lab VMs:
 
 1. Select the **Start all** button at the top of the page.
 
-    :::image type="content" source="./media/how-to-set-virtual-machine-passwords/start-all-vms-button.png" alt-text="Screenshot that shows the Virtual machine pool page and the Start all button is highlighted.":::
+    :::image type="content" source="./media/how-to-manage-vm-pool/start-all-vms-button.png" alt-text="Screenshot that shows the Virtual machine pool page and the Start all button is highlighted.":::
 
 To start individual lab VMs:
 
@@ -74,6 +68,9 @@ To start individual lab VMs:
 
 1. Alternately, select multiple VMs using the checks to the left of the **Name** column, and then select the **Start** button at the top of the page.
 
+> [!NOTE]
+> When you start a lab VM, it doesn't affect the available [quota hours](./classroom-labs-concepts.md#quota) for the lab user. Make sure to stop all lab VMs manually or use a [schedule](how-to-create-schedules.md) to avoid unexpected costs.
+
 ## Manually stop lab VMs
 
 To manually stop all lab VMs:
@@ -82,7 +79,7 @@ To manually stop all lab VMs:
 
 1. Select the **Stop all** button to stop all of the lab VMs.
 
-    :::image type="content" source="./media/how-to-set-virtual-machine-passwords/stop-all-vms-button.png" alt-text="Screenshot that shows the Virtual machine pool page and the Stop all button is highlighted.":::
+    :::image type="content" source="./media/how-to-manage-vm-pool/stop-all-vms-button.png" alt-text="Screenshot that shows the Virtual machine pool page and the Stop all button is highlighted.":::
 
 To start individual lab VMs:
 
@@ -94,30 +91,40 @@ To start individual lab VMs:
 
 1. Alternately, select multiple VMs using the checks to the left of the **Name** column, and then select the **Stop** button at the top of the page.
 
-## Reset lab VMs
+## Reimage lab VMs
 
-When you reset a lab VM, Azure Lab Services shuts down the lab VM, deletes it, and recreates a new lab VM from the original template VM. You can think of a reset as a refresh of the entire lab VM.
+When you reimage a lab VM, Azure Lab Services shuts down the lab VM, deletes it, and recreates a new lab VM from the original lab template. You can think of a reimage operation as a refresh of the entire VM.
 
 > [!CAUTION]
-> After you reset a lab VM, all the data that's saved on the OS disk (usually the C: drive on Windows), and the temporary disk (usually the D: drive on Windows), is lost. Learn how to [store the user data outside the lab VM](/azure/lab-services/troubleshoot-access-lab-vm#store-user-data-outside-the-lab-vm).
+> After you reimage a lab VM, all the data that you saved on the OS disk (usually the C: drive on Windows), and the temporary disk (usually the D: drive on Windows), is lost. Learn how you can [store the user data outside the lab VM](./troubleshoot-access-lab-vm.md#store-user-data-outside-the-lab-vm).
 
-To reset one or more lab VMs:
+To reimage one or more lab VMs:
 
 1. Go to the **Virtual machine pool** page for the lab.
 
-1. Select **Reset** in the toolbar.
+1. Select one or multiple VMs from the list, and then select **Reimage** in the toolbar.
+
+    :::image type="content" source="./media/how-to-manage-vm-pool/reset-vm-button.png" alt-text="Screenshot of virtual machine pool.  Reset button is highlighted.":::
 
-    :::image type="content" source="./media/how-to-set-virtual-machine-passwords/reset-vm-button.png" alt-text="Screenshot of virtual machine pool.  Reset button is highlighted.":::
+1. On the **Reimage virtual machine** dialog box, and then select **Reimage** to start the operation.
 
-1. On the **Reset virtual machine(s)** dialog box, select **Reset**.
+    After the reimage operation finishes, the lab VMs are recreated from the lab template, and assigned to the lab users.
 
-    :::image type="content" source="./media/how-to-set-virtual-machine-passwords/reset-vms-dialog.png" alt-text="Screenshot of reset virtual machine confirmation dialog.":::
+## Redeploy lab VMs
+
+When you redeploy a lab VM, Azure Lab Services shuts down the lab VM, moves the lab VM to a new node in the Azure infrastructure, and then powers it back on. You can think of a redeploy operation as a refresh of the underlying VM for your lab.
+
+All data that you saved in the [OS disk](/azure/virtual-machines/managed-disks-overview#os-disk) (usually the C: drive on Windows) of the VM is still available after the redeploy operation. Any data on the [temporary disk](/azure/virtual-machines/managed-disks-overview#temporary-disk) (usually the D: drive on Windows) is lost after a redeploy operation.
+
+To redeploy one or more lab VMs:
+
+1. Go to the **Virtual machine pool** page for the lab.
 
-### Redeploy lab VMs
+1. Select one or multiple VMs from the list, and then select **Redeploy** in the toolbar.
 
-When you use [lab plans](./lab-services-whats-new.md), lab users can now redeploy their lab VM. This operation is labeled **Troubleshoot** in Azure Lab Services. When you redeploy a lab VM, Azure Lab Services will shut down the VM, move the VM to a new node within the Azure infrastructure, and then power it back on.
+    :::image type="content" source="./media/how-to-manage-vm-pool/redeploy-vm-button.png" alt-text="Screenshot that shows the virtual machine pool in the Lab Services web portal, highlighting the Redeploy button.":::
 
-Learn how [lab users can redeploy their lab VM](./how-to-reset-and-redeploy-vm.md#redeploy-a-lab-vm).
+1. On the **Redeploy virtual machine** dialog box, select **Redeploy** to start the redeployment.
 
 ## Connect to lab VMs