Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into iot-feb-21-release

Author: batamig

articles/devtest-labs/TOC.yml

@@ -55,8 +55,6 @@
       href: resource-group-control.md
     - name: Add support info to a lab
       href: devtest-lab-internal-support-message.md
-    - name: Set policies and schedules
-      href: devtest-lab-set-lab-policy.md
     - name: Configure lab identity 
       href: configure-lab-identity.md
     - name: Configure a lab to use a remote desktop gateway
@@ -67,7 +65,11 @@
       href: enable-browser-connection-lab-virtual-machines.md
     - name: Configure cost management
       href: devtest-lab-configure-cost-management.md
-    - name: Set auto startup for lab virtual machines
+    - name: Set lab policies and schedules
+      href: devtest-lab-set-lab-policy.md
+    - name: Configure auto-shutdown of lab VMs
+      href: devtest-lab-auto-shutdown.md
+    - name: Set auto startup for lab VMs
       href: devtest-lab-auto-startup-vm.md
     - name: Scale your lab
       href: devtest-lab-scale-lab.md
@@ -129,8 +131,6 @@
       href: devtest-lab-resize-vm.md
     - name: Redeploy a VM
       href: devtest-lab-redeploy-vm.md
-    - name: Configure autoshutdown of compute and lab VMs
-      href: devtest-lab-auto-shutdown.md
     - name: Create and manage claimable VMs
       href: devtest-lab-add-claimable-vm.md
     - name: Configure secrets

articles/devtest-labs/devtest-lab-configure-vnet.md

@@ -1,58 +1,71 @@
 ---
 title: Configure a virtual network
-description: Learn how to configure an existing virtual network and subnet, and use them in a VM with Azure DevTest Labs
+description: Learn how to configure an existing virtual network and subnet to use for creating virtual machines in Azure DevTest Labs.
 ms.topic: how-to
-ms.date: 06/26/2020
+ms.date: 02/15/2022
 ---
 
-# Configure a virtual network in Azure DevTest Labs
-As explained in the article [Add a VM to a lab](devtest-lab-add-vm.md), when you create a VM in a lab, you can specify a configured virtual network. 
-For example, you might need to access your corpnet resources from your VMs using the virtual network that was configured with ExpressRoute or site-to-site VPN.
+# Add a virtual network in Azure DevTest Labs
 
-This article explains how to add your existing virtual network into a lab's Virtual Network settings so that it is available to choose when creating VMs.
+In this article, you learn how to add a virtual network to a lab, and configure it for creating lab virtual machines (VMs).
 
-> [!NOTE]
-> To learn about costs associated with the Azure Virtual Network service, see [Pricing for Azure Virtual Network](../virtual-network/virtual-networks-overview.md#pricing).
+Azure DevTest Labs creates a new virtual network for each lab. If you have another virtual network, such as one configured with Azure ExpressRoute or site-to-site virtual private network (VPN), you can add it to your lab. You can then create lab VMs in that virtual network.
 
-## Configure a virtual network for a lab using the Azure portal
-The following steps walk you through adding an existing virtual network (and subnet) to a lab so that it can be used when creating a VM in the same lab. 
+## Add a virtual network to a lab
 
-1. Sign in to the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040).
-1. Select **All Services**, and then select **DevTest Labs** from the list.
-1. From the list of labs, select the desired lab. 
-1. On the lab's main pane, select **Configuration and policies**.
+To add a configured virtual network and subnet to a lab, take the following steps:
 
-    ![Access the lab's configuration and policies](./media/devtest-lab-configure-vnet/policies-menu.png)
-1. In the **EXTERNAL RESOURCES** section, select **Virtual networks**. A list of virtual networks configured for the current lab is displayed as well as the default virtual network created for your lab. 
-1. Select **+ Add**.
-   
-    ![Add an existing virtual network to your lab](./media/devtest-lab-configure-vnet/lab-settings-vnet-add.png)
-1. On the **Virtual network** pane, select **[Select virtual network]**.
+1. In the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040), on the **Overview** page for your lab, select **Configuration and policies** from the left navigation.
+
+   :::image type="content" source="./media/devtest-lab-configure-vnet/policies-menu.png" alt-text="Screenshot that shows the Configuration and policies menu for a lab.":::
+
+1. On the **Configuration and policies** page, in the left navigation under **External resources**, select **Virtual networks**.
+
+1. The **Virtual networks** page shows the lab's current virtual networks. Select **Add**.
 
