Updated after review

Author: ntrogh

articles/lab-services/TOC.yml

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

articles/lab-services/concept-approaches-troubleshoot-lab-vm.md

@@ -0,0 +1,79 @@
+---
+title: Labs concepts
+titleSuffix: Azure Lab Services
+description: Learn the different approaches for troubleshooting lab VMs in Azure Lab Services. Understand how each apporach affects user data.
+services: lab-services
+ms.service: lab-services
+author: ntrogh
+ms.author: nicktrog
+ms.topic: conceptual
+ms.date: 12/05/2022
+---
+
+# Approaches for troubleshooting lab VMs in Azure Lab Services
+
+In this article, you learn about the different approaches for troubleshooting lab VMs. Understand how each approach affects your lab environment and user data on the lab VM. There can be different reasons why you're unable to connect to a lab VM in Azure Lab Services, or why you're stuck to complete a course. For example, the underlying VM is experiencing issues, your organization's firewall settings have changed, or a software change in the lab VM operating system.
+
+## Lab VM troubleshooting workflow
+
+Use the following process for troubleshooting issues with a lab VM in Azure Lab Services:
+
+1. If you're not able to connect to the lab VM with Remote Desktop (RDP) or Secure Shell (SSH):
+
+    1. [Redeploy your lab VM](./how-to-reset-and-redeploy-vm.md#redeploy-vms) to another infrastructure node, while maintaining the user data. 
+
+        This approach might help resolve issues with the underlying virtual machine. Learn more about [redeploying versus resetting a lab VM](#redeploy-versus-reset-a-lab-vm) and how they affect your user data.
+
+    1. [Verify your organization's firewall settings for your lab](./how-to-configure-firewall-settings.md) with the educator and IT admin.
+
+        A change in the organization's firewall or network settings might prevent your computer to connect to the lab VM.
+
+    1. If you still can't connect to the lab VM, [reset the lab VM](./how-to-reset-and-redeploy-vm.md#reset-vms).
+
+        > [!IMPORTANT]
+        > Resetting a lab VM deletes the user data in the VM. Make sure to [store the user data outside the lab VM](#store-user-data-outside-the-lab-vm).
+    
+1. After you connect to the lab VM, it's not working correctly.
+
+    The lab VM might be malfunctioning as a result of installing a software component, or making a change to the operating system configuration.
+
+    1. If the lab VM uses Windows, you might use the Windows System Restore built-in functionality to undo a previous change to the operating system. Verify with an educator or IT admin how to use [System Restore](https://support.microsoft.com/windows/use-system-restore-a5ae3ed9-07c4-fd56-45ee-096777ecd14e).
+
+    1. If the lab VM is still in an incorrect state, [reset the lab VM](./how-to-reset-and-redeploy-vm.md#reset-vms).
+
+        > [!IMPORTANT]
+        > Resetting a lab VM deletes the user data in the VM. Make sure to [store the user data outside the lab VM](#store-user-data-outside-the-lab-vm).
+
+## Redeploy versus reset a lab VM
+
+Azure Lab Services lets you redeploy, labeled *troubleshooting* in the Azure portal, or reset a lab VM. Both operations are similar, and result in the creation of a new virtual machine instance. However, there are fundamental differences that affect the user data on the lab VM.
+
+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 and after a VM shutdown.
+
+Learn more about how to [redeploy a lab VM in the Azure Lab Services website](./how-to-reset-and-redeploy-vm.md#redeploy-vms).
+
+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 VM, including the underlying VM. 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. To avoid losing data on the VM, [store the user data outside the lab VM](#store-user-data-outside-the-lab-vm).
+
+Learn more about how to [reset a lab VM in the Azure Lab Services website](./how-to-reset-and-redeploy-vm.md#reset-vms).
+
+> [!NOTE]
+> Redeploying a VM is only available for lab VMs that you created in a lab plan. VMs that are connected to a lab account only support the reset operation.
+
+## Store user data outside the lab VM
+
+When you reset a lab VM, all user data on the VM is lost. To avoid losing this data, you have to store the user data outside of the lab VM. You have different options to configure the template VM:
+
+- [Use OneDrive to store user data](./how-to-prepare-windows-template.md#install-and-configure-onedrive).
+- [Attach external file storage](./how-to-attach-external-storage.md), such as Azure Files or Azure NetApp Files.
+
+## Create multiple labs for a course
+
+As students use a lab VM to advance through a course, they might get stuck at specific steps. For example, they're unable to install and configure a software component on the lab VM. To unblock students, you can create multiple labs, based off different template VMs, for each of the key stages in the course.
+
+Learn how to [set up a new lab](./tutorial-setup-lab.md#create-a-lab) and how to [create and manage templates](./how-to-create-manage-template.md).
+
+## Next steps
+
+- As a student, learn how to [reset or deploy lab VMs](./how-to-reset-and-redeploy-vm.md).
+- As an admin or educator, [attach external file storage to a lab](./how-to-attach-external-storage.md).
+- As an educator, [use OneDrive to store user data](./how-to-prepare-windows-template.md#install-and-configure-onedrive).

articles/lab-services/concept-strategies-troubleshoot-lab-vm.md

@@ -14,7 +14,7 @@ ms.date: 12/06/2022
 
 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).
+Learn more about [strategies for troubleshooting lab VMs](./concept-approaches-troubleshoot-lab-vm.md).
 
 ## Reset VMs
 
@@ -25,11 +25,11 @@ You can reset a lab VM that is assigned to you. If you have the Lab Assistant, L
 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).
+> 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-approaches-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:
+To reset a lab VM in the Azure Lab Services website 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. Go to the [Azure Lab Services website](https://labs.azure.com/virtualmachines) to view you virtual machines.
 
 1. For a specific lab VM, select **...** > **Reset**.
 
@@ -41,7 +41,7 @@ To reset a lab VM in the Azure Lab Services web portal that's assigned to you:
 
 Alternatively, if you have permissions across multiple labs, you can reset mulitple VMs for a lab:
 
-1. Go to the [Azure Lab Services web portal](https://labs.azure.com).
+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.
 
@@ -55,20 +55,20 @@ Alternatively, if you have permissions across multiple labs, you can reset mulit
 
 ## 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 labelled  **Troubleshoot** in the Azure Lab Services web portal 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 website 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 only redeploy a lab VM in the Azure Lab Services website that is assigned to you.
 
 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:
+To redeploy a lab VM in the Azure Lab Services website:
 
-1. Go to the [Azure Lab Services web portal](https://labs.azure.com/virtualmachines) to view you virtual machines.
+1. Go to the [Azure Lab Services website](https://labs.azure.com/virtualmachines) to view you virtual machines.
 
 1. For a specific lab VM, select **...** > **Troubleshoot**.