refresh

Author: GitHubber17

articles/devtest-labs/devtest-lab-configure-cost-management.md

@@ -65,7 +65,7 @@ After DevTest Labs is configured to provide the lab-specific information for Mic
 
 For a quick view of costs per lab, following these steps: 
 
-1. In the Azure portal, go to your lab, and select a resource group that has tags.
+1. In the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040), go to your lab, and select a resource group that has tags.
 
 1. On the left menu, expand **Cost Management**, and select **Cost analysis**.
 

articles/devtest-labs/devtest-lab-mandatory-artifacts.md

@@ -1,77 +1,109 @@
 ---
 title: Specify mandatory artifacts for lab virtual machines
+titleSuffix: Azure DevTest Labs
 description: Learn how to specify mandatory artifacts to install at creation of every lab virtual machine (VM) in Azure DevTest Labs.
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 09/30/2023
+ms.date: 06/04/2024
 ms.custom: UpdateFrequency2
+
+#customer intent: As a developer, I want to specify mandatory artifacts in Azure DevTest Labs so that I can create new virtual machines that automatically have the mandatory artifacts installed.
 ---
 
-# Specify mandatory artifacts for DevTest Labs VMs
+# Specify mandatory artifacts for Azure DevTest Labs virtual machines
+
+This article describes how to specify _mandatory artifacts_ in Azure DevTest Labs to install on every lab virtual machine (VM). Artifacts are tools and applications that you can add to your VMs. Mandatory artifacts can include any software that every VM in your lab must have. By defining mandatory artifacts, you can ensure all your lab VMs are installed with standardized, up-to-date artifacts. Lab users don't have to spend time and effort to add needed artifacts individually.
+
+You can create a custom image from a VM that has mandatory artifacts applied to it. When you create new VMs from the custom image, the new VMs also have the mandatory artifacts. 
+
+Here are some other considerations:
+
+- Mandatory artifacts can't have configurable parameters. This restriction makes it easier for lab users to create VMs.
+- Mandatory artifacts always install first on a VM before any extra or custom artifacts selected by the user.
+- DevTest Labs always installs the most recent versions of the mandatory artifacts on a VM, even when the base is an "older" custom image.
 
-This article describes how to specify mandatory *artifacts* in Azure DevTest Labs to install on every lab virtual machine (VM). Artifacts are tools and applications to add to VMs. Installing mandatory artifacts ensures all lab VMs have standardized, up-to-date artifacts. Lab users don't have to spend time and effort to add needed artifacts individually.
+## Define mandatory artifacts
 
-Mandatory artifacts can include any software that every VM in your lab must have. If you create a custom image from a VM that has mandatory artifacts applied to it, and create new VMs from that image, those VMs also have the mandatory artifacts. Even if the custom image is old, VM creation applies the most updated versions of the mandatory artifacts.
- 
-Only artifacts that have no parameters can be mandatory artifacts. Lab users don't have to enter extra parameter values, making the VM creation process simple.
+You can select mandatory artifacts for Windows and Linux lab machines separately by following these steps:
 
-During VM creation, mandatory artifacts install before any artifacts the user chooses to install on the machine.
+1. In the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040), go to your DevTest Labs lab resource where you want to define the mandatory artifacts.
 
-## Specify mandatory artifacts
+1. On your lab **Overview** page, expand the **Settings** section in the left menu, and select **Configuration and policies**.
 
-You can select mandatory artifacts for Windows and Linux lab machines separately.
+1. On the **Configuration and policies** screen, expand the **External resources** section in the left menu, and select **Mandatory artifacts**.
 
-1. On your lab's home page, under **Settings** in the left navigation, select **Configuration and policies**.
-1. On the **Configuration and policies** screen, under **External resources** in the left navigation, select **Mandatory artifacts**.
-1. For Windows VMs, select **Windows**, and then select **Edit Windows artifacts**. For Linux VMs, select **Linux**, and then select **Edit Linux artifacts**.
+1. Select the VM configuration:
 