-    ![Select an existing virtual network](./media/devtest-lab-configure-vnet/lab-settings-vnets-vnet1.png)
-1. On the **Choose virtual network** pane, select the desired virtual network. A list is displayed showing all of the virtual networks that are under the same region in the subscription as the lab.
-1. After selecting a virtual network, you are returned to the **Virtual network** pane. Select the subnet in the list at the bottom.
+   :::image type="content" source="./media/devtest-lab-configure-vnet/lab-settings-vnet-add.png" alt-text="Screenshot that shows a lab's Virtual networks page with Add selected.":::
+
+1. On the **Virtual network** page, select **Select virtual network**.
+
+   :::image type="content" source="./media/devtest-lab-configure-vnet/lab-settings-vnets-vnet1.png" alt-text="Screenshot that shows Select virtual network selected on the Virtual network page.":::
+
+1. The **Choose virtual network** page appears, showing all virtual networks in the subscription that are in the same region as the lab. Select the virtual network you want to add.
+
+   :::image type="content" source="./media/devtest-lab-configure-vnet/choose-virtual-network.png" alt-text="Screenshot that shows the Choose virtual network page with a list of virtual networks.":::
+
+1. The virtual network you chose shows on the **Virtual network** page. Select **Save**.
 
-    ![Subnet list](./media/devtest-lab-configure-vnet/lab-settings-vnets-vnet2.png)
-    
-    The Lab Subnet pane is displayed.
+1. The virtual network appears in the list on the lab's **Virtual networks** page. When the **Status** shows as **Ready**, select the new virtual network.
 
-    ![Lab subnet pane](./media/devtest-lab-configure-vnet/lab-subnet.png)
-     
-   - Specify a **Lab subnet name**.
-   - To allow a subnet to be used in lab VM creation, select **Use in virtual machine creation**.
-   - To enable a [shared public IP address](devtest-lab-shared-ip.md), select **Enable shared public IP**.
-   - To allow public IP addresses in a subnet, select **Allow public IP creation**.
-   - In the **Maximum virtual machines per user** field, specify the maximum VMs per user for each subnet. If you want an unrestricted number of VMs, leave this field blank.
-1. Select **OK** to close the Lab Subnet pane.
-1. Select **Save** to close the Virtual network pane.
+   :::image type="content" source="./media/devtest-lab-configure-vnet/lab-subnet.png" alt-text="Screenshot that shows the added virtual network on the lab's Virtual networks page.":::
 
-Now that the virtual network is configured, it can be selected when creating a VM. 
-    To see how to create a VM and specify a virtual network, refer to the article, [Add a VM to a lab](devtest-lab-add-vm.md). 
+1. The **Virtual network** page shows the subnets for the virtual network. Select a subnet to configure.
 
-Azure's [Virtual Network Documentation](../virtual-network/index.yml) provides more information about how to use VNets, including how to set up and manage a VNet and connect it to your on-premises network.
+1. On the **Lab Subnet** pane, select **Yes** or **No** under the following options:
 
-[!INCLUDE [devtest-lab-try-it-out](../../includes/devtest-lab-try-it-out.md)]
+   - **Use in virtual machine creation** to allow or disallow VM creation in the subnet.
+   - **Enable shared public IP** to enable or disable a [shared public IP address](devtest-lab-shared-ip.md).
+   - **Allow public IP creation** to allow or disallow creating public IP addresses in the subnet.
+
+1. Under **Maximum virtual machines per user**, enter the maximum number of VMs each user can create in the subnet. If you don't want to restrict the number of VMs, leave this field blank.
+
+1. Select **Save**.
+
+   :::image type="content" source="./media/devtest-lab-configure-vnet/lab-settings-vnets-vnet2.png" alt-text="Screenshot that shows the settings for the Lab subnet pane.":::
+
+1. On the **Virtual network** page, select **Save** again.
+
+## Create VMs in a virtual network
+
+If you allowed VM creation in one of the subnets, you can now create lab VMs in the added virtual network.
+
+1. Follow the instructions at [Create and add virtual machines](devtest-lab-add-vm.md) to add a lab VM and select a VM base.
+1. On the **Create lab resource** screen, select the **Advanced settings** tab.
+1. Select the drop-down arrow in the **Virtual network** field, and select the virtual network you added.
+1. If necessary, select the drop-down arrow in the **Subnet Selector** field, and select the subnet you want.
+1. Proceed with VM creation.
 
 ## Next steps
