Updated how-to reset/redeploy lab VMs

Author: ntrogh

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

@@ -1,33 +1,78 @@
 ---
 title: Troubleshoot a VM in Azure Lab Services
-description: Learn how to troubleshoot a VM in Azure Lab Services
+description: Learn how to troubleshoot a VM in Azure Lab Services by redeploying or resetting the VM.
+services: lab-services
+ms.service: lab-services
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 01/21/2022
+ms.date: 12/06/2022
 ---
 <!-- 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 -->
 
-# How to troubleshoot a VM
-On rare occasions, you may have problems connecting with a VM in one of your labs. There are some troubleshooting steps you can take as a student to resolve connectivity issues and get back up and running quickly. You can avoid having to escalate the issue to your educator and wait for a solution.
+# Troubleshoot a lab by redeploying or resetting the 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.
+
+Learn more about [strategies for troubleshooting lab VMs](./concept-strategies-troubleshoot-lab-vm.md).
 
 ## Reset VMs
 
-To reset one or more VMs, select them in the list, and then select **Reset** on the toolbar.
+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 lab, including the underlying VM.
+
+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.
+
+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).
+
+> [!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](./concept-strategies-troubleshoot-lab-vm.md#store-user-data-outside-the-lab-vm).
+
+To reset a lab VM in the Azure Lab Services web portal that's assigned to you:
+
+1. Go to the [Azure Lab Services web portal](https://labs.azure.com/virtualmachines) to view you virtual machines.
+
+1. For a specific lab VM, select **...** > **Reset**.
+
+    :::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.":::
+
+1. On the **Reset virtual machine** dialog box, select **Reset**.
+
+    :::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/reset-vm-button.png" alt-text="Screenshot of virtual machine pool.  Reset button is highlighted.":::
+Alternatively, if you have permissions across multiple labs, you can reset mulitple VMs for a lab:
 
-On the **Reset virtual machine(s)** dialog box, select **Reset**.
+1. Go to the [Azure Lab Services web portal](https://labs.azure.com).
 
-:::image type="content" source="./media/how-to-reset-and-redeploy-vm/reset-vms-dialog.png" alt-text="Screenshot of reset virtual machine confirmation dialog.":::
+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. On the **Reset virtual machine** dialog box, select **Reset**.
+
+    :::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.":::
 
 ### Redeploy VMs
 
-In the [April 2022 Update](lab-services-whats-new.md), redeploying VMs replaces the previous reset VM behavior.  In the Lab Services web portal: [https://labs.azure.com](https://labs.azure.com), the command is named **Troubleshoot** and is available in the student's view of their 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 labelled  **Troubleshoot** in the Azure Lab Services web portal and is available in the student's view of their VMs.
+
+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.
+
+You can redeploy a lab VM that is assigned to you. If you have the Lab Assistant, Lab Contributor, or Lab Operator role, you can redeploy any lab VM for which you have permissions.
+
+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).
+
+> [!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.
+
+To redeploy a lab VM in the Azure Lab Services web portal:
+
+1. Go to the [Azure Lab Services web portal](https://labs.azure.com/virtualmachines) to view you virtual machines.
 
-If you're facing difficulties accessing their VM, redeploying the VM may provide a resolution for the issue. Redeploying, unlike resetting, doesn't cause the data on the OS to be lost.  When you [redeploy a VM](/troubleshoot/azure/virtual-machines/redeploy-to-new-node-windows), Azure Lab Services will shut down the VM, move it to a new host, and restart it.  You can think of it as a refresh of the underlying VM for your machine.  You don’t need to re-register to the lab or perform any other action.  Any data you saved in the OS disk (usually C: drive) of the VM will still be available after the redeploy operation.  Anything saved on the temporary disk (usually D: drive) will be lost.
+1. For a specific lab VM, select **...** > **Troubleshoot**.
 
-:::image type="content" source="./media/how-to-reset-and-redeploy-vm/redeploy-vms.png" alt-text="Screenshot of redeploy virtual machine menu option.":::
+    :::image type="content" source="./media/how-to-reset-and-redeploy-vm/redeploy-vms.png" alt-text="Screenshot that shows the redeploy a virtual machine menu option in the Lab Services web portal.":::
 
 ## Next steps