edits

Author: v-thepet

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

@@ -4,14 +4,14 @@ 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/28/2025
+ms.date: 03/31/2025
 ms.custom: UpdateFrequency2
 
-#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.
+#customer intent: As a lab user, I want to create lab VM custom images by using VHD files, so I can provide a variety of images to lab users for creating VMs.
 
 ---
 
-# Create a custom image for Azure DevTest Labs virtual machines from VHD files
+# Create a custom image for an Azure DevTest Labs virtual machine from a VHD file
 
 [!INCLUDE [devtest-lab-create-custom-image-from-vhd-selector](../../includes/devtest-lab-create-custom-image-from-vhd-selector.md)]
 
@@ -41,13 +41,13 @@ To create a custom image for DevTest Labs from a VHD or VHDX file, follow these
      - If you choose **Linux**, select the checkbox if you ran **deprovision** on the machine when you created the VHD file.
    - **VHD Generation**: Select whether you have a **V1** (VHD) or **V2** (VHDX) file.
    - **VHD**: Select the uploaded VHD file for the custom image from the dropdown menu.
-   - **Plan name,** **Plan offer**, and **Plan publisher**: If the VHD isn't a licensed image published by Microsoft, optionally enter the name of the Marketplace image or SKU used to create the VHD, product or offer name, and plan publisher. If the image is a licensed image, these fields are prepopulated with the plan information.
+   - **Plan name,** **Plan offer**, and **Plan publisher**: If the VHD isn't a licensed image published by Microsoft, optionally enter the name of the Marketplace image or SKU used to create the VHD, a product or offer name, and the plan publisher. If the image is a licensed image, these fields are prepopulated with the plan information.
 
 1. Select **OK**.
 
    :::image type="content" source="media/devtest-lab-create-template/create-custom-image.png" alt-text="Screenshot that shows the Custom image page.":::
 
-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.
+After creation, the custom image is stored in the lab's storage account. The image appears on the lab **Custom images** page and on the list of VM base images for the lab. Lab users can create new VMs based on the custom image.
 
 :::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.":::
 

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

@@ -4,7 +4,7 @@ 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/28/2025
+ms.date: 03/31/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.
@@ -14,43 +14,45 @@ ms.custom: UpdateFrequency2
 
 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:
 