-   ![Screenshot that shows the Edit Windows artifacts button.](media/devtest-lab-mandatory-artifacts/mandatory-artifacts-edit-button.png)
+   - **Windows**: Select the **Windows** tab, and then select **Edit Windows artifacts**.
+   - **Linux**: Select the **Linux** tab, and then select **Edit Linux artifacts**.
+
+   :::image type="content" source="./media/devtest-lab-mandatory-artifacts/mandatory-artifacts-edit-button.png" border="false" alt-text="Screenshot that shows how to Edit Windows artifacts for lab virtual machines in the Azure portal." lightbox="./media/devtest-lab-mandatory-artifacts/mandatory-artifacts-edit-button-large.png":::
 
 1. On the **Mandatory artifacts** page, select the arrow next to each artifact you want to add to the VM.
-1. On each **Add artifact** pane, select **OK**. The artifact appears under **Selected artifacts**, and the number of configured artifacts updates.
 
-   ![Screenshot that shows adding mandatory artifacts on the Mandatory artifacts screen.](media/devtest-lab-mandatory-artifacts/save-artifacts.png)
+1. On each **Add artifact** pane, select **OK**. The artifact appears under **Selected artifacts**, and the number of configured artifacts updates to show the current list:
+
+   :::image type="content" source="./media/devtest-lab-mandatory-artifacts/save-artifacts.png" alt-text="Screenshot that shows how to add mandatory artifacts on the Mandatory artifacts screen." lightbox="./media/devtest-lab-mandatory-artifacts/save-artifacts-large.png":::
+
+1. Select **Save**.
+
+## Change installation order
 
-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 delete the artifact from the list, select **Delete**.
+After you add mandatory artifacts, DevTest Labs updates the **Mandatory artifacts** lists for your lab in the Azure portal. From these lists, you can access the artifacts to change the installation order. When you create a new VM, DevTest Labs installs the **top** artifact in the list first and the **bottom** artifact last.
 
-1. When you're done adding and arranging artifacts, select **Save**.
+> [!NOTE]
+> When you create a VM, you can't rearrange or change mandatory artifacts, but you can add more artifacts. For more information, see [Add artifacts to DevTest Labs VMs](add-artifact-vm.md).
 
-## Delete or rearrange mandatory artifacts
+To rearrange the order of installation for the mandatory artifacts:
 
-After you add mandatory artifacts, the lists of selected artifacts appear on the **Configuration and policies | Mandatory artifacts** screen under **Windows** and **Linux**. You can rearrange or delete the specified mandatory artifacts.
+1. On the **External resources** > **Mandatory artifacts** screen for your lab, select the **Windows** or **Linux** tab.
 
-To delete a mandatory artifact from the list, select the checkbox next to the artifact, and then select **Delete**.
+1. Select **Edit Windows artifacts** or **Edit Linux artifacts** to open the **Mandatory artifacts** page.
 
-![Screenshot that shows the Delete button to remove a mandatory artifact.](media/devtest-lab-mandatory-artifacts/remove-artifact.png)
+1. In the **Selected artifacts** list, select **More options** (...) for the artifact that you want to change.
 
-To rearrange the order of the mandatory artifacts:
+1. On the artifact menu, select **Move up**, **Move down**, **Move to top**, or **Move to bottom**.
 
-1. Select **Edit Windows artifacts** or **Edit Linux artifacts**.
-1. On the **Mandatory artifacts** page, select the ellipsis **...** next to the artifact in the **Selected artifacts** list.
-1. Select **Move up**, **Move down**, **Move to top**, or **Move to bottom**.
 1. Select **Save**.
 
