some acrolinx & fixes

Author: v-thepet

articles/devtest-labs/devtest-lab-create-template.md

@@ -4,10 +4,11 @@ description: Use the Azure portal to create an Azure DevTest Labs virtual machin
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 03/26/2025
+ms.date: 03/28/2025
 ms.custom: UpdateFrequency2
 
-#customer intent: As a lab user, I want to add artifacts to my VMs so I can use them to run scripts or commands, install tools or applications, or take other actions on my VMs.
+#customer intent: As a lab user, I want to create lab VM custom images by using VHD files, so I can easily provide a variety of images to lab users for creating VMs.
+
 ---
 
 # Create a custom image for Azure DevTest Labs virtual machines from VHD files
@@ -48,9 +49,9 @@ To create a custom image for DevTest Labs from a VHD or VHDX file, follow these
 
 After creation, the custom image is stored in the lab's storage account, and appears in the list of VM base images for the lab. Lab users can create new VMs based on the custom image.
 
-![Screenshot that shows the Custom images available in the list of base images.](media/devtest-lab-create-template/custom-image-available-as-base.png)
+:::image type="content" source="media/devtest-lab-create-template/custom-image-available-as-base.png" alt-text="Screenshot that shows the Custom images available in the list of base images.":::
 
-## Next steps
+## Related content
 
 - [Add a VM to your lab](devtest-lab-add-vm.md)
 - [Compare custom images and formulas in DevTest Labs](devtest-lab-comparing-vm-base-image-types.md)

articles/devtest-labs/devtest-lab-set-lab-policy.md

@@ -4,15 +4,16 @@ description: Learn how to define lab policies such as VM sizes, maximum VMs per
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 03/27/2025
+ms.date: 03/28/2025
 ms.custom: UpdateFrequency2
+
+#customer intent: As a lab administrator, I want to be able to set policies like allowed numbers of VMs per user and shutdown schedules, so I can control lab costs and improve manageability.
 ---
 
 # Manage lab policies in Azure DevTest Labs
 
-This article describes how Azure DevTest Labs administrators can manage lab policies to control lab costs, minimize waste, and improve managability. Lab policies include:
+This article describes how Azure DevTest Labs administrators can manage lab policies to control lab costs, minimize waste, and improve manageability. Lab policies you can set include:
 
-- Internal support
 - Allowed virtual machine (VM) sizes
 - Maximum VMs per user
 - Maximum VMs per lab
@@ -22,7 +23,7 @@ This article describes how Azure DevTest Labs administrators can manage lab poli
 
 ## Prerequisites
 
-**Contributor** or **Owner** level permissions to the lab.
+**Contributor** or **Owner** level permissions in the lab.
 
 ## Set lab policies
 
@@ -34,6 +35,7 @@ On the **Configuration and policies** page, select the policy you want to config
 
 :::image type="content" source="./media/devtest-lab-set-lab-policy/policies-menu.png" alt-text="Screenshot that shows a lab's Configuration and Policies options.":::
 
+<a name="set-allowed-virtual-machine-sizes"></a>
 ### Allowed virtual machine sizes
 
 This policy specifies the VM sizes that users can create in the lab.
@@ -45,6 +47,7 @@ This policy specifies the VM sizes that users can create in the lab.
 
    :::image type="content" source="./media/devtest-lab-set-lab-policy/allowed-vm-sizes.png" alt-text="Screenshot showing Allowed VM sizes.":::
 
+<a name="set-virtual-machines-per-user"></a>
 ### Virtual machines per user
 
 This policy specifies the maximum number of VMs that an individual lab user can claim or create.