-Once you have added the desired virtual network to your lab, the next step is to [add a VM to your lab](devtest-lab-add-vm.md).
+
+- For more information about how to set up, use, and manage virtual networks, see the [Azure virtual network documentation](/azure/virtual-network/index.yml).
+- You can deploy [Azure Bastion](https://azure.microsoft.com/services/azure-bastion) in a new or existing virtual network to enable browser connection to your lab VMs. For more information, see [Enable browser connection to DevTest Labs VMs with Azure Bastion](enable-browser-connection-lab-virtual-machines.md).

articles/devtest-labs/devtest-lab-create-custom-image-from-vm-using-portal.md

@@ -1,42 +1,47 @@
 ---
-title: Create an Azure DevTest Labs custom image from a VM
-description: Learn how to create a custom image in Azure DevTest Labs from a provisioned VM using the Azure portal
+title: Create a custom image from a lab VM
+description: Learn how to create a custom image from a provisioned virtual machine in Azure DevTest Labs by using the Azure portal.
 ms.topic: how-to
-ms.date: 06/26/2020
+ms.date: 02/15/2022
 ---
 
 # Create a custom image from a VM
 
+In this article, you learn how to create a custom image from a provisioned Azure DevTest Labs virtual machine (VM).
+
 [!INCLUDE [devtest-lab-custom-image-definition](../../includes/devtest-lab-custom-image-definition.md)]
 
+The custom image includes the OS disk and all the data disks attached to the VM. Lab users can use the custom image to create identical provisioned lab VMs.
+
 ## Step-by-step instructions
 
-You can create a custom image from a provisioned VM, and afterwards use that custom image to create identical VMs. The following steps illustrate how to create a custom image from a VM:
+To create a custom image from a lab VM, take the following steps:
 
-1. Sign in to the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040).
+1. In the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040), on your lab's **Overview** page, select the VM to use for the image from the **My virtual machines** list.
 
-1. Select **All services**, and then select **DevTest Labs** from the list.
+   :::image type="content" source="./media/devtest-lab-create-custom-image-vm/overview-page.png" alt-text="Screenshot that shows a V M selected on a lab's Overview page.":::
 
-1. From the list of labs, select the desired lab.  
+1. On the VM's **Overview** page, select **Create custom image** under **Operations** in the left navigation.
 
-1. On the lab's main pane, select **My virtual machines**.
- 
-1. On the **My virtual machines** pane, select the VM from which you want to create the custom image.
+1. On the **Create custom image** page, enter a **Name** and optional **Description** for the custom image.
 
-1. On the VM's management pane, select **Create custom image** under **OPERATIONS**.
+1. Under **Image preparation**, select one of the following options:
 
-    :::image type="content" source="./media/devtest-lab-create-template/create-custom-image.png" alt-text="Create custom image menu item":::
-1. On the **Custom image** pane, enter a name and description for your custom image. This information is displayed in the list of bases when you create a VM. The custom image will include the OS disk and all the data disks attached to the virtual machine.
+   - **I have not generalized this virtual machine** if you haven't run [sysprep](/windows-hardware/manufacture/desktop/sysprep--system-preparation--overview) and don't want to run sysprep on the VM when creating the custom image.
+   - **I have already generalized this virtual machine** if you already ran sysprep on the VM.
+   - **Generalize this virtual machine (Run sysprep)** if you haven't run sysprep and you want sysprep to be run on the VM when creating the custom image.
 
-    :::image type="content" source="./media/devtest-lab-create-template/create-custom-image-blade.png" alt-text="Create custom image page":::
-1. Select whether sysprep was run on the VM. If the sysprep was not run on the VM, specify whether you want sysprep to be run on the VM when the custom image is created.
-1. Select **OK** when finished to create the custom image.
+1. Select **OK**.
 
-    After a few minutes, the custom image is created and is stored inside the lab’s storage account. When a lab user wants to create a new VM, the image is available in the list of base images.
+   :::image type="content" source="./media/devtest-lab-create-custom-image-vm/create-custom-image.png" alt-text="Screenshot that shows the Create custom image selection on a V M's Overview page.":::
 
-    :::image type="content" source="./media/devtest-lab-create-template/custom-image-available-as-base.png" alt-text="custom image available in list of base images":::
+The custom image is created and stored in the lab's storage account. The image is now available in the list of base images for creating a new lab VM.
 
+:::image type="content" source="./media/devtest-lab-create-custom-image-vm/custom-image-available-as-base.png" alt-text="Screenshot that shows custom images available in the list of VM base images.":::
 
 ## Next steps
 
 - [Add a VM to your lab](devtest-lab-add-vm.md)
+- [Create a custom image from a VHD file](devtest-lab-create-template.md)
+- [Compare custom images and formulas in DevTest Labs](devtest-lab-comparing-vm-base-image-types.md)
+- [Create a custom image factory in Azure DevTest Labs](image-factory-create.md)

articles/devtest-labs/devtest-lab-resize-vm.md

@@ -1,37 +1,49 @@
 ---
