Merge pull request #268934 from TimShererWithAquent/us194307e

Freshness Pass 194290 (fifth PR):

Author: v-dirichards

articles/lab-services/includes/lab-services-add-lab-creator.md

@@ -5,7 +5,7 @@ ms.topic: include
 ms.service: lab-services
 ---
 
-To create or edit a lab in the Azure Lab Services website ([https://labs.azure.com](https://labs.azure.com)), your Azure account must be assigned the [Lab Creator role](../concept-lab-services-role-based-access-control.md#lab-creator-role) in Azure RBAC. If you assign the Lab Creator role on the lab plan's resource group, the user can create labs for all lab plans in the resource group. Learn more about [Azure Lab Services built-in roles](../concept-lab-services-role-based-access-control.md).
+To create or edit a lab in the Azure Lab Services website ([https://labs.azure.com](https://labs.azure.com)), your Azure account must be assigned the [Lab Creator role](../concept-lab-services-role-based-access-control.md#lab-creator-role) in Azure RBAC. If you assign the Lab Creator role to a user on the lab plan's resource group, that user can create labs for all lab plans in the resource group. Learn more about [Azure Lab Services built-in roles](../concept-lab-services-role-based-access-control.md).
 
 > [!NOTE]
 > Owners of a lab plan can automatically create labs and do not need to be assigned the Lab Creator role.
@@ -14,11 +14,11 @@ To create or edit a lab in the Azure Lab Services website ([https://labs.azure.c
 
 1. From the **Access control (IAM)** page, select **Add** > **Add role assignment**.
 
-    :::image type="content" source="../../../includes/role-based-access-control/media/add-role-assignment-menu-generic.png" alt-text="Screenshot that shows the Access control (I A M) page with Add role assignment menu option highlighted.":::
+    :::image type="content" source="../../../includes/role-based-access-control/media/add-role-assignment-menu-generic.png" alt-text="Screenshot that shows the Access control (IAM) page with Add role assignment menu option highlighted.":::
 
 1. On the **Role** tab, select the *Lab Creator* role.
 
-    :::image type="content" source="../../../includes/role-based-access-control/media/add-role-assignment-role-generic.png" alt-text="Screenshot that shows the Add roll assignment page with Role tab selected.":::
+    :::image type="content" source="../../../includes/role-based-access-control/media/add-role-assignment-role-generic.png" alt-text="Screenshot that shows the Add roll assignment page with Role tab selected." lightbox="../../../includes/role-based-access-control/media/add-role-assignment-role-generic.png":::
 
 1. On the **Members** tab, select the user you want to add to the *Lab Creators* role.
 

articles/lab-services/includes/lab-services-cleanup-resources.md

@@ -6,7 +6,7 @@ ms.topic: include
 
 When no longer needed, you can delete the resource group, lab plan, and all related resources.
 
-1. On the **Overview** page for the lab plan, select the **Resource group** link.
+1. In the Azure portal, on the **Overview** page for the lab plan, select **Resource group**.
 
 1. At the top of the page for the resource group, select **Delete resource group**.
 

articles/lab-services/includes/lab-services-tutorial-create-lab-plan.md

@@ -9,11 +9,11 @@ ms.service: lab-services
 
 1. Select **Create a resource** in the upper left-hand corner of the Azure portal.
 
-    :::image type="content" source="../media/lab-services-tutorial-create-lab-plan/azure-portal-create-resource.png" alt-text="Screenshot that shows the Azure portal home page, highlighting the Create a resource button.":::
+    :::image type="content" source="../media/lab-services-tutorial-create-lab-plan/azure-portal-create-resource.png" alt-text="Screenshot that shows the Azure portal home page, highlighting the Create a resource button." lightbox="../media/lab-services-tutorial-create-lab-plan/azure-portal-create-resource.png":::
 
-1. Enter **Lab Plan** in the search field, and then select **Create** > **Lab plan**.
+1. Enter *Lab Plan* in the search field, and then select **Create** > **Lab plan**.
 
-    :::image type="content" source="../media/lab-services-tutorial-create-lab-plan/select-lab-plans-service.png" alt-text="Screenshot of the Azure Marketplace and how to search for and create a lab plan resource.":::
+    :::image type="content" source="../media/lab-services-tutorial-create-lab-plan/select-lab-plans-service.png" alt-text="Screenshot of the Azure Marketplace and how to search for and create a lab plan resource." lightbox="../media/lab-services-tutorial-create-lab-plan/select-lab-plans-service.png":::
 
 1. On the **Basics** tab of the **Create a lab plan** page, provide the following information:
 
@@ -24,7 +24,7 @@ ms.service: lab-services
     | **Name** | Enter *MyLabPlan* as the lab plan name. |
     | **Region** | Select a geographic location to host your lab plan resource. |
 
-1. After you're finished configuring the resource, select **Review + Create**.
+1. After you finish configuring the resource, select **Review + Create**.
 
 1. Review all the configuration settings and select **Create** to start the deployment of the Lab Plan.
 
@@ -34,4 +34,4 @@ ms.service: lab-services
 
 1. Confirm that you see the Lab Plan **Overview** page for *MyLabPlan*.
 
-    :::image type="content" source="../media/lab-services-tutorial-create-lab-plan/lab-plan-page.png" alt-text="Screenshot that shows the lab plan overview page in the Azure portal.":::
+    :::image type="content" source="../media/lab-services-tutorial-create-lab-plan/lab-plan-page.png" alt-text="Screenshot that shows the lab plan overview page in the Azure portal." lightbox="../media/lab-services-tutorial-create-lab-plan/lab-plan-page.png":::

articles/lab-services/media/lab-services-tutorial-create-lab-plan/azure-portal-create-resource.png

@@ -1,23 +1,24 @@
 ---
 title: 'Quickstart: Create and connect to a lab'
 titleSuffix: Azure Lab Services
-description: In this quickstart, you learn how to create a Windows-based lab in Azure Lab Services. You create the lab from an Azure Marketplace image, publish it, and then connect to it through Remote Desktop (RDP).
+description: In this quickstart, you learn how to create a Windows-based lab in Azure Lab Services from an Azure Marketplace image, publish it, and connect to it.
 services: lab-services
 ms.service: lab-services
-author: ntrogh
-ms.author: nicktrog
+author: RoseHJM
+ms.author: rosemalcolm
 ms.topic: quickstart
-ms.date: 02/09/2023
+ms.date: 03/13/2024
 ms.custom: mode-portal
+#customer intent: As an  administrator or educator, I want to quickly create a lab virtual machine to test the procedure for making labs in Azure Lab Services.
 ---
 
 # Quickstart: Create and connect to a lab in Azure Lab Services
 
-Azure Lab Services enables you to create labs, whose infrastructure is managed by Azure. You can create labs for running classroom trainings, hackathons, or for experimenting. In this quickstart, you create a Windows-based lab virtual machine (VM) with Azure Lab Services and connect to it by using remote desktop (RDP).
+In this quickstart, you create a Windows-based lab virtual machine (VM) with Azure Lab Services and connect to it by using remote desktop (RDP). Azure Lab Services enables you to create labs with infrastructure managed by Azure. You can create labs for running classroom trainings, hackathons, or for experimenting.
 
-To create the lab VM, you first create a lab plan in the Azure portal, and use the Azure Lab Services website to add a lab based on an Azure Marketplace VM image. After you publish the VM, you can then register for the lab and connect to it by using remote desktop.
+To create the lab VM, you first create a lab plan in the Azure portal. Use the Azure Lab Services website to add a lab based on an Azure Marketplace VM image. After you publish the VM, you can register for the lab and connect to it by using remote desktop.
 
-:::image type="content" source="./media/quick-create-connect-lab/lab-services-process-windows-lab.png" alt-text="Diagram that shows the steps for creating a lab with Azure Lab Services, highlighting Create a lab plan, create lab, publish lab, and connect to lab.":::
+:::image type="content" source="./media/quick-create-connect-lab/lab-services-process-windows-lab.png" alt-text="Diagram that shows the steps for creating a lab with Azure Lab Services, highlighting Create a lab plan, create lab, publish lab, and connect to lab." lightbox="./media/quick-create-connect-lab/lab-services-process-windows-lab.png":::
 
 After you complete this quickstart, you'll have a lab that you can connect to and use for your own experimentation, or you can invite other lab users.
 
@@ -38,11 +39,11 @@ Follow these steps to add a lab to the lab plan you created earlier:
 
 1. Sign in to the [Azure Lab Services website](https://labs.azure.com) by using the credentials for your Azure subscription.
 
-1. Select **New lab**.  
+1. Select **Create lab**.  
 
-    :::image type="content" source="./media/quick-create-connect-lab/new-lab-button.png" alt-text="Screenshot of the Azure Lab Services website, highlighting the New lab button.":::
+    :::image type="content" source="./media/quick-create-connect-lab/new-lab-button.png" alt-text="Screenshot of the Azure Lab Services website, highlighting the Create lab button." lightbox="./media/quick-create-connect-lab/new-lab-button.png":::
 
-1. On the **New Lab** page, enter the following information, and then select **Next**:
+1. On the **New lab** page, enter the following information, and then select **Next**.
 
     | Field        | Description                |
     | ------------ | -------------------------- |
@@ -51,11 +52,11 @@ Follow these steps to add a lab to the lab plan you created earlier:
     | **Virtual machine size** | Select *Medium*. |
     | **Location** | Leave the default value. |
 
-    Some virtual machine sizes might not be available depending on the lab plan region and your subscription core limit. Learn more about [virtual machine sizes in the administrator's guide](./administrator-guide.md#vm-sizing) and how to [request additional capacity](./how-to-request-capacity-increase.md).
+    Some virtual machine sizes might not be available depending on the lab plan region and your subscription core limit. Learn more about [virtual machine sizes in the administrator's guide](./administrator-guide.md#vm-sizing) and how to [request more capacity](./how-to-request-capacity-increase.md).
 
     You can [enable or disable specific virtual machine images](./specify-marketplace-images.md#enable-and-disable-images) by configuring the lab plan.
 
-1. On the **Virtual machine credentials** page, specify the default **username** and **password**, and then select **Next**.
+1. On the **Virtual machine credentials** page, specify the default **Username** and **Password**. Select **Next**.
 
     By default, all the lab VMs use the same credentials.
 
@@ -64,29 +65,29 @@ Follow these steps to add a lab to the lab plan you created earlier:
 
     :::image type="content" source="./media/quick-create-connect-lab/new-lab-credentials.png" alt-text="Screenshot of the Virtual machine credentials page in the Azure Lab Services website.":::
 
-1. On the **Lab policies** page, leave the default values and select **Next**.
+1. On the **Lab policies** page, accept the default values and select **Next**.
 
 1. On the **Template virtual machine settings** page, select **Use virtual machine image without customization**.
 
-    In this quickstart, you use the VM image as-is, known as a *templateless VM*. Azure Lab Services also supports creating a *template VM*, which lets you make configuration changes or install software on top of the VM image.
+    In this quickstart, you use the VM image as-is, known as a *templateless VM*. Azure Lab Services also supports creating a *template VM*, which lets you configure the VM and install software in the VM image.
 
-    :::image type="content" source="./media/quick-create-connect-lab/templateless-virtual-machine-settings.png" alt-text="Screenshot of the Template virtual machine settings page, with the option selected to create a templateless VM."::: 
+    :::image type="content" source="./media/quick-create-connect-lab/templateless-virtual-machine-settings.png" alt-text="Screenshot of the Template virtual machine settings page, with the option selected to create a templateless VM.":::
 
-1. Select **Finish** to start the lab creation. It might take several minutes for the lab creation to finish.
+1. Select **Finish** to start the lab creation. It might take several minutes to create the lab.
 
 1. When the lab creation finishes, you can see the lab details in the **Template** page.
 
-    :::image type="content" source="./media/quick-create-connect-lab/templateless-template.png" alt-text="Screenshot of Template page for a templateless lab.":::
+    :::image type="content" source="./media/quick-create-connect-lab/templateless-template.png" alt-text="Screenshot of Template page for a templateless lab." lightbox="./media/quick-create-connect-lab/templateless-template.png":::
 
-## Publish lab
+## Publish your lab
 
-Before Azure Lab Services can create lab VMs for your lab, you first need to publish the lab. When you publish the lab, you need to specify the maximum number of lab VMs that Azure Lab Services creates. All VMs in the lab share the same configuration as the lab template.
+Before Azure Lab Services can create lab VMs for your lab, you need to publish the lab. When you publish the lab, specify the maximum number of lab VMs that Azure Lab Services creates. All VMs in the lab share the same configuration as the lab template.
 
 To publish the lab and create one lab VM:
 
 1. On the **Template** page, select **Publish** on the toolbar.
 
-   :::image type="content" source="./media/quick-create-connect-lab/template-page-publish-button.png" alt-text="Screenshot of Azure Lab Services template page. The Publish template menu button is highlighted."::: 
+   :::image type="content" source="./media/quick-create-connect-lab/template-page-publish-button.png" alt-text="Screenshot of Azure Lab Services template page. The Publish template menu button is highlighted." lightbox="./media/quick-create-connect-lab/template-page-publish-button.png":::
 
    > [!WARNING]
    > Publishing is an irreversible action, and can't be undone.
@@ -97,25 +98,25 @@ To publish the lab and create one lab VM:
 
 1. Wait until the publishing finishes. You can track the publishing status on the **Template** page.
 
-    :::image type="content" source="./media/quick-create-connect-lab/publish-template-progress.png" alt-text="Screenshot of Azure Lab Services template page.  The publishing in progress message is highlighted.":::  
+    :::image type="content" source="./media/quick-create-connect-lab/publish-template-progress.png" alt-text="Screenshot of Azure Lab Services template page. The publishing in progress message is highlighted." lightbox="./media/quick-create-connect-lab/publish-template-progress.png":::  
 
 1. On the **Virtual machine pool** page, confirm that there's one lab VM, named **Unassigned**, that is in the **Stopped** state.
 
-    :::image type="content" source="./media/quick-create-connect-lab/virtual-machines-stopped.png" alt-text="Screenshot that shows the list of virtual machines for the lab. The lab VM shows as unassigned and stopped.":::
+    :::image type="content" source="./media/quick-create-connect-lab/virtual-machines-stopped.png" alt-text="Screenshot that shows the list of virtual machines for the lab. The lab VM shows as unassigned and stopped." lightbox="./media/quick-create-connect-lab/virtual-machines-stopped.png":::
 
 ## Start and connect to lab VM
 
-After you publish the lab, you can now start the lab VM and connect to it by using remote desktop client software. In this quickstart, you use the lab VM yourself and you don't assign it to another user.
+After you publish the lab, you can start the lab VM and connect to it by using Remote Desktop. In this quickstart, you use the lab VM yourself. You don't assign it to another user.
 
 1. On the **Virtual machine pool** page, toggle the lab VM **State**, and then select **Start** to start the lab VM.
 
     Starting the lab VM can take a few minutes.
 
-    :::image type="content" source="./media/quick-create-connect-lab/virtual-machines-start.png" alt-text="Screenshot that shows how to start a lab VM by toggling the state in the list of virtual machines.":::
+    :::image type="content" source="./media/quick-create-connect-lab/virtual-machines-start.png" alt-text="Screenshot that shows how to start a lab VM by toggling the state in the list of virtual machines." lightbox="./media/quick-create-connect-lab/virtual-machines-start.png":::
 
 1. When the lab VM is in the **Running** state, select the **Connect** icon to download the remote desktop connection file to your computer.
 
-    :::image type="content" source="./media/quick-create-connect-lab/virtual-machines-connect.png" alt-text="Screenshot that shows how to get the connection details for the lab VM in the list of virtual machines.":::
+    :::image type="content" source="./media/quick-create-connect-lab/virtual-machines-connect.png" alt-text="Screenshot that shows how to get the connection details for the lab VM in the list of virtual machines." lightbox="./media/quick-create-connect-lab/virtual-machines-connect.png":::
 
 1. Open the downloaded remote desktop connection file to connect to the lab VM.
 
@@ -136,11 +137,11 @@ You can now explore and experiment within the lab virtual machine.
 
 [!INCLUDE [Troubleshoot region restriction](./includes/lab-services-troubleshoot-region-restriction.md)]
 
-## Next steps
+## Next step
 
-You've successfully created a lab virtual machine for experimenting inside the VM. You created a lab plan in the Azure portal and added a lab from the Azure Lab Services website. You then published the lab to create the lab VM, and connect to it with remote desktop.
+You created a lab virtual machine for experimenting inside the VM. You created a lab plan in the Azure portal and added a lab from the Azure Lab Services website. You published the lab to create the lab VM, and connected to it with Remote Desktop.
 
-Azure Lab Services supports different Microsoft Entra roles to delegate specific tasks and responsibilities to different people in your organization. In the next tutorial, you learn how to set up a lab for classroom teaching, where you assign permissions to lab creators and invite lab users to connect to the lab VMs.
+Azure Lab Services supports different Microsoft Entra roles to delegate specific tasks and responsibilities to different people in your organization. In the next tutorial, you learn how to set up a lab for classroom teaching. You assign permissions to lab creators and invite lab users to connect to the lab VMs.
 
 > [!div class="nextstepaction"]
 > [Tutorial: Create a lab for classroom training](./tutorial-setup-lab.md)