edits

Author: v-thepet

articles/devtest-labs/devtest-lab-attach-detach-data-disk.md

@@ -4,7 +4,7 @@ description: Learn how to use the Azure portal to attach or detach a data disk f
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 03/14/2025
+ms.date: 03/17/2025
 ms.custom: UpdateFrequency2
 
 #customer intent: As a lab user, I want to attach and detach data disks for my DevTest Labs VMs so I can manage storage or software separately from individual VMs.
@@ -76,17 +76,17 @@ Follow these steps to detach an attached data disk from a running VM.
 
    :::image type="content" source="./media/devtest-lab-attach-detach-data-disk/devtest-lab-detach-button.png" alt-text="Screenshot of selecting a data disk to detach.":::
 
-1. On the data disk's page, select **Detach**, and at **Are you sure you want to detach it**, select **OK**.
+1. On the data disk's page, select **Detach**, and respond **OK** to **Are you sure you want to detach it**.
 
    :::image type="content" source="./media/devtest-lab-attach-detach-data-disk/devtest-lab-detach-data-disk-2.png" alt-text="Screenshot showing Detach on the Data disk page.":::
 
-The disk is detached, and is available to reattach to this or another VM. 
+The disk detaches, and is available to reattach to this or another VM. 
 
-### Detach or delete a data disk on the lab management page
+### Detach or delete a data disk from the lab page
 
-You can also detach or delete a data disk from the lab's page.
+You can also detach or delete a data disk from the lab's page instead of the VM's page.
 
-1. On the lab **Overview** page in the Azure portal, select **My data disks** under **My Lab** from the left navigation.
+1. On the lab **Overview** page in the Azure portal, select **My data disks** under **My Lab** in the left navigation.
 
 1. On the **My data disks** page, either:
 
@@ -96,7 +96,7 @@ You can also detach or delete a data disk from the lab's page.
 
    :::image type="content" source="./media/devtest-lab-attach-detach-data-disk/devtest-lab-detach-data-disk.png" alt-text="Screenshot of detaching a data disk from the listing's context menu.":::
 
-To delete a detached data disk, select **Delete** from the context menu on the **My data disks** page, or from the disk's page. Deleting a data disk removes it from storage, and you can no longer reattach it.
+To delete a detached data disk, select **Delete** from the context menu on the **My data disks** page, or select **Delete** on the disk's page. Deleting a data disk removes it from storage, and you can no longer reattach it.
 
 ## Related content
 

articles/devtest-labs/devtest-lab-concepts.md

@@ -4,10 +4,10 @@ description: Learn about some basic Azure DevTest Labs concepts related to labs,
 ms.topic: conceptual
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 03/14/2025
+ms.date: 03/17/2025
 ms.custom: UpdateFrequency2
 
-#customer intent: As a lab user or administrator, I want to understand basic DevTest Labs concepts so I know how I can create, manage, and use labs, VMs, environments, and templates.
+#customer intent: As a lab user or administrator, I want to understand basic DevTest Labs concepts so I can create, manage, or use labs, VMs, and environments.
 ---
 
 # DevTest Labs concepts
@@ -20,8 +20,8 @@ A DevTest Labs lab is the infrastructure that encompasses a group of resources s
 
 - Add and configure lab users.
 - Create ready-made VMs for lab users to claim and use.
-- Create and use templates to create and configure labs, VMs, and environments.
-- Connect artifact and template repositories to the lab.
+- Create and use Azure Resource Manager (ARM) templates to create and configure labs, VMs, and environments.
+- Connect artifact and template source control repositories to the lab.
 - Let users create and configure their own lab VMs and environments.
 - Specify allowed virtual machine (VM) limits, sizes, and configurations.
 - Set autoshutdown and autostartup policies.
@@ -49,9 +49,11 @@ Lab policies help control costs and reduce waste. For example, policies can auto
 
 ## Templates
 
+You can use ARM templates to create and update DevTest Labs labs, environments, VMs, and artifacts.
+
 [!INCLUDE [About Azure Resource Manager](~/reusable-content/ce-skilling/azure/includes/resource-manager-quickstart-introduction.md)] For more information about ARM template structure and properties, see [Template format](/azure/azure-resource-manager/templates/syntax#template-format).
 
-You can use ARM templates to create and update DevTest Labs labs, environments, VMs, and artifacts, or for automation. For more information, see:
+For more information about using ARM templates in DevTestLabs, see:
 
 - [Create labs from ARM templates](create-lab-windows-vm-template.md)
 - [Create environments from ARM templates](devtest-lab-create-environment-from-arm.md)
@@ -65,7 +67,9 @@ Lab administrators can also store custom artifacts and ARM templates in private
 
 ## Virtual machines
 
-You can use templates, artifacts, custom images, and formulas to create and manage DevTest Labs VMs. Azure VMs are [on-demand, scalable computing resources](/azure/architecture/guide/technology-choices/compute-decision-tree) that give you the flexibility of virtualization without having to buy and maintain the physical hardware to run it. For more information about Azure VMs, see [Windows virtual machines in Azure](/azure/virtual-machines/windows/overview). 
+You can use templates, artifacts, custom images, and formulas to create and manage DevTest Labs VMs.
+
+Azure VMs are [on-demand, scalable computing resources](/azure/architecture/guide/technology-choices/compute-decision-tree) that give you the flexibility of virtualization without having to buy and maintain the physical hardware to run it. For more information about Azure VMs, see [Windows virtual machines in Azure](/azure/virtual-machines/windows/overview). 
 
 ### Base images
 
@@ -101,6 +105,6 @@ For more information about custom images and formulas, see [Compare custom image
 
 ## Environments
 
-A DevTest Labs environment is a collection of Azure platform-as-a-service (PaaS) resources, such as an Azure Web App or a SharePoint farm, that's defined by an Azure Resource Manager (ARM) template. Lab administrators can add public or privately created environment tamplates to labs, and lab users can use them to quickly create environments. For more information, see [Use ARM templates to create DevTest Labs environments](devtest-lab-create-environment-from-arm.md).
+A DevTest Labs environment is a collection of Azure platform-as-a-service (PaaS) resources, such as an Azure Web App or a SharePoint farm, that's defined by an ARM template. Lab administrators can add public or privately created environment tamplates to labs, and lab users can use them to quickly create environments. For more information, see [Use ARM templates to create DevTest Labs environments](devtest-lab-create-environment-from-arm.md).
 
 [!INCLUDE [devtest-lab-try-it-out](../../includes/devtest-lab-try-it-out.md)]

articles/devtest-labs/use-command-line-start-stop-virtual-machines.md

@@ -1,10 +1,10 @@
 ---
-title: Start and stop lab VMs with command lines
+title: Use commands to start and stop lab VMs
 description: Use Azure PowerShell or Azure CLI command lines and scripts to start and stop Azure DevTest Labs virtual machines (VMs).
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 03/14/2025
+ms.date: 03/17/2025
 ms.custom: devx-track-azurepowershell, devx-track-azurecli, UpdateFrequency2 
 ms.devlang: azurecli
 
@@ -19,23 +19,34 @@ This article shows how you can use PowerShell or Azure CLI commands to script or
 - Turn off your VMs to save costs when they meet custom criteria.
 - Start and stop a VM when a continuous integration and continuous delivery (CI/CD) workflow begins and finishes. For an example of this workflow, see [Run an image factory from Azure DevOps](image-factory-set-up-devops-lab.md).
 
-You can also use the Azure portal to start, stop, or [restart](devtest-lab-restart-vm.md) DevTest Labs VMs. Lab admins can use the portal to configure [automatic startup](devtest-lab-auto-startup-vm.yml) and [automatic shutdown](devtest-lab-auto-shutdown.md) schedules and policies for lab VMs.
+>[!NOTE]
+>You can also use the Azure portal to start, stop, or [restart](devtest-lab-restart-vm.md) DevTest Labs VMs. Lab admins can use the portal to configure [automatic startup](devtest-lab-auto-startup-vm.yml) and [automatic shutdown](devtest-lab-auto-shutdown.md) schedules and policies for lab VMs.
 
 ## Prerequisites
 
+# [Azure PowerShell](#tab/PowerShell)
+
+- Ownership of a [lab VM in DevTest Labs](devtest-lab-add-vm.md).
 - Access to Azure PowerShell. You can [use Azure Cloud Shell](/azure/cloud-shell/quickstart?tabs=powershell) in the Azure portal, or [install Azure PowerShell](/powershell/azure/install-azure-powershell) locally. If necessary, run `Update-Module -Name Az` to update your local installation.
 
+# [Azure CLI](#tab/CLI)
+
 - Ownership of a [lab VM in DevTest Labs](devtest-lab-add-vm.md).
-- Access to Azure CLI. You can [use Azure Cloud Shell](/azure/cloud-shell/quickstart?tabs=powershell) in the Azure portal, or install [Azure CLI ](/cli/azure/install-azure-cli) locally.
+- Access to Azure CLI. You can [use Azure Cloud Shell](/azure/cloud-shell/quickstart?tabs=powershell) in the Azure portal, or [install Azure CLI ](/cli/azure/install-azure-cli) locally.
+
+---
 
-## Azure PowerShell script
+## Start or stop a VM
+
+# [Azure PowerShell](#tab/PowerShell)
 
 The following PowerShell script starts or stops a VM in a lab by using the [Invoke-AzResourceAction](/powershell/module/az.resources/invoke-azresourceaction) PowerShell cmdlet. The `ResourceId` parameter is the fully qualified ID for the lab VM you want to start or stop. The `Action` parameter determines whether to start or stop the VM, depending on which action you need.
 
-1. In Cloud Shell, make sure the **PowerShell** environment is selected. Use the PowerShell [Connect-AzAccount](/powershell/module/Az.Accounts/Connect-AzAccount) cmdlet to sign in to your Azure account. If you have multiple Azure subscriptions, uncomment `Set-AzContext` and provide the `<SubscriptionId>` you want to use.
+1. In Cloud Shell, make sure the **PowerShell** environment is selected.
+
+1. Use the PowerShell [Connect-AzAccount](/powershell/module/Az.Accounts/Connect-AzAccount) cmdlet to sign in to your Azure account. If you have multiple Azure subscriptions, uncomment `Set-AzContext` and provide the `<SubscriptionId>` you want to use.
 
     ```powershell
-    # Sign in to your Azure subscription
     $sub = Get-AzSubscription -ErrorAction SilentlyContinue
     if(-not($sub))
     {
@@ -73,14 +84,16 @@ The following PowerShell script starts or stops a VM in a lab by using the [Invo
     }
     ```
 
-## Azure CLI script
+# [Azure CLI](#tab/CLI)
 
-The Azure CLI [az lab vm start](/cli/azure/lab/vm#az-lab-vm-start) and [az lab vm stop](/cli/azure/lab/vm#az-lab-vm-stop) commands start or stop a lab VM.
+The following script uses the Azure CLI [az lab vm start](/cli/azure/lab/vm#az-lab-vm-start) or [az lab vm stop](/cli/azure/lab/vm#az-lab-vm-stop) commands to start or stop a lab VM.
 
 >[!NOTE]
 >This script assumes a Bash environment. The variables and command for a Windows environment, like a command prompt, have slight variations.
 
-1. In Cloud Shell, make sure the **Bash** environment is selected, and sign in to your Azure account. If you have multiple Azure subscriptions, uncomment the `az account set` line to use the subscription ID you provide.
+1. In Cloud Shell, make sure the **Bash** environment is selected.
+
+1. Sign in to your Azure account. If you have multiple Azure subscriptions, uncomment the `az account set` line and provide a subscription ID to use.
 
    ```azurecli
    az login
@@ -102,7 +115,7 @@ The Azure CLI [az lab vm start](/cli/azure/lab/vm#az-lab-vm-start) and [az lab v
    >If you don't know the name of the Azure resource group that contains your lab, you can find it by providing your `<lab name>` in the following query.
 
    ```azurecli
-   az resource list --resource-type "Microsoft.DevTestLab/labs" --name "<LabName>" --query "[0].resourceGroup"
+   az resource list --resource-type "Microsoft.DevTestLab/labs" --name "<lab name>" --query "[0].resourceGroup"
    ```
 
 1. Run the following Azure CLI command to start or stop the VM, based on the value passed to `ACTION`.
@@ -111,6 +124,8 @@ The Azure CLI [az lab vm start](/cli/azure/lab/vm#az-lab-vm-start) and [az lab v
    az lab vm $ACTION --lab-name $DEVTESTLABNAME --name $VMNAME --resource-group $RESOURCEGROUP
    ```
 
+---
+
 ## Related content
 
 - [Azure CLI az lab reference](/cli/azure/lab)