@@ -98,6 +101,7 @@ By default, autoshutdown applies to all lab VMs. If allowed by [autoshutdown pol
 
 For more information about autoshutdown and sending notifications, see [Configure autoshutdown for labs and VMs in DevTest Labs](devtest-lab-auto-shutdown.md).
 
+<a name="set-autostart"></a>
 ### Autostart
 
 Autostart policy helps you minimize waste by specifying a specific time of day and days of the week to start up lab VMs.
@@ -114,6 +118,7 @@ Autostart policy helps you minimize waste by specifying a specific time of day a
 
 For more information and details about autostart policy, see [Start up lab virtual machines automatically](devtest-lab-auto-startup-vm.yml).
 
+<a name="set-auto-shutdown-policy"></a>
 ### Autoshutdown policy
 
 If you set autoshutdown for lab VMs, you can also set a policy to let lab users override the lab autoshutdown settings for their own VMs. You can set autoshutdown policy to allow lab users full control, partial control, or no control over their own VMs' autoshutdown activity.

articles/devtest-labs/media/devtest-lab-set-lab-policy/configuration-policies-menu.png

@@ -1,29 +1,31 @@
 ---
 title: Azure PowerShell Samples
-description: Use these Azure PowerShell scripts for DevTest Labs activities like adding lab users, creating and assigning custom lab roles, and allowing specific lab VM sizes and Marketplace images.
+description: Use these Azure PowerShell scripts for DevTest Labs activities like adding lab users, creating custom lab roles, and allowing specific lab VM sizes and Marketplace images.
 ms.topic: sample
 ms.custom: devx-track-azurepowershell, UpdateFrequency2
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 03/27/2025
+ms.date: 03/28/2025
+
+#customer intent: As a lab administrator, I want to run Azure PowerShell scripts to add users, roles, VM sizes, and Marketplace images, so I can easily customize the lab to meet our needs.
 ---
 
-# Azure PowerShell samples for Azure Lab Services
+# Azure PowerShell samples for Azure DevTest Labs
 
 This article includes the following sample Azure PowerShell scripts for Azure DevTest Labs:
 
 - [Add an external user to a lab](#add-an-external-user-to-a-lab)
-- [Create a custom role in a lab](#create-a-custom-role-in-a-lab)
-- [Set allowed virtual machine (VM) sizes for a lab](#set-allowed-virtual-machine-sizes)
+- [Create and assign a custom role in a lab](#create-and-assign-a-custom-lab-user-role)
+- [Set allowed virtual machine (VM) sizes for a lab](#set-allowed-vm-sizes)
 - [Add Marketplace images to a lab](#add-a-marketplace-image-to-a-lab)
 - [Create a custom image from a virtual hard drive (VHD)](#create-a-custom-image-from-a-vhd-file)
 
 ## Prerequisites
 
-- Adding or assigning users or roles requires **Owner** role in a lab, or **Owner** or **User Access Administrator** role in the Azure subscription that contains the lab.
-- Setting allowed lab VM sizes, adding a Marketplace image, or creating a custom image require at least **Contributor** role in the lab or the Azure subscription.
-- Azure PowerShell. You can use [Azure Cloud Shell](/azure/cloud-shell/quickstart) or [install PowerShell locally](/powershell/azure/install-azure-powershell).
-  - In Cloud Shell, select the **PowerShell** experience.
+- To add or assign users or roles: **Owner** role in a lab, or **Owner** or **User Access Administrator** role in the Azure subscription that contains the lab.
+- To set allowed lab VM sizes, add a Marketplace image, or create a custom image: At least **Contributor** role in the lab or the Azure subscription.
+- All scripts require Azure PowerShell. You can use [Azure Cloud Shell](/azure/cloud-shell/quickstart) or [install PowerShell locally](/powershell/azure/install-azure-powershell).
+  - In Cloud Shell, select the **PowerShell** environment.
   - For a local PowerShell installation, run `Update-Module -Name Az` to get the latest version of Azure PowerShell, and run [Connect-AzAccount](/powershell/module/az.accounts/connect-azaccount) to sign in to Azure. If you have multiple Azure subscriptions, use `Set-AzContext -SubscriptionId "<SubscriptionId>"` to provide the subscription ID you want to use.
 
 ## Add an external user to a lab
@@ -52,14 +54,14 @@ Select-AzSubscription -SubscriptionId $subscriptionId
 # Get the user object.
 $adObject = Get-AzADUser -SearchString $userDisplayName
 
-# Assigns the role. 
+# Assign the role. 
 $labId = ('/subscriptions/' + $subscriptionId + '/resourceGroups/' + $labResourceGroup + '/providers/Microsoft.DevTestLab/labs/' + $labName)
 New-AzRoleAssignment -ObjectId $adObject.Id -RoleDefinitionName 'DevTest Labs User' -Scope $labId
 ```
 
 ## Create and assign a custom lab user role
 
-This sample PowerShell script creates a custom role that allows lab users to modify lab policies, and assigns the new role to an external user.  The user to assign must be in the organization's Microsoft Entra ID.
+This sample PowerShell script creates a custom role that allows lab users to modify lab policies, and assigns the new role to an external user. The user to assign must be in the organization's Microsoft Entra ID.
 
 To use the script, replace the parameter values under the `# Values to change` comment with your own values. You can get the `subscriptionId`, `rgName`, and `labName` values from the lab's main page in the Azure portal.
 
@@ -365,7 +367,7 @@ Set-PolicyChanges $lab $policyChanges
 
 ## Create a custom image from a VHD file
 
-This sample PowerShell script creates a custom image in DevTest Labs from a Windows VHD file. The script requires a VHD file to be uploaded to the Azure Storage account for the lab.
+This sample PowerShell script creates a custom image in DevTest Labs from a VHD file. The script requires a Windows VHD file to be uploaded to the Azure Storage account for the lab.
 
 To use the script, replace the parameter values under the `# Values to change` comment with your own values. You can get the `subscriptionId`, `labRg`, and `labName` values from the lab's main page in the Azure portal. Get the `vhdUri` value from the Azure Storage container where you uploaded the VHD file.
 
@@ -382,9 +384,9 @@ This script uses the following commands:
 $subscriptionId = '<Azure subscription ID>'
 $labRg = '<Lab resource group name>'
 $labName = '<Lab name>'
-$vhdUri = '<VHD URI>'
+$vhdUri = '<URI for the uploaded VHD>'
 $customImageName = '<Name for the custom image>'
-$customImageDescription = '<Description for the custom image'
+$customImageDescription = '<Description for the custom image>'
 
 # Select the Azure subscription. 
 Select-AzSubscription -SubscriptionId $subscriptionId

articles/devtest-labs/samples-powershell.md

@@ -4,10 +4,10 @@ description: Learn how to claim, unclaim, delete, and connect to a DevTest Labs
 ms.topic: tutorial
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 03/26/2025
+ms.date: 03/28/2025
 ms.custom: UpdateFrequency2
 
-#customer intent: As a lab user, I want to be able to claim ownership and connect to lab VMs so I can use available VMs to do my work.
+#customer intent: As a lab user, I want to be able to claim ownership and connect to lab VMs, so I can use preconfigured VMs to do my work.
 ---
 
 # Claim and connect to a DevTest labs VM
@@ -53,7 +53,7 @@ To connect to a VM, it must be running. An unclaimed claimable VM is stopped. Wh
 
    :::image type="content" source="./media/tutorial-use-custom-lab/my-virtual-machines.png" alt-text="Screenshot of VM under My virtual machines.":::
 
-1. If available, select **Connect via Bastion** from the context menu. In the **Connect via Bastion** pane, select whether to open the VM in a new window, enter the VM username and password, and then select **Connect**..
+1. If available, select **Connect via Bastion** from the context menu. In the **Connect via Bastion** pane, select whether to open the VM in a new window, enter the VM username and password, and then select **Connect**.
 1. If **Connect via Bastion** isn't available:
    - For a Windows VM, select **Connect via RDP**, and follow instructions at [Connect to a Windows VM in your lab](connect-windows-virtual-machine.md).
    - For a Linux VM, select **Connect via Azure CLI** or **Connect via Native SSH**, and follow instructions at [Connect to a Linux VM in your lab](connect-linux-virtual-machine.md).
@@ -81,7 +81,7 @@ After you're done using the VM, you can unclaim it so someone else can claim it,
 
 ## Delete a lab VM
 
-When you're done using a VM, you can delete it unless someone else has claimed it. To delete an individual lab VM, follow these steps:
+When you're done using a VM, you can delete it unless someone else claims it. To delete an individual lab VM, follow these steps:
 
 1. Select the ellipsis **...** next to the VM in the **My virtual machines** list or on the **Claimable virtual machines** page, and select **Delete** from the context menu.
 1. On the **Are you sure you want to delete it** page, select **Delete**.