changes

Author: v-thepet

articles/devtest-labs/add-artifact-repository.md

@@ -2,17 +2,19 @@
 title: Add an artifact repository to your lab
 description: Learn how to add a private artifact repository to your lab to store your custom artifacts.
 ms.topic: how-to
-ms.date: 01/04/2022
+ms.date: 01/11/2022
 ms.custom: devx-track-azurepowershell
 ---
 
 # Add an artifact repository to a lab
 
-You can add *artifacts* to Azure DevTest Labs virtual machines (VMs). Artifacts are tools or applications to install on the VM. You define artifacts in a JSON file that you load from a GitHub or Azure Repos Git repository.
+This article tells you how to add an *artifact* repository to your lab in Azure DevTest Labs. Artifacts are tools or applications to install on virtual machines (VMs). You define artifacts in a JSON file that you load from a GitHub or Azure Repos Git repository.
 
-The public [DevTest Labs GitHub artifact repository](https://github.com/Azure/azure-devtestlab/tree/master/Artifacts) provides many common artifacts for Windows and Linux. The artifacts in this repository are available by default in DevTest Labs. You can also create custom artifacts that aren't available in the public artifact repository. To learn about creating custom artifacts, see [Create custom artifacts](devtest-lab-artifact-author.md).
+The public [DevTest Labs GitHub artifact repository](https://github.com/Azure/azure-devtestlab/tree/master/Artifacts) provides many common artifacts for Windows and Linux. The artifacts in this public repository are available by default in DevTest Labs. For information about adding artifacts to VMs, see [Add artifacts to DevTest Labs VMs](add-artifact-vm.md).
 
-You can add your custom artifacts to your own artifact repository, and add the repository to your lab so all lab users can access the artifacts. This article tells you how to add an artifact repository to your lab by using the Azure portal, an Azure Resource Management (ARM) template, or Azure PowerShell. You can also use an Azure PowerShell or Azure CLI script to automate adding an artifact repository to a lab.
+You can also create custom artifacts that aren't available in the public artifact repository.  To learn about creating custom artifacts, see [Create custom artifacts](devtest-lab-artifact-author.md). You can add your custom artifacts to your own artifact repository, and add the repository to your lab so all lab users can use the artifacts.
+
+This article shows you how to add an artifact repository to your lab by using the Azure portal, an Azure Resource Management (ARM) template, or Azure PowerShell. You can also use an Azure PowerShell or Azure CLI script to automate adding an artifact repository to a lab.
 
 [!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
 
@@ -48,7 +50,7 @@ To add an artifact repository to a lab, you need to know the Git HTTPS clone URL
 
    ![Screenshot that shows the Repositories configuration screen.](media/devtest-lab-add-repo/devtestlab-add-repo.png)
 
-1. In the **Repositories** pane, enter the following information:
+1. In the **Repository** pane, enter the following information:
 
    - **Name**: A repository name to use in the lab.
    - **Git clone URL**: The Git HTTPS clone URL from GitHub or Azure Repos.
@@ -367,6 +369,5 @@ Set-AzContext -SubscriptionId <Your Azure subscription ID>
 ```
 
 ## Next steps
-- [Specify mandatory artifacts for your lab in Azure DevTest Labs](devtest-lab-mandatory-artifacts.md)
-- [Create custom artifacts for your DevTest Labs virtual machine](devtest-lab-artifact-author.md)
+- [Specify mandatory artifacts for DevTest Labs VMs](devtest-lab-mandatory-artifacts.md)
 - [Diagnose artifact failures in the lab](devtest-lab-troubleshoot-artifact-failure.md)

articles/devtest-labs/add-artifact-vm.md

@@ -2,48 +2,51 @@
 title: Add an artifact to a VM
 description: Learn how to add an artifact to a virtual machine in a lab in Azure DevTest Labs.
 ms.topic: how-to
-ms.date: 01/04/2022
+ms.date: 01/11/2022
 ms.custom: devx-track-azurepowershell
 ---
 
 # Add artifacts to DevTest Labs VMs
 
-You can add *artifacts* to Azure DevTest Labs virtual machines (VMs). DevTest Labs artifacts specify actions to take to provision a VM, such as running Windows PowerShell scripts, running Bash commands, or installing software. You can use parameters to customize the artifacts for your own needs.
+This article describes how to add *artifacts* to Azure DevTest Labs virtual machines (VMs). Artifacts specify actions to take to provision a VM, such as running Windows PowerShell scripts, running Bash commands, or installing software. You can use parameters to customize the artifacts for your own needs.
 
 DevTest Labs artifacts can come from the [public DevTest Labs Git repository](https://github.com/Azure/azure-devtestlab/tree/master/Artifacts) or from private Git repositories. To create your own custom artifacts and store them in a repository, see [Create custom artifacts](devtest-lab-artifact-author.md). To add your artifact repository to a lab so lab users can access the custom artifacts, see [Add an artifact repository to your lab](add-artifact-repository.md).
 
-This article describes how to add available artifacts to VMs by using the Azure portal or Azure PowerShell.
+DevTest Labs lab owners can specify mandatory artifacts to be installed on all lab VMs at creation. For more information, see [Specify mandatory artifacts for DevTest Labs VMs](devtest-lab-mandatory-artifacts). You can't change or remove mandatory artifacts at VM creation time, but you can add any available individual artifacts. This article describes how to add available artifacts to VMs by using the Azure portal or Azure PowerShell.
 
 ## Add artifacts to VMs from the Azure portal
 
-1. In the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040), go to the lab that has the VM you want to add artifacts to.
-1. On the lab **Overview** page, under **My virtual machines**, select the VM you want to add artifacts to.
-1. On the VM page, select **Artifacts** in the top menu bar or left navigation.
-1. On the **Artifacts** page, select **Apply artifacts**.
-1. On the **Add artifacts** page, select the arrow next to each artifact you want to add to the VM. Artifact actions execute in the order you add them to the VM.
-1. On each **Add artifact** pane, enter any required and optional parameter values, and then select **OK**.
-1. When you're done adding artifacts, select **Install**.
+You can add artifacts during VM creation, or add artifacts to existing lab VMs.
 
-After the artifacts install, they appear on the VM's **Artifacts** page.
+To add artifacts during VM creation:
 
-<!-- After you add artifacts, you can modify them or change the order they run in.
+1. On the lab's home page, select **Add**.
+1. On the **Choose a base** page, select the type of VM you want.
+1. On the **Create lab resource** screen, select **Add or Remove Artifacts**.
+1. On the **Add artifacts** page, select the arrow next to each artifact you want to add to the VM.
+1. On each **Add artifact** pane, enter any required and optional parameter values, and then select **OK**. The artifact appears under **Selected artifacts**, and the number of configured artifacts updates.
 
-### View or modify artifacts
+   ![Screenshot that shows adding artifacts on the Add artifacts screen.](media/add-artifact-vm/devtestlab-add-artifacts-blade-selected-artifacts.png)
 
-To view installed artifacts, select **Artifacts** from the top menu bar on the VM's **Overview** page.
+1. You can change the artifact after adding them.
 
-To modify an artifact, select it from the list on the **Artifacts** page. 
-1. On the **Add artifact** pane, make any needed changes, and select **OK** to close the **Add artifact** pane.
+   - 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 edit the artifact's parameters, select **Edit** to reopen the **Add artifact** pane.
+   - To delete the artifact from the **Selected artifacts** list, select **Delete**.
 
-### Change the order to run artifacts
+1. When you're done adding and arranging artifacts, select **OK**.
+1. The **Create lab resource** screen shows the number of artifacts added. To add, edit, rearrange, or delete the artifacts before you create the VM, select **Add or Remove Artifacts** again.
 
-By default, artifact actions execute in the order you added them to the VM. To change the order in which the artifacts are run.
+After you create the VM, the installed artifacts appear on the VM's **Artifacts** page. To see details about each artifact's installation, select the artifact name.
 
-1. At the top of the **Apply artifacts** pane, select the link indicating the number of artifacts that have been added to the VM.
-   
-    ![Number of artifacts added to VM](./media/devtest-lab-add-vm-with-artifacts/devtestlab-add-artifacts-blade-selected-artifacts.png)
-1. On the **Selected artifacts** pane, drag and drop the artifacts into the desired order. If you have trouble dragging the artifact, make sure that you are dragging from the left side of the artifact. 
-1. Select **OK** when done.  -->
+To install more artifacts on the existing VM:
+
+1. From the VM's **Artifacts** page, select **Apply artifacts**.
+
+   ![Screenshot that shows the Artifacts screen for an existing V M.](media/add-artifact-vm/artifacts.png)
+
+1. On the **Add artifacts** page, select and configure artifacts the same as for a new VM.
+1. When you're done adding artifacts, select **Install**. The artifacts install on the VM immediately.
 
 ## Add artifacts to VMs by using Azure PowerShell
 
@@ -149,7 +152,7 @@ if ($virtualMachine -ne $null) {
 
 ## Next steps
 
-- [Specify mandatory artifacts for your lab](devtest-lab-mandatory-artifacts.md)
+- [Specify mandatory artifacts](devtest-lab-mandatory-artifacts.md)
 - [Create custom artifacts](devtest-lab-artifact-author.md)
 - [Add an artifact repository to a lab](devtest-lab-artifact-author.md)
 - [Diagnose artifact failures](devtest-lab-troubleshoot-artifact-failure.md)

articles/devtest-labs/devtest-lab-artifact-author.md

@@ -1,15 +1,17 @@
 ---
-title: Create custom artifacts for Azure DevTest Labs virtual machines
+title: Create custom artifacts for virtual machines
 description: Learn how to create and use artifacts to deploy and set up applications on DevTest Labs virtual machines.
 ms.topic: how-to
-ms.date: 01/04/2022
+ms.date: 01/11/2022
 ---
 
-# Create custom artifacts for DevTest Labs VMs
+# Create custom artifacts for DevTest Labs
 
-You can add *artifacts* to Azure DevTest Labs virtual machines (VMs). DevTest Labs artifacts specify actions to take to provision a VM. An artifact consists of an artifact definition file and other script files that you store in a folder in a Git repository.
+This article describes how to create custom artifact files for Azure DevTest Labs virtual machines (VMs). DevTest Labs artifacts specify actions to take to provision a VM. An artifact consists of an artifact definition file and other script files that you store in a folder in a Git repository.
 
-This article describes how to create custom artifact files. For information about adding artifacts to VMs, see [Add artifacts to DevTest Labs VMs](add-artifact-vm.md). For information about adding artifact repositories to labs, see [Add an artifact repository to your lab](add-artifact-repository.md).
+- For information about adding the artifacts you create to VMs, see [Add artifacts to DevTest Labs VMs](add-artifact-vm.md).
+- For information about adding artifact repositories to labs, see [Add an artifact repository to your lab](add-artifact-repository.md).
+- For information about specifying mandatory artifacts to be added to all lab VMs, see [Specify mandatory artifacts for DevTest Labs VMs](devtest-lab-mandatory-artifacts.md).
 
 ## Artifact definition files
 

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

@@ -5,11 +5,11 @@ ms.topic: how-to
 ms.date: 01/10/2022
 ---
 
-# Add mandatory artifacts to DevTest Labs VMs
+# Specify mandatory artifacts for DevTest Labs VMs
 
-This article describes how to specify mandatory artifacts to install on every lab virtual machine (VM) in Azure DevTest Labs. Artifacts are tools and applications you can add to VMs during or after VM creation. Installing mandatory artifacts ensures that all lab VM artifacts are standardized and up-to-date. Lab users don't have to spend the time and effort to add the needed artifacts individually.
+This article describes how to specify mandatory artifacts in Azure DevTest Labs that install on every lab virtual machine (VM). Artifacts are tools and applications to add to VMs. Installing mandatory artifacts ensures that all lab VMs have standardized, up-to-date artifacts. Lab users don't have to spend the time and effort to add the needed artifacts individually.
 
-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 apply the mandatory artifacts. Even if the custom image is old, VM creation applies the most updated versions of the 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.
 
@@ -24,16 +24,14 @@ You can select mandatory artifacts for Windows and Linux lab machines separately
    ![Screenshot that shows the Edit Windows artifacts button.](media/devtest-lab-mandatory-artifacts/mandatory-artifacts-edit-button.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**.
+1. On each **Add artifact** pane, select **OK**. The artifact appears under **Selected artifacts**, and the number of configured artifacts updates.
 
-   After you add each artifact, it appears in the list under **Selected artifacts**.
+   ![Screenshot that shows adding mandatory artifacts on the Mandatory artifacts screen.](media/devtest-lab-mandatory-artifacts/save-artifacts.png)
 
-   By default, artifacts install in the order you add them to the list. To rearrange the order or to delete an artifact, select the ellipsis **...** next to the artifact in the **Selected artifacts** list, and select **Move up**, **Move down**, **Move to top**, **Move to bottom**, or **Delete**.
+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**.
 
 1. When you're done adding and arranging artifacts, select **Save**.
 
-![Screenshot that shows adding mandatory artifacts on the Mandatory artifacts screen.](media/devtest-lab-mandatory-artifacts/save-artifacts.png)
-
 ## Delete or rearrange 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.
@@ -42,7 +40,7 @@ To delete a mandatory artifact from the list, select the checkbox next to the ar
 
 ![Screenshot that shows the Delete button to remove a mandatory artifact.](media/devtest-lab-mandatory-artifacts/remove-artifact.png)
 
-To rearrange the order the mandatory artifacts install in:
+To rearrange the order of the mandatory artifacts:
 
 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.
@@ -51,22 +49,22 @@ To rearrange the order the mandatory artifacts install in:
 
 ## See mandatory artifacts for a VM
 
-Once you specify mandatory artifacts for a lab, all lab VMs for that operating system (Windows or Linux) create with those artifacts installed. Lab users can see the mandatory artifacts to be installed on their VMs.
+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.
 
-For example, to see mandatory Windows artifacts to be installed on all lab Windows VMs:
+For example, to see the mandatory artifacts specified for lab Windows VMs in the earlier procedure:
 
 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 configured. To see what the mandatory artifacts are, select **Add or Remove Artifacts**.
+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**.
 
    ![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)
 
 1. On the **Add artifacts** screen, an informational message lists the mandatory artifacts to be installed, in order.
 
-   ![Screenshot that shows the Add artifacts screen with the list of mandatory artifacts to install.](media/devtest-lab-mandatory-artifacts/select-message-artifacts.png)
+   ![Screenshot that shows the Add artifacts screen with the list of mandatory artifacts to install.](media/devtest-lab-mandatory-artifacts/save-to-lab.png)
 
-You can't remove, rearrange, or change mandatory artifacts when you create a VM. However, you can add other artifacts to the individual VM. For instructions, see [Add artifacts to DevTest Labs VMs](add-artifact-vm.md). You can also create your own artifacts to add to VMs. For instructions, see [Create custom artifacts for DevTest Labs VMs](devtest-lab-article-author.md).
+You can't remove, rearrange, or change mandatory artifacts when you create a VM. However, you can add other available artifacts to the individual VM. For instructions, see [Add artifacts to DevTest Labs VMs](add-artifact-vm.md). You can also create your own artifacts to add to VMs. For instructions, see [Create custom artifacts for DevTest Labs VMs](devtest-lab-artifact-author.md).
 
 ## Next steps
 
-- Learn how to [add a Git artifact repository to a lab](devtest-lab-add-artifact-repository.md).
+- Learn how to [add a Git artifact repository to a lab](add-artifact-repository.md).