-- Allowed virtual machine (VM) sizes
-- Maximum VMs per user
-- Maximum VMs per lab
-- Autoshutdown
-- Autostart
-- Autoshutdown policy
+- [Allowed virtual machine (VM) sizes](#allowed-virtual-machine-sizes)
+- [Maximum VMs per user](#virtual-machines-per-user)
+- [Maximum VMs per lab](#virtual-machines-per-lab)
+- [Autoshutdown schedule](#autoshutdown)
+- [Autostart schedule](#autostart)
+- [Autoshutdown policy](#autoshutdown-policy)
 
 ## Prerequisites
 
 **Contributor** or **Owner** level permissions in the lab.
 
 ## Set lab policies
 
-To set lab policies, on your lab page in the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040), select **Configuration and policies** from the left navigation.
+To set lab policies:
 
-:::image type="content" source="./media/devtest-lab-set-lab-policy/configuration-policies-menu.png" alt-text="Screenshot that shows the Configuration and policies menu for a lab.":::
+1. On your lab page in the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040), select **Configuration and policies** from the left navigation.
 
-On the **Configuration and policies** page, select the policy you want to configure from the **Settings** and **Schedules** sections of the left navigation.
+   :::image type="content" source="./media/devtest-lab-set-lab-policy/configuration-policies-menu.png" alt-text="Screenshot that shows the Configuration and policies menu for a lab.":::
 
-:::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.":::
+1. On the **Configuration and policies** page, select the policy you want to configure from the **Settings** and **Schedules** sections of the left navigation.
+
+   :::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.
+This policy limits the VM sizes that users can create in the lab. The default policy setting is **All sizes**.
 
 1. On the lab's **Configuration and policies** page, select **Allowed virtual machines sizes** from the left navigation.
 1. On the **Allowed virtual machines sizes** page, select **All sizes** or **Selected sizes**.
 1. If you select **Selected sizes**, select the VM sizes to allow users to create in the lab.
 1. Select **Save**.
 
-   :::image type="content" source="./media/devtest-lab-set-lab-policy/allowed-vm-sizes.png" alt-text="Screenshot showing Allowed VM sizes.":::
+:::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.
+This policy specifies the maximum number of VMs and VMs using premium disks that an individual lab user can claim or create. The default policy setting is **Off**.
 
 1. On the lab's **Configuration and policies** page, select **Virtual machines per user** from the left navigation.
 1. On the **Virtual machines per user** page, under **Limit the number of virtual machines**, select **On** or **Off** to enable or disable the policy.
@@ -59,15 +61,15 @@ This policy specifies the maximum number of VMs that an individual lab user can
 1. If you select **On**, enter the maximum number of VMs using premium solid-state disks (SSDs) that a user can claim or create. This number applies only to Premium SSDs, not Standard SSDs.
 1. Select **Save**.
 
-   :::image type="content" source="./media/devtest-lab-set-lab-policy/max-vms-per-user.png" alt-text="Screenshot showing Virtual machines per user.":::
+:::image type="content" source="./media/devtest-lab-set-lab-policy/max-vms-per-user.png" alt-text="Screenshot showing Virtual machines per user.":::
 
 If a user tries to create or claim a VM after the user limit is met, an error message indicates that the user can't exceed their VM limit.
 
 :::image type="content" source="./media/devtest-lab-set-lab-policy/error.png" alt-text="Screenshot showing the error that the user can't exceed their VM limit.":::
 
 ### Virtual machines per lab
 
-This policy specifies the maximum number of VMs that all users can create in the current lab.
+This policy specifies the maximum number of VMs that all users can create in the current lab. The default policy setting is **Off**.
 
 1. On the lab's **Configuration and policies** page, select **Virtual machines per lab** from the left navigation.
 1. On the **Virtual machines per lab** page, under **Limit the number of virtual machines**, select **On** or **Off** to enable or disable the policy.
@@ -76,14 +78,14 @@ This policy specifies the maximum number of VMs that all users can create in the
 1. If you selected **On**, enter the maximum number of VMs in the lab that can use premium SSDs.
 1. Select **Save**.
 
-   :::image type="content" source="./media/devtest-lab-set-lab-policy/max-vms-per-lab.png" alt-text="Screenshot showing VMs per lab.":::
+:::image type="content" source="./media/devtest-lab-set-lab-policy/max-vms-per-lab.png" alt-text="Screenshot showing VMs per lab.":::
 
 If a user tries to create or claim a VM after the lab limit is met, an error message indicates that the VM can't be created or claimed.
 
 <a name="set-auto-shutdown"></a>
 ### Autoshutdown
 
-Autoshutdown helps minimize lab waste by shutting down lab VMs at a specific time of day.
+Autoshutdown helps minimize lab waste by shutting down lab VMs at a specific time of day. The default policy setting is **Off**.
 
 1. On the lab's **Configuration and policies** page, select **Auto-shutdown** from the left navigation.
 1. On the **Auto-shutdown** page, select **On** or **Off** to enable or disable the policy.
@@ -92,9 +94,9 @@ Autoshutdown helps minimize lab waste by shutting down lab VMs at a specific tim
 1. If you choose **Yes**, enter a webhook URL endpoint under **Webhook URL** or semicolon-separated email addresses under **Email address** to post or send the notification.
 1. Select **Save**.
 
-   :::image type="content" source="./media/devtest-lab-set-lab-policy/auto-shutdown.png" alt-text="Screenshot showing Auto shutdown.":::
+:::image type="content" source="./media/devtest-lab-set-lab-policy/auto-shutdown.png" alt-text="Screenshot showing Auto shutdown.":::
 
-By default, autoshutdown applies to all lab VMs. If allowed by [autoshutdown policy](#autoshutdown-policy), lab users can override lab autoshutdown settings for their own lab VMs as follows:
+By default, autoshutdown applies to all lab VMs. If allowed by [autoshutdown policy](#autoshutdown-policy), lab users can override lab autoshutdown settings for their own individual lab VMs as follows:
 
 1. Select the VM from **My virtual machines** on the lab **Overview** page.
 1. On the home page for the VM, select **Auto-shutdown** from the **Operations** section of the left navigation.
@@ -104,33 +106,33 @@ For more information about autoshutdown and sending notifications, see [Configur
 <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.
+Autostart policy helps you minimize waste by specifying a specific time of day and days of the week to start up lab VMs. The default policy setting is **No**.
 
-> [!NOTE]
+> [!IMPORTANT]
 > This policy isn't automatically applied to lab VMs. To apply this setting to VMs, open the VM's page and change its **Auto-start** setting.
 
 1. On the lab's **Configuration and policies** page, select **Auto-start** from the left navigation.
 1. Select **Yes** or **No** to enable or disable the policy.
 1. If you select **Yes**, specify the **Scheduled start**, **Time zone**, and **Days of the week** to start up the lab VMs.
 1. Select **Save**.
 
-   :::image type="content" source="./media/devtest-lab-set-lab-policy/auto-start.png" alt-text="Screenshot showing the Autostart selection.":::
+:::image type="content" source="./media/devtest-lab-set-lab-policy/auto-start.png" alt-text="Screenshot showing the Autostart selection.":::
 
 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.
+If you set an autoshutdown schedule 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.
 
 > [!IMPORTANT]
 > Autoshutdown policy changes apply only to new lab VMs, not to already-existing VMs.
 
 1. On the lab's **Configuration and policies** page, select **Auto shutdown policy** from the left navigation.
 1. Select one of the following options:
 
-   - **User sets a schedule and can opt out**: Lab users can override or opt out of lab autoshutdown. Lab users can override the lab schedule, and they don't have to set any autoshutdown for their VMs. This setting is the default.
-   - **User sets a schedule and cannot opt out**: Lab users can override the lab schedule for their VMs, but they can't opt out of autoshutdown. This option ensures that every VM in the lab is on some autoshutdown schedule.
+   - **User sets a schedule and can opt out**: Lab users can override or opt out of lab autoshutdown. Lab users can override the lab schedule times, and they don't have to set any autoshutdown for their VMs. This setting is the default.
+   - **User sets a schedule and cannot opt out**: Lab users can override the lab shutdown schedule for their VMs, but they can't opt out of autoshutdown. This option ensures that every VM in the lab is on some autoshutdown schedule.
    - **User has no control over the schedule set by lab administrator**: Lab users can't override or opt out of the lab autoshutdown schedule. They can set up autoshutdown notifications for their own VMs.
 
 1. Select **Save**.