Merge pull request #227571 from ntrogh/als-freshness

[Azure Lab Services] Content freshness pass February 2023

Author: v-regandowner

articles/lab-services/class-type-adobe-creative-cloud.md

@@ -1,37 +1,60 @@
 ---
 title: Connect to Azure Lab Services VMs from Mac
-description: Learn how to connect from a Mac to a virtual machine in Azure Lab Services.
+titleSuffix: Azure Lab Services
+description: Learn how to connect using remote desktop (RDP) from a Mac to a virtual machine in Azure Lab Services.
+services: lab-services
+ms.service: lab-services
+author: ntrogh
+ms.author: nicktrog
 ms.topic: how-to
-ms.date: 02/04/2022
+ms.date: 02/16/2023
 ---
 
 # Connect to a VM using Remote Desktop Protocol on a Mac
 
-This section shows how a student can connect to a lab VM from a Mac by using RDP.
+In this article, you learn how to connect to a lab VM in Azure Lab Services from a Mac by using Remote Desktop Protocol (RDP).
 
 ## Install Microsoft Remote Desktop on a Mac
 
+To connect to the lab VM via RDP, you can use the Microsoft Remote Desktop app.
+
+To install the Microsoft Remote Desktop app:
+
 1. Open the App Store on your Mac, and search for **Microsoft Remote Desktop**.
+
     :::image type="content" source="./media/connect-virtual-machine-mac-remote-desktop\install-remote-desktop.png" alt-text="Screenshot of Microsoft Remote Desktop app in the App Store.":::
-1. Install the latest version of Microsoft Remote Desktop.
+
+1. Select **Install** to install the latest version of Microsoft Remote Desktop.
 
 ## Access the VM from your Mac using RDP
 