-title: Resize a VM in a lab
-description: Learn how to change the size of a virtual machine (VM) in Azure DevTest Labs based on your needs for CPU, network, or disk performance.
+title: Stop and resize lab VMs
+description: Learn how to change the size of a virtual machine (VM) in Azure DevTest Labs based on changing needs for CPU, network, or disk performance.
 ms.topic: how-to
-ms.date: 06/26/2020
+ms.date: 02/15/2022
 ---
 
-# Resize a VM in a lab in Azure DevTest Labs
-One of the important features of Azure virtual machines is that it lets you change the size of a virtual machine (VM) based on your needs for CPU, network, or disk performance. Azure DevTest Labs supports this feature for VMs in a lab now. The resize feature adheres to the lab policy for allowed VM sizes in the lab. That is, you can change the size of a VM to only allowed sizes in the lab. 
+# Resize a lab VM in Azure DevTest Labs
 
-
-## Steps to resize a VM in a lab 
-To resize a VM in a lab in Azure DevTest Labs, take the following steps: 
+Azure DevTest Labs supports changing the size of a lab virtual machine (VM), based on changing needs for CPU, network, or disk performance. This article describes how to resize a lab VM.
 
 > [!NOTE]
-> If you are connected to the VM via a remote desktop session (RDP), save your work, and disconnect from the VM before resizing it.
+> The resize feature complies with lab policy for [allowed VM sizes](devtest-lab-set-lab-policy.md#set-allowed-virtual-machine-sizes). You can resize a VM only to sizes that lab policy allows.
+
+## Stop the VM
+
+To avoid losing work, disconnect from and stop the VM before resizing it.
+
+1. If you're connected to the VM through secure shell (SSH) or remote desktop session (RDP), save your work and disconnect from the VM.
+
+1. In the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040), on your lab's **Overview** page, select the VM you want to resize from the list under **My virtual machines**.
+
+   :::image type="content" source="./media/devtest-lab-resize-vm/overview-page.png" alt-text="Screenshot that shows a V M selected on a lab's Overview page.":::
+
+1. On the VM's **Overview** page, select **Stop** on the toolbar. 
 
-1. Sign in to the [Azure portal](https://portal.azure.com).
-2. Select **All Services**, and then select **DevTest Labs** from the list.
-3. From the list of labs, select the lab that includes the VM  you want to resize.  
-4. In the left panel, select **My Virtual Machines**. 
-5. From the list of VMs, select a VM.
-6. Select **Stop** on the toolbar if the VM is running. Check the status of the operation in the **Notifications** window. Wait until the VM is stopped and then close the **Notifications** window. 
+   :::image type="content" source="./media/devtest-lab-resize-vm/stop-vm.png" alt-text="Screenshot that shows selecting Stop on the Overview page for a V M.":::
 
-    ![Stop the VM](media/devtest-lab-resize-vm/stop-vm.png)
-1. In the Virtual Machine page for your VM, select **Size** under **SETTINGS** in the left menu.
+Once the VM stops, or if the VM is already stopped, **Stop** is grayed out.
 
-    ![Size menu](media/devtest-lab-resize-vm/size-menu.png)
-1. In the **Choose a size** window, browse and select a size for your VM, and click **Select**.     
-1. Check the status of the resize operation in the **Notifications** window.
+## Resize the VM
 
-    ![Resize status](media/devtest-lab-resize-vm/resize-status.png)
-10. After the resize operation succeeds, close the **Notifications** window. 
-11. Select **Overview** in the left menu, and select **Restart** on the toolbar to restart the VM. 
+1. On the VM's **Overview** page, select **Size** under **Settings** in the left navigation.
+
+   :::image type="content" source="./media/devtest-lab-resize-vm/size-menu.png" alt-text="Screenshot that shows selecting Size in the V M's left navigation.":::
+
+1. On the **Select a VM size** screen, select a new size for your VM, and then select **Select**.
+
+   :::image type="content" source="./media/devtest-lab-resize-vm/select-size.png" alt-text="Screenshot that shows selecting a V M size.":::
+
+   You can check the status of the resize operation in the **Notifications** window.
+
+   :::image type="content" source="./media/devtest-lab-resize-vm/resize-status.png" alt-text="Screenshot of the Notifications window that shows resizing status.":::
+
+1. When the resize finishes, start the VM by selecting **Start** from the VM's **Overview** page toolbar.
 
 ## Next steps
-For detailed information about the resize feature supported by Azure virtual machines, see [Resize virtual machines](https://azure.microsoft.com/blog/resize-virtual-machines/).
+
+For more information about the resize feature for Azure VMs, see [Resize virtual machines](https://azure.microsoft.com/blog/resize-virtual-machines/).