edits

Author: v-thepet

articles/devtest-labs/add-artifact-vm.md

@@ -14,11 +14,11 @@ ms.custom: devx-track-azurepowershell, UpdateFrequency2
 
 This article describes how to add *artifacts* to Azure DevTest Labs virtual machines (VMs). Artifacts are tools, actions, or software you can add to lab VMs. For example, artifacts can run Windows PowerShell scripts or Bash commands, install tools or applications, or take other actions like joining a domain.
 
-DevTest Labs artifacts can come from the [public DevTest Labs Git repository](https://github.com/Azure/azure-devtestlab/tree/master/Artifacts) or from private Git repositories. Lab users can [create their own custom artifacts](devtest-lab-artifact-author.md) and store them in a repository, or use parameters to customize artifacts for their own needs.
+DevTest Labs artifacts can come from the [public DevTest Labs Git repository](https://github.com/Azure/azure-devtestlab/tree/master/Artifacts) or from private Git repositories. Lab users can [create their own custom artifacts](devtest-lab-artifact-author.md) and store them in a repository, and use parameters to customize existing artifacts for their own needs.
 
 A lab administrator can [add artifact repositories to a lab](add-artifact-repository.md) so all lab users can access them. Lab administrators can also [specify mandatory artifacts to be installed on all lab VMs](devtest-lab-mandatory-artifacts.md) at creation.
 
-You can't change or remove mandatory artifacts at VM creation time, but you can add and configure other available individual artifacts at or after creation time. This article describes how to add available artifacts to VMs by using the Azure portal or Azure PowerShell.
+You can't change or remove mandatory artifacts at VM creation time, but you can add and configure other available artifacts at or after VM creation time. This article describes how to add available artifacts to VMs by using the Azure portal or Azure PowerShell.
 
 ## Prerequisites
 
@@ -38,7 +38,7 @@ You can't change or remove mandatory artifacts at VM creation time, but you can
 ## Add artifacts to VMs
 
 # [Azure portal](#tab/portal)
-
+<a name="add-artifacts-to-vms-from-the-azure-portal"></a>
 You can use the Azure portal to add artifacts during VM creation or to add artifacts to an existing lab VM.
 
 ### Add artifacts during VM creation
@@ -54,12 +54,13 @@ You can use the Azure portal to add artifacts during VM creation or to add artif
 
 1. By default, artifacts install in the order you add them. To rearrange the order, select the ellipsis **...** next to the artifact in the **Selected artifacts** list, and select **Move up**, **Move down**, **Move to top**, or **Move to bottom**.
 
-   - To edit an artifact's parameters after you add it, select the pencil icon, or select **...** next to the artifact and select **Edit**, to reopen the **Add artifact** pane.
+   - To edit an artifact's parameters after you add it, select the pencil icon or select **...** next to the artifact and select **Edit** to reopen the **Add artifact** pane.
+
    - To delete an artifact from the **Selected artifacts** list, select **...** and then select **Delete**.
 
 1. When you're done adding, arranging, and configuring artifacts, select **OK** on the **Add artifacts** page.
 1. The **Artifacts** section of the **Create lab resource** screen shows the number of artifacts added. To add, edit, rearrange, or delete the artifacts before you create the VM, select **Add or Remove Artifacts** again.
-1. Optionally configure any **Advanced Settings** or **Tags**, and then select **Create** and **Create** again at the bottom of the **Create lab resource** screen to create the VM.
+1. Optionally configure any **Advanced Settings** or **Tags**, and then select **Create** and **Create** again at the bottom of the **Create lab resource** screen to create the VM with added artifacts.
 
 After you create the VM, the installed artifacts appear on the VM's **Artifacts** page. To see details about each artifact's installation, select the artifact name.
 

articles/devtest-labs/connect-virtual-machine-through-browser.md

@@ -1,19 +1,22 @@
 ---
-title: Connect to lab VMs through Bastion
-description: Learn how to connect to Azure DevTest Labs virtual machines (VMs) in a browser if Bastion is enabled for the lab.
+title: Connect to lab VMs through a browser
+description: Learn how to connect to Azure DevTest Labs virtual machines (VMs) through an internet browser if Bastion is enabled for the lab.
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
 ms.date: 03/24/2023
 ms.custom: UpdateFrequency2
+
+#customer intent: As a lab user, I want to connect to Bastion-enabled lab VMs through my browser, so I can connect securely without using public IP addresses or exposing RDP or SSH ports to the internet.
 ---
 
-# Connect to lab VMs in a browser via Azure Bastion
+# Connect to lab VMs through a browser via Azure Bastion
 
-This article describes how to connect to DevTest Labs virtual machines (VMs) through a browser by using [Azure Bastion](/azure/bastion/index). Bastion provides secure remote desktop protocol (RDP) or secure shell (SSH) access without using public IP addresses or exposing RDP or SSH ports to the internet.
+This article describes how to connect to your DevTest Labs virtual machines (VMs) through a browser by using [Azure Bastion](/azure/bastion/index). Bastion provides secure remote desktop protocol (RDP) or secure shell (SSH) access without using public IP addresses or exposing RDP or SSH ports to the internet.
 
 > [!IMPORTANT]
-> The lab must be in an Azure Bastion-configured virtual network that has Bastion connections enabled. For more information, see [Enable browser connection to DevTest Labs VMs with Azure Bastion](enable-browser-connection-lab-virtual-machines.md).
+> The VM and lab must be in an Azure Bastion-configured virtual network that has Bastion connections enabled. For more information, see [Enable browser connection to DevTest Labs VMs with Azure Bastion](enable-browser-connection-lab-virtual-machines.md).
+> You must have ownership or sign-in permissions on the VM.
 
 To connect to a lab VM through a browser:
 

articles/devtest-labs/devtest-lab-add-devtest-user.md

@@ -7,13 +7,14 @@ author: RoseHJM
 ms.date: 03/24/2025
 ms.custom: devx-track-azurepowershell, UpdateFrequency2
 
-#customer intent: As a lab owner, I want to add and configure users for my lab so I can grant only the access necessary to do specific lab tasks.
+#customer intent: As a lab owner, I want to add and configure users for my lab so I can grant the access necessary to do specific lab tasks.
 ---
 
-# Add and configure lab users in Azure DevTest Labs 
+# Add and configure lab users in Azure DevTest Labs
 
 Azure DevTest Labs uses Azure [role-based access control](/azure/role-based-access-control/overview) (RBAC) to define roles that have the access necessary to do specific lab tasks. DevTest Labs has three built-in roles: **Owner**, **Contributor**, and **DevTest Labs User**. This article describes the tasks each role can do, and how lab owners can add members to lab roles by using the Azure portal or an Azure PowerShell script.
 
+<a name="devtest-labs-user"></a>
 ## Owners, Contributors, and DevTest Labs Users
 
 The following table shows the actions that the DevTest Labs Owner, Contributor, and DevTest Labs User roles can take.
@@ -26,22 +27,19 @@ The following table shows the actions that the DevTest Labs Owner, Contributor,
 |Configure user settings and roles.|X|||
 |Update lab virtual machine (VM) policies.|X|X||
 |Update cost settings.|X|X||
-| | | | | |
 |VM base tasks:||||
 |Enable Marketplace images.|X|X||
 |Add, update, and delete VM base formulas.|X|X|X|
 |Add and remove custom images.|X|X||
 |Add, update, and delete formulas.|X|X||
-| | | | | |
 |Individual VM tasks:||||
 |Create VMs.|X|X|X|
-|Start, stop, or delete own VMs.|X|X|X|
+|Start, stop, or delete owned VMs.|X|X|X|
 |Add or remove VM data disks.|X|X|X|
-| | | | | |
 |Artifact and template tasks:||||
 |Add and remove lab artifact and template repositories.|X|X||
 |Create artifacts and templates.|X|X|X|
-|Apply artifacts to own VMs.|X|X|X|
+|Apply artifacts to owned VMs.|X|X|X|
 
 > [!NOTE]
 > Lab users automatically have the **Owner** role on VMs they create.
@@ -50,7 +48,7 @@ The following table shows the actions that the DevTest Labs Owner, Contributor,
 
 Azure permissions propagate from parent scope to child scope. Owners of an Azure subscription that contains labs are automatically Owners of the subscription's labs.
 
-Azure subscription [Owners](/azure/role-based-access-control/built-in-roles#owner) or [User Access Administrators](/azure/role-based-access-control/built-in-roles#user-access-administrator) can add Owners, Contributors, and DevTest Labs Users to labs in the subscription. To be added in a lab Owner role, users must have at least Contributor-level permissions in the Azure subscription.
+Azure subscription [Owners](/azure/role-based-access-control/built-in-roles#owner) or [User Access Administrators](/azure/role-based-access-control/built-in-roles#user-access-administrator) can add Owners, Contributors, and DevTest Labs Users to labs in the subscription. To be added as a lab Owner, users must have at least Contributor-level permissions in the Azure subscription.
 
 Users that are granted the lab Owner role can add and configure Owners, Contributors, and DevTest Labs Users for their own labs. However, added lab Owners have a narrower scope of administration than Azure subscription-based Owners. Added Owners don't have full access to some resources that the DevTest Labs service creates.
 
@@ -66,9 +64,9 @@ Lab Owners can add members to lab roles by using the Azure portal or an Azure Po
 
 - Lab Owner role, either by assignment from a subscription owner or by inheritance as a subscription owner.
 
-### Add a member:
+### Add a lab member
 
-The following procedure adds a **DevTest Labs User** member to a lab. If you're also a subscription owner, you can also do this procedure from the subscription's **Access control (IAM)** page.
+The following procedure adds a **DevTest Labs User** member to a lab. If you're an Owner of the Azure subscription the lab is in, you can also do this procedure from the subscription's **Access control (IAM)** page.
 
 1. On the lab's home page, select **Configuration and policies** from the left navigation.
 1. On the **Configuration and policies** page, select **Access control (IAM)** from the left navigation.
@@ -98,7 +96,7 @@ This PowerShell script requires the added user to be in the Microsoft Entra ID.
 
 ### Add a member
 
-The following PowerShell script adds a member to a lab with DevTest Labs User role. To use the script, update the parameter values under the `# Values to change` comment. You can get the `subscriptionId`, `labResourceGroup`, and `labName` values from the lab's main page in the Azure portal.
+The following PowerShell script adds a member to a lab with DevTest Labs User role. To use the script, replace the parameter values under the `# Values to change` comment with your own values. You can get the `subscriptionId`, `labResourceGroup`, and `labName` values from the lab's main page in the Azure portal.
 
 ```azurepowershell
 # Values to change
@@ -107,7 +105,7 @@ $labResourceGroup = "<Lab's resource group name>"
 $labName = "<Lab name>"
 $userDisplayName = "<User's display name>"
 
-# Log into your Azure account.
+# Sign into your Azure account.
 Connect-AzAccount
 
 # Select the Azure subscription that contains the lab. This step is optional if you have only one subscription.