+Next, you connect to the lab VM by using the remote desktop application. You can retrieve the connection information for the lab VM from the Azure Lab Services website.
+
+1. Navigate to the Azure Lab Services website (https://labs.azure.com), and sign in with your credentials.
+
 1. On the tile for your VM, ensure the [VM is running](how-to-use-lab.md#start-or-stop-the-vm) and select the **Connect** icon.
 
     :::image type="content" source="./media/connect-virtual-machine-mac-remote-desktop/connect-vm.png" alt-text="Screenshot of My virtual machines page for Azure Lab Services.  The connect icon button on the VM tile is highlighted.":::
-1. If you’re connecting *to a Linux VM*, you'll see two options to connect to the VM: SSH and RDP.  Select the **Connect via RDP** option.  If you're connecting *to a Windows VM*, you don't need to choose an connection option.  The RDP file will automatically start downloading.
+
+1. If you’re connecting to a Linux VM, you'll see two options to connect to the VM: SSH and RDP.  Select the **Connect via RDP** option. If you're connecting to a Windows VM, you don't need to choose a connection option.  The RDP file will automatically start downloading.
 
     :::image type="content" source="./media/connect-virtual-machine-mac-remote-desktop/student-vm-connect-options.png" alt-text="Screenshot that shows V M tile for student.  The R D P and S S H connection options are highlighted.":::
-1. Open the **RDP** file that's downloaded on your computer with **Microsoft Remote Desktop** app previously installed. It should start connecting to the VM.
+
+1. Open the **RDP** file that's downloaded on your computer with **Microsoft Remote Desktop** installed. It should start connecting to the VM.
 
     :::image type="content" source="./media/how-to-use-classroom-lab/connect-linux-vm.png" alt-text="Screenshot of Microsoft Remote Desktop app connecting to a remote VM.":::
-1. Select **Continue** if you receive the following warning.
+
+1. When prompted, enter your username and password.
+
+1. If you receive a certificate warning, you can select **Continue**.
 
     :::image type="content" source="./media/how-to-use-classroom-lab/certificate-error.png" alt-text="Screenshot of certificate error for Microsoft Remote Desktop app.":::
-1. You should see the VM desktop.  The following example is for a CentOS Linux VM.
 
-    :::image type="content" source="./media/how-to-use-classroom-lab/vm-ui.png" alt-text="Screenshot of desktop for CentOs Linux VM.":::
+1. After the connection is established, you see the desktop of your lab VM.
+
+    The following example is for a CentOS Linux VM:
+
+    :::image type="content" source="./media/how-to-use-classroom-lab/vm-ui.png" alt-text="Screenshot of the desktop for a CentOS Linux VM.":::
 
 ## Next steps
 

articles/lab-services/class-type-jupyter-notebook.md

@@ -1,41 +1,58 @@
 ---
-title: Connect to a VM using Remote Desktop Protocol on Windows in Azure Lab Services | Microsoft Docs
-description: Learn how to connect from Windows to a Linux VM using Remote Desktop Protocol
+title: Connect to Azure Lab Services VMs from Windows
+titleSuffix: Azure Lab Services
+description: Learn how to connect using remote desktop (RDP) from Windows to a virtual machine in Azure Lab Services.
+services: lab-services
+ms.service: lab-services
+author: ntrogh
+ms.author: nicktrog
 ms.topic: how-to
-ms.date: 02/01/2022
+ms.date: 02/17/2023
 ---
 
 # Connect to a VM using Remote Desktop Protocol on Windows
 
-This article shows how a student can connect from Windows to a lab VM using Remote Desktop Protocol (RDP).
+In this article, you learn how to connect to a lab VM in Azure Lab Services from Windows by using Remote Desktop Protocol (RDP).
 
 ## Connect to VM from Windows using RDP
 
-Students can use RDP to connect to their lab VMs.  If the lab VM is a Windows VM, no extra configuration is required by the educator.  If the lab VM is a Linux VM, the educator must [enable RDP](how-to-enable-remote-desktop-linux.md) and install GUI packages for a Linux graphical desktop.
+You can use RDP to connect to your lab VMs in Azure Lab Services. If the lab VM is a Linux VM, the lab creator must [enable RDP for the lab](how-to-enable-remote-desktop-linux.md) and install GUI packages for a Linux graphical desktop. For Windows-based lab VMs, no additional configuration is needed.
 
-Typically, the [Remote Desktop client](/windows-server/remote/remote-desktop-services/clients/remote-desktop-clients) is already installed and configured on Windows.  As a result, all you need to do is select on the RDP file to open it and start the remote session.
+Typically, the [Remote Desktop client software](/windows-server/remote/remote-desktop-services/clients/remote-desktop-clients) is already present on Windows. To connect to the lab VM, you open the RDP connection file to start the remote session.
 
-1. On the tile for your VM, ensure the [VM is running](how-to-use-lab.md#start-or-stop-the-vm) and select the **Connect** icon.
+To connect to a lab VM in Azure Lab Services:
 
-    :::image type="content" source="./media/connect-virtual-machine-windows-rdp/connect-vm.png" alt-text="Screenshot of My virtual machines page for Azure Lab Services.  The connect icon button on the VM tile is highlighted.":::
-1. If you’re connecting *to a Linux VM*, you'll see two options to connect to the VM: SSH and RDP.  Select the **Connect via RDP** option.  If you're connecting *to a Windows VM*, you don't need to choose a connection option.  The RDP file will automatically start downloading.
+1. Navigate to the Azure Lab Services website (https://labs.azure.com), and sign in with your credentials.
 
-    :::image type="content" source="./media/connect-virtual-machine-windows-rdp/student-vm-connect-options.png" alt-text="Screenshot that shows V M tile for student.  The R D P and S S H connection options are highlighted.":::
-1. When the RDP file is downloaded onto your machine, open it to launch the RDP client.
-1. After adjusting RDP connection settings as needed, select **Connect** to start the remote session.
+1. On the tile for your VM, select the **Connect** icon.
+
+    To connect to a lab VM, the vm must be running. Learn how you can [start a VM](how-to-use-lab.md#start-or-stop-the-vm).
+
+    :::image type="content" source="./media/connect-virtual-machine-windows-rdp/connect-vm.png" alt-text="Screenshot of My virtual machines page for Azure Lab Services, highlighting the connect button on the VM tile.":::
+
+1. If you’re connecting to a Linux VM, select the **Connect via RDP** option.
+
+    :::image type="content" source="./media/connect-virtual-machine-windows-rdp/student-vm-connect-options.png" alt-text="Screenshot that shows VM tile for student, highlighting the connect button and showing the SSH and RDP connection options.":::
+
+1. After the RDP connection file download finishes, open the RDP file to launch the RDP client.
+
+1. Optionally, adjust the RDP connection settings, and then select **Connect** to start the remote session.
 
 ## Optimize RDP client settings
 
-The RDP client includes various settings that can be adjusted to optimize the user's connection experience.  Typically, these settings don't need to be changed.  By default, the settings are already configured to choose the right experience based on your network connection.  For more information on these settings, see [RDP client's **Experience** settings](/windows-server/administration/performance-tuning/role/remote-desktop/session-hosts#client-experience-settings).
+The RDP client software has various settings for optimizing your connection experience. The default settings optimize your experience based on your network connection. Typically, you don't need to change the default settings.
+
+Learn more about the [RDP client's **Experience** settings](/windows-server/administration/performance-tuning/role/remote-desktop/session-hosts#client-experience-settings).
+
+If the lab creator configured the GNOME graphical desktop on a Linux lab VM with the RDP client, we recommend the following settings to optimize performance:
 
-If your educator has configured the GNOME graphical desktop on a Linux VM with the RDP client, we recommend the following settings to optimize performance:
+- On the **Display** tab, set the color depth to **High Color (15 bit)**.
 
-- Under the **Display** tab, set the color depth to **High Color (15 bit)**.
+    :::image type="content" source="./media/connect-virtual-machine-windows-rdp/rdp-display-settings.png" alt-text="Screenshot of display tab of the Windows R D P client, highlighting the color depth setting.":::
 
-    :::image type="content" source="./media/connect-virtual-machine-windows-rdp/rdp-display-settings.png" alt-text="Screenshot of display tab of the Windows R D P client.  The color depth setting is highlighted.":::
-- Under the **Experience** tab, set the connection speed to **Modem (56 kbps)**.
+- On the **Experience** tab, set the connection speed to **Modem (56 kbps)**.
 
-    :::image type="content" source="./media/connect-virtual-machine-windows-rdp/rdp-experience-settings.png" alt-text="Screenshot of experience tab of the Windows R D P client.  The connection speed setting is highlighted.":::
+    :::image type="content" source="./media/connect-virtual-machine-windows-rdp/rdp-experience-settings.png" alt-text="Screenshot of experience tab of the Windows R D P client, highlighting the connection speed setting.":::
 
 ## Next steps
 

articles/lab-services/connect-virtual-machine-mac-remote-desktop.md

@@ -1,18 +1,24 @@
 ---
-title: How to connect to an Azure Lab Services VM | Microsoft Docs
-description: Learn how to connect to a VM in Azure Lab Services
+title: How to connect to a lab VM
+titleSuffix: Azure Lab Services
+description: Learn how to connect to a lab VM in Azure Lab Services.
 services: lab-services
+ms.service: lab-services
+author: ntrogh
+ms.author: nicktrog
 ms.topic: how-to
-ms.date: 02/1/2022
+ms.date: 02/17/2023
 ---
 
 # Connect to a lab VM
 
-As a student, you'll need to [start](how-to-use-lab.md#start-or-stop-the-vm) and then connect to your lab VM to complete your lab work.  How you connect to your VM will depend on the operating system (OS) of the machine your using and the OS of the VM your connecting to.  
+In this article, you learn how to connect to a lab virtual machine (VM) in Azure Lab Services. Depending on the operating system (OS) and your local machine, you can use different mechanisms, such as secure shell (SSH) or remote desktop (RDP), to connect to your VM.
+
+To connect to a lab VM, the VM must be running. Learn more about [how to start and stop a lab VM](how-to-use-lab.md#start-or-stop-the-vm).
 
 ## Connect to a Windows lab VM
 
-If connecting *to a Windows VM*, follow the instructions based on the type of OS you're using.
+Follow these instructions to connect to a Windows-based lab VM. Choose the instructions that match your local machine's operating system.
 
 | Client OS | Instructions |
 | --------- | ------------ |
@@ -22,18 +28,18 @@ If connecting *to a Windows VM*, follow the instructions based on the type of OS
 
 ## Connect to a Linux lab VM
 
-This section shows students how to connect to a Linux VM in a lab using secure shell protocol (SSH), remote desktop protocol (RDP), or X2Go.  
+To connect to a Linux-based lab VM, you can use the secure shell protocol (SSH), remote desktop protocol (RDP), or X2Go.
 
-SSH is configured automatically for Linux VMs.  Both students and educators can SSH into Linux VMs without any extra setup.  However, if students need to connect to using a GUI, the educators may need to do extra setup on the template VM.
+Azure Lab Services automatically configures SSH for Linux VMs. Both lab users and lab creators can SSH into Linux VMs without additional setup. If you want to connect to a VM with a Linux GUI, the lab creator might need to do extra setup on the template VM.
 
 > [!WARNING]
-> If you need to use [GNOME](https://www.gnome.org/) or [MATE](https://mate-desktop.org/) you should coordinate with your educator to ensure your lab VM is properly configured. For details, see [Using GNOME or MATE graphical desktops](how-to-enable-remote-desktop-linux.md#using-gnome-or-mate-graphical-desktops).
+> If you need to use [GNOME](https://www.gnome.org/) or [MATE](https://mate-desktop.org/) you should coordinate with the lab creator to ensure that your lab VM has the correct configuration. For details, see [Using GNOME or MATE graphical desktops](how-to-enable-remote-desktop-linux.md#using-gnome-or-mate-graphical-desktops).
 
-### Connect to a Linux lab VM Using RDP
+### Connect to a Linux lab VM using RDP
 
-An educator must first [enable remote desktop connection for Linux VMs](how-to-enable-remote-desktop-linux.md#rdp-setup).
+Before you can connect to a Linux VM using RDP, the lab creator first needs to [enable remote desktop connection for Linux VMs](how-to-enable-remote-desktop-linux.md#rdp-setup).
 
-To connect *to a Linux VM using RDP*, follow the instructions based on the type of OS you're using.
+To connect to a Linux VM using RDP, follow the instructions based on the type of OS you're using.
 
 | Client OS | Instructions |
 | --------- | ------------ |
@@ -45,22 +51,32 @@ To connect *to a Linux VM using RDP*, follow the instructions based on the type
 
 Linux VMs can have X2Go enabled and a graphical desktop installed.  For more information, see [X2Go Setup](how-to-enable-remote-desktop-linux.md#setting-up-x2go) and [Using GNOME or MATE graphical desktops](how-to-enable-remote-desktop-linux.md#using-gnome-or-mate-graphical-desktops).  
 
-For instructions to connect *to a Linux VM using X2Go*, see [Connect to a VM using X2Go](connect-virtual-machine-linux-x2go.md).
+For instructions to connect to a Linux VM using X2Go, see [Connect to a VM using X2Go](connect-virtual-machine-linux-x2go.md).
 
 ### Connect to a Linux lab VM using SSH
 
-By default Linux VMs have SSH installed. To connect *to a Linux VM using SSH*, do the following actions:
+By default Linux VMs have SSH installed. To connect to a Linux VM using SSH:
+
+1. If you're using a Windows machine to connect to the lab VM, ensure you have SSH client software on your machine.
+
+    The latest version of Windows 10 and Windows 11 include a built-in SSH client. Learn how you can use the [access the built-in SSH client](/windows/terminal/tutorials/ssh).
+
+    Alternately, you can download an SSH client, such as [PuTTY](https://www.putty.org/) or enable [OpenSSH in Windows](/windows-server/administration/openssh/openssh_install_firstuse).
 
-1. If using a Windows machine to connect to a Linux VM, first install an ssh client like [PuTTY](https://www.putty.org/) or enable [OpenSSH in Windows](/windows-server/administration/openssh/openssh_install_firstuse).
-1. [Start the VM](how-to-use-lab.md#start-or-stop-the-vm), if not done already.
-1. Once the VM is running, select **Connect**, which will show a dialog box that provides the SSH command string.  The connection command will look like the following sample:
+1. If the lab VM is not running, go to the [Azure Lab Services website](https://labs.azure.com), and then [start the lab VM](how-to-use-lab.md#start-or-stop-the-vm).
+
+1. Once the VM is running, select the **Connect** icon > **Connect via SSH**, to get the SSH command string
+
+    The connection command looks like the following sample:
 
     ```bash
     ssh -p 12345 student@ml-lab-00000000-0000-0000-0000-000000000000.eastus2.cloudapp.azure.com
     ```
 
 1. Copy the command.
+
 1. Go to your command prompt or terminal, paste in the command, and then press **ENTER**.
+
 1. Enter the password to sign in to the lab VM.
 
 ## Next steps