Update reset & reimage lab VM for lab users

Author: ntrogh

articles/lab-services/TOC.yml

@@ -239,7 +239,7 @@
       href: connect-virtual-machine-chromebook-remote-desktop.md
     - name: Connect to Linux VM using X2Go
       href: connect-virtual-machine-linux-x2go.md
-    - name: Redeploy or reset a lab VM
+    - name: Redeploy or reimage a lab VM
       href: how-to-reset-and-redeploy-vm.md  
     - name: Set or reset passwords for lab VMs 
       href: how-to-set-virtual-machine-passwords-student.md 

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

@@ -117,7 +117,7 @@ To reset one or more lab VMs:
 
 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.
 
-Learn how [lab users can redeploy their lab VM](./how-to-reset-and-redeploy-vm.md#redeploy-vms).
+Learn how [lab users can redeploy their lab VM](./how-to-reset-and-redeploy-vm.md#redeploy-a-lab-vm).
 
 ## Connect to lab VMs
 

articles/lab-services/how-to-reset-and-redeploy-vm.md

@@ -1,84 +1,97 @@
 ---
-title: Troubleshoot a VM in Azure Lab Services
-description: Learn how to troubleshoot a VM in Azure Lab Services by redeploying or resetting the VM.
+title: Troubleshoot a lab VM
+description: Learn how you can troubleshoot your lab VM in Azure Lab Services by redeploying the VM to another hardware node, or by reimaging the lab VM to its initial state.
 services: lab-services
 ms.service: lab-services
 ms.topic: how-to
 author: ntrogh
 ms.author: nicktrog
-ms.date: 12/06/2022
+ms.date: 09/28/2023
 ---
 <!-- As a student, I want to be able to troubleshoot connectivity problems with my VM so that I can get back up and running quickly, without having to escalate an issue -->
 
-# Troubleshoot a lab by redeploying or resetting the VM
+# Troubleshoot a lab VM by redeploying or reimaging the lab VM
 
-On rare occasions, you may have problems connecting to a VM in one of your labs. In this article, you learn how to redeploy or reset a lab VM in Azure Lab Services. You can use these troubleshooting steps to resolve connectivity issues for your assigned labs, without support from an educator or admin.
+In this article, you learn how to troubleshoot problems with connecting to your lab virtual machine (VM) in Azure Lab Services. As a lab user, you can perform troubleshooting operations on the lab VM, without support from the lab creator or an administrator.
 
-Learn more about [strategies for troubleshooting lab VMs](./troubleshoot-access-lab-vm.md).
+You can perform the following troubleshooting operations on the lab VM:
 
-## Reset VMs
+- **Redeploy a lab VM**: Azure Lab Services moves the VM to a new node in the Azure infrastructure, and then powers it back on. All data on the OS disk is still available after a redeploy operation.
 
-When you reset a lab VM, Azure Lab Services will shut down the VM, delete it, and recreate a new lab VM from the original template VM. You can think of a reset as a refresh of the entire VM.
+- **Reimage a lab VM**:  Azure Lab Services recreates a new lab VM from the original template. All data in the lab VM is lost.
 
-You can reset a lab VM that is assigned to you. If you have the Lab Assistant, Lab Contributor, or Lab Operator role, you can reset any lab VM for which you have permissions.
+## Redeploy a lab VM
 
-You can also reset a lab VM by using the [REST api](/rest/api/labservices/virtual-machines/reimage), [PowerShell](/powershell/module/az.labservices/update-azlabservicesvmreimage), or the [.NET SDK](/dotnet/api/azure.resourcemanager.labservices.labvirtualmachineresource.reimage).
+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.
 
-> [!WARNING]
-> After you reset 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).
+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.
+
+You can redeploy a lab VM that is assigned to you. If you have the Lab Assistant, or Lab Contributor role, you can redeploy any lab VM for which you have permissions.
 
-To reset a lab VM in the Azure Lab Services website that's assigned to you:
+To redeploy a lab VM that's assigned to you:
 
 1. Go to the [Azure Lab Services website](https://labs.azure.com/virtualmachines) to view your virtual machines.
 
-1. For a specific lab VM, select **...** > **Reset**.
+1. For a specific lab VM, select **...** > **Redeploy**.
 
-    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/reset-single-vm.png" alt-text="Screenshot that shows how to reset a lab VM in the Lab Services web portal, highlighting the Reset button.":::
+    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/redeploy-single-vm.png" alt-text="Screenshot that shows the Redeploy virtual machine menu option in the Lab Services web portal.":::
 
-1. On the **Reset virtual machine** dialog box, select **Reset**.
+1. On the **Redeploy virtual machine** dialog box, select **Redeploy** to start the redeployment.
 
-    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/reset-single-vm-confirmation.png" alt-text="Screenshot that shows the confirmation dialog for resetting a single VM in the Lab Services web portal.":::
+    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/redeploy-single-vm-confirmation.png" alt-text="Screenshot that shows the confirmation dialog for redeploying a single VM in the Lab Services web portal.":::
 
-Alternatively, if you have permissions across multiple labs, you can reset multiple VMs for a lab:
+Alternatively, if you have permissions across multiple labs, you can redeploy multiple VMs for a lab:
 
 1. Go to the [Azure Lab Services website](https://labs.azure.com).
 
 1. Select a lab, and then go to the **Virtual machine pool** tab.
 
-1. Select one or multiple VMs from the list, and then select **Reset** in the toolbar.
-
-    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/reset-vm-button.png" alt-text="Screenshot that shows the virtual machine pool in the Lab Services web portal, highlighting the Reset button.":::
+1. Select one or multiple VMs from the list, and then select **Redeploy** in the toolbar.
 
-1. On the **Reset virtual machine** dialog box, select **Reset**.
+    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/redeploy-vm-button.png" alt-text="Screenshot that shows the virtual machine pool in the Lab Services web portal, highlighting the Redeploy button.":::
 
-    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/reset-vms-dialog.png" alt-text="Screenshot that shows the reset virtual machine confirmation dialog in the Lab Services web portal.":::
+1. On the **Redeploy virtual machine** dialog box, select **Redeploy** to start the redeployment.
 
-## Redeploy VMs
 
-When you use lab plans, introduced in the [April 2022 Update](lab-services-whats-new.md), you can now also redeploy a lab VM. This operation is labeled  **Troubleshoot** in the Azure Lab Services website and is available in the student's view of their VMs.
+You can also redeploy a lab VM by using the [REST api](/rest/api/labservices/virtual-machines/redeploy), [PowerShell](/powershell/module/az.labservices/start-azlabservicesvmredeployment), or the [.NET SDK](/dotnet/api/azure.resourcemanager.labservices.labvirtualmachineresource.redeploy).
 
-When you redeploy a lab VM, Azure Lab Services will shut down the VM, move the VM to a new node in within the Azure infrastructure, and then power 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 will still be 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.
+## Reimage a lab VM
 
-You can only redeploy a lab VM in the Azure Lab Services website that is assigned to you.
+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.
 
-You can also redeploy a lab VM by using the [REST api](/rest/api/labservices/virtual-machines/redeploy), [PowerShell](/powershell/module/az.labservices/start-azlabservicesvmredeployment), or the [.NET SDK](/dotnet/api/azure.resourcemanager.labservices.labvirtualmachineresource.redeploy).
+You can reimage a lab VM that is assigned to you. If you have the Lab Assistant, or Lab Contributor role, you can reimage any lab VM for which you have permissions.
 
 > [!WARNING]
-> After you redeploy a VM, all the data that you saved on the [temporary disk](/azure/virtual-machines/managed-disks-overview#temporary-disk) (D: drive by default on Windows) is lost.
+> 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 redeploy a lab VM in the Azure Lab Services website:
+To reimage a lab VM that's assigned to you:
 
 1. Go to the [Azure Lab Services website](https://labs.azure.com/virtualmachines) to view your virtual machines.
 
-1. For a specific lab VM, select **...** > **Troubleshoot**.
+1. For a specific lab VM, select **...** > **Reimage**.
 
-    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/redeploy-vms.png" alt-text="Screenshot that shows the Redeploy virtual machine menu option in the Lab Services web portal.":::
+    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/reset-single-vm.png" alt-text="Screenshot that shows how to reimage a lab VM in the Lab Services web portal, highlighting the Reimage button.":::
 
-1. On the **Troubleshoot virtual machine** dialog box, select **Redeploy**.
+1. On the **Reimage virtual machine** dialog box, select **Reimage**.
 
-    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/redeploy-single-vm-confirmation.png" alt-text="Screenshot that shows the confirmation dialog for redeploying a single VM in the Lab Services web portal.":::
+    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/reset-single-vm-confirmation.png" alt-text="Screenshot that shows the confirmation dialog for reimaging a single VM in the Lab Services web portal.":::
+
+Alternatively, if you have permissions across multiple labs, you can reimage multiple VMs for a lab:
+
+1. Go to the [Azure Lab Services website](https://labs.azure.com).
+
+1. Select a lab, and then go to the **Virtual machine pool** tab.
+
+1. Select one or multiple VMs from the list, and then select **Reimage** in the toolbar.
+
+    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/reset-vm-button.png" alt-text="Screenshot that shows the virtual machine pool in the Lab Services web portal, highlighting the Reimage button.":::
+
+1. On the **Reimage virtual machine** dialog box, and then select **Reimage**.
+
+You can also reimage a lab VM by using the [REST api](/rest/api/labservices/virtual-machines/reimage), [PowerShell](/powershell/module/az.labservices/update-azlabservicesvmreimage), or the [.NET SDK](/dotnet/api/azure.resourcemanager.labservices.labvirtualmachineresource.reimage).
 
 ## Next steps
 
+- Learn more about [strategies for troubleshooting lab VMs](./troubleshoot-access-lab-vm.md).
 - As a student, learn to [access labs](how-to-use-lab.md).
 - As a student, [connect to a VM](connect-virtual-machine.md).