-## See mandatory artifacts for a VM
+## Delete mandatory artifacts
+
+You can also delete artifacts in the **Mandatory artifacts** lists.
+
+> [!NOTE]
+> When you create a VM, you can't delete mandatory artifacts. For more information, see [Add artifacts to DevTest Labs VMs](add-artifact-vm.md).
+
+1. On the **External resources** > **Mandatory artifacts** screen for your lab, select the **Windows** or **Linux** tab.
+
+1. Select the checkbox next to the artifact in the list, and then select **Delete**:
+
+   :::image type="content" source="./media/devtest-lab-mandatory-artifacts/remove-artifact.png" alt-text="Screenshot that shows how to select the Delete option to remove a mandatory artifact." lightbox="./media/devtest-lab-mandatory-artifacts/remove-artifact-large.png":::
+
+## View mandatory artifacts
+
+After you specify mandatory artifacts for a lab, DevTest Labs shows the mandatory artifacts for all lab VMs based on the operating system (Windows or Linux). When a lab user creates a new VM, they can see the mandatory artifacts that DevTest Labs plans to install.
+
+To view the mandatory artifacts for a VM:
 
-Once you specify mandatory artifacts for a lab, all lab VMs for that operating system (Windows or Linux) have those artifacts installed at creation. Lab users can see the mandatory artifacts to be installed on their VMs.
+1. On the **Overview** page for your lab, select **Add**.
 
-For example, to see the mandatory artifacts specified for lab Windows VMs in the earlier procedure:
+1. On the **Choose a base** page, select a Marketplace image, such as **Windows 11 Pro**.
 
-1. On your lab's home page, select **Add**.
-1. On the **Choose a base** page, select a Windows image, such as **Windows 11 Pro**.
-1. On the **Create lab resource** page, under **Artifacts**, note the number of mandatory artifacts. To see what the mandatory artifacts are, select **Add or Remove Artifacts**.
+1. On the **Create lab resource** page, under **Artifacts**, notice the number of mandatory artifacts for the VM:
 
-   ![Screenshot that shows the Create lab resource screen with number of mandatory artifacts and Add or Remove Artifacts link.](media/devtest-lab-mandatory-artifacts/select-message-artifacts.png)
+   :::image type="content" source="./media/devtest-lab-mandatory-artifacts/select-message-artifacts.png" alt-text="Screenshot that shows the Create lab resource screen with the number of mandatory artifacts and the Add or Remove Artifacts option.":::
 
-1. On the **Add artifacts** screen, an informational message lists the mandatory artifacts to be installed, in order.
+1. To see details about the mandatory artifacts, select **Add or Remove Artifacts**.
 
-   ![Screenshot that shows the Add artifacts screen with the list of mandatory artifacts to install.](media/devtest-lab-mandatory-artifacts/save-to-lab.png)
+1. On the **Add artifacts** screen, the mandatory artifacts are listed above the available artifacts. The mandatory artifacts are listed in order of installation from top to bottom:
 
-You can't remove, rearrange, or change mandatory artifacts when you create an individual VM. However, you can add other available artifacts to the VM. For more information and instructions, see [Add artifacts to DevTest Labs VMs](add-artifact-vm.md).
+   :::image type="content" source="./media/devtest-lab-mandatory-artifacts/save-to-lab.png" alt-text="Screenshot that shows the Add artifacts screen with the list of mandatory artifacts that DevTest Labs plans to install." lightbox="./media/devtest-lab-mandatory-artifacts/save-to-lab-large.png":::
 
-You can also create your own artifacts for VMs. For more information, see [Create custom artifacts for DevTest Labs VMs](devtest-lab-artifact-author.md).
+   Extra artifacts selected by the user for the VM instance are shown next to the available list. These artifacts are also listed in order of installation from top to bottom. Extra artifacts are always installed after the mandatory artifacts.
+   
+   The user can also create new artifacts for their VMs. For more information, see [Create custom artifacts for DevTest Labs VMs](devtest-lab-artifact-author.md).
 
-## Next steps
+## Related content
 
-- Learn how to [add a Git artifact repository to a lab](add-artifact-repository.md).
+- [Add a Git artifact repository to a lab](add-artifact-repository.md)