Merge pull request #222325 from ktoliver/2017675

edit pass: upload VHD file to lab storage account (2017675)

Author: ShawnJackson

articles/devtest-labs/devtest-lab-upload-vhd-using-azcopy.md

@@ -1,73 +1,77 @@
 ---
-title: Upload VHD file to Azure DevTest Labs using AzCopy
-description: This article provides a walkthrough to use the AzCopy command-line utility to upload a VHD file to a lab's storage account in Azure DevTest Labs.
+title: Upload a VHD file to Azure DevTest Labs by using AzCopy
+description: Walk through the steps to use the AzCopy command-line utility to upload a VHD file to a lab storage account in Azure DevTest Labs.
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 06/26/2020
+ms.date: 12/22/2022
 ---
 
-# Upload VHD file to lab's storage account using AzCopy
+# Upload a VHD file to a lab storage account by using AzCopy
 
 [!INCLUDE [devtest-lab-upload-vhd-selector](../../includes/devtest-lab-upload-vhd-selector.md)]
 
-In Azure DevTest Labs, VHD files can be used to create custom images, which are used to provision virtual machines. 
-The following steps walk you through using the AzCopy command-line utility to upload a VHD file to a lab's storage account. Once you've uploaded your VHD file, the [Next steps section](#next-steps) lists some articles that illustrate how to create a custom image from the uploaded VHD file. For more information about disks and VHDs in Azure, see [Introduction to managed disks](../virtual-machines/managed-disks-overview.md)
+In this article, learn how to use the AzCopy command-line utility to upload a VHD file to a lab storage account in Azure DevTest Labs. After you upload your VHD file, you can create a custom image from the uploaded VHD file and use the image to provision a virtual machine.
 
-> [!NOTE] 
+For more information about disks and VHDs in Azure, see [Introduction to managed disks](../virtual-machines/managed-disks-overview.md).
+
+> [!NOTE]
 >  
 > AzCopy is a Windows-only command-line utility.
 
-## Step-by-step instructions
+## Prerequisites
+
+- Download and install the [latest version of AzCopy](https://aka.ms/downloadazcopy).
+
+To upload a VHD file to a lab storage account by using AzCopy, first, get the lab storage account name via the Azure portal. Then, use AzCopy to upload the file.
 
-The following steps walk you through uploading a VHD file to Azure DevTest Labs using [AzCopy](https://aka.ms/downloadazcopy). 
+## Get the lab storage account name
 
-1. Get the name of the lab's storage account using the Azure portal:
+To get the name of the lab storage account:
 
 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. Select **All resources**, and then select your lab.  
+
+1. In the lab menu under **Settings**, select **Configuration and policies**.
+
+1. In **Activity log**, in the resource menu under **Virtual machine bases**, select **Custom images**.
+
+1. In **Custom images**, select **Add**.
 
-1. From the list of labs, select the desired lab.  
+1. In **Custom image**, under **VHD**, select the **Upload an image using PowerShell** link.
 
-1. On the lab's blade, select **Configuration**. 
+    :::image type="content" source="media/devtest-lab-upload-vhd-using-azcopy/upload-image-powershell.png" alt-text="Screenshot that shows settings to upload a VHD by using PowerShell on the Custom image pane.":::
 
-1. On the lab **Configuration** blade, select **Custom images (VHDs)**.
+1. In **Upload an image using PowerShell**, scroll right to see a call to the Add-AzureRmVhd cmdlet.
 
-1. On the **Custom images** blade, Select **+Add**. 
+    The `-Destination` parameter contains the URI for a blob container in the following format:
 
-1. On the **Custom image** blade, select **VHD**.
+    `https://<storageAccountName>.blob.core.windows.net/uploads/...`
 
-1. On the **VHD** blade, select **Upload a VHD using PowerShell**.
+    :::image type="content" source="media/devtest-lab-upload-vhd-using-azcopy/destination-parameter.png" alt-text="Screenshot that shows an example of a URI in the Add VHD box.":::
 
-    ![Upload VHD using PowerShell](./media/devtest-lab-upload-vhd-using-azcopy/upload-image-using-psh.png)
+1. Copy the storage account URI to use in the next section.
 
-1. The **Upload an image using PowerShell** blade displays a call to the **Add-AzureVhd** cmdlet. 
-The first parameter (*Destination*) contains the URI for a blob container (*uploads*) in the following format:
+## Upload a VHD file
 
-	```
-	https://<STORAGE-ACCOUNT-NAME>.blob.core.windows.net/uploads/...
-	``` 
+To upload a VHD file by using AzCopy:
 
-1. Make note of the full URI as it is used in later steps.
+1. In Windows, open a Command Prompt window and go to the AzCopy installation directory.
 
-1. Upload the VHD file using AzCopy:
- 
-1. [Download and install the latest version of AzCopy](https://aka.ms/downloadazcopy).
+    By default, AzCopy is installed in *ProgramFiles(x86)\Microsoft SDKs\Azure\AzCopy*.
 
-1. Open a command window and navigate to the AzCopy installation directory. Optionally, you can add the AzCopy installation location to your system path. By default, AzCopy is installed to the following directory:
+    Optionally, you can add the AzCopy installation location to your system path.
 
-	```command-line
-	%ProgramFiles(x86)%\Microsoft SDKs\Azure\AzCopy
-	```
+1. At the command prompt, run the following command. Use the storage account key and blob container URI you copied from the Azure portal. The value for `vhdFileName` must be in quotes.
 
-1. Using the storage account key and blob container URI, run the following command at the command prompt. The *vhdFileName* value needs to be in quotes. The process of uploading a VHD file can be lengthy depending on the size of the VHD file and your connection speed.   
+    ```cmd
+    AzCopy /Source:<sourceDirectory> /Dest:<blobContainerUri> /DestKey:<storageAccountKey> /Pattern:"<vhdFileName>" /BlobType:page
+    ```
 
-	```command-line
-	AzCopy /Source:<sourceDirectory> /Dest:<blobContainerUri> /DestKey:<storageAccountKey> /Pattern:"<vhdFileName>" /BlobType:page
-	```
+The process of uploading a VHD file might be lengthy depending on the size of the VHD file and your connection speed.
 
 ## Next steps
 
-- [Create a custom image in Azure DevTest Labs from a VHD file using the Azure portal](devtest-lab-create-template.md)
-- [Create a custom image in Azure DevTest Labs from a VHD file using PowerShell](devtest-lab-create-custom-image-from-vhd-using-powershell.md)
+- Learn how to [create a custom image in Azure DevTest Labs from a VHD file by using the Azure portal](devtest-lab-create-template.md).
+- Learn how to [create a custom image in Azure DevTest Labs from a VHD file by using PowerShell](devtest-lab-create-custom-image-from-vhd-using-powershell.md).

articles/devtest-labs/devtest-lab-upload-vhd-using-powershell.md

@@ -1,52 +1,59 @@
 ---
-title: Upload VHD file to Azure DevTest Labs using PowerShell
-description: This article provides a walkthrough that shows you how to upload a VHD file to Azure DevTest Labs using PowerShell.
+title: Upload a VHD file to Azure DevTest Labs by using PowerShell
+description: Walk through the steps to use PowerShell to upload a VHD file to a lab storage account in Azure DevTest Labs.
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 06/26/2020
+ms.date: 12/22/2022
 ---
 
-# Upload VHD file to lab's storage account using PowerShell
+# Upload a VHD file to a lab storage account by using PowerShell
 
 [!INCLUDE [devtest-lab-upload-vhd-selector](../../includes/devtest-lab-upload-vhd-selector.md)]
 
-In Azure DevTest Labs, VHD files can be used to create custom images, which are used to provision virtual machines. 
-The following steps walk you through using PowerShell to upload a VHD file to a lab's storage account. Once you've uploaded your VHD file, the [Next steps section](#next-steps) lists some articles that illustrate how to create a custom image from the uploaded VHD file. For more information about disks and VHDs in Azure, see [Introduction to managed disks](../virtual-machines/managed-disks-overview.md)
+In this article, learn how to use PowerShell to upload a VHD file to a lab storage account in Azure DevTest Labs. After you upload your VHD file, you can create a custom image from the uploaded VHD file and use the image to provision a virtual machine.
 
-## Step-by-step instructions
+For more information about disks and VHDs in Azure, see [Introduction to managed disks](../virtual-machines/managed-disks-overview.md).
 
-The following steps walk you through uploading a VHD file to Azure DevTest Labs using PowerShell. 
+## Prerequisites
+
+- Download and install the [latest version of PowerShell](/powershell/scripting/install/installing-powershell?).
+
+To upload a VHD file to a lab storage account by using PowerShell, first, get the lab storage account name via the Azure portal. Then, use a PowerShell cmdlet to upload the file.
+
+## Get the lab storage account name
+
+To get the name of the lab storage account:
 
 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. Select **All resources**, and then select your lab.  
+
+1. In the lab menu under **Settings**, select **Configuration and policies**.
 
-1. From the list of labs, select the desired lab.  
+1. In **Activity log**, in the resource menu under **Virtual machine bases**, select **Custom images**.
 
-1. On the lab's blade, select **Configuration**. 
+1. In **Custom images**, select **Add**.
 
-1. On the lab **Configuration** blade, select **Custom images (VHDs)**.
+1. In **Custom image**, under **VHD**, select the **Upload an image using PowerShell** link.
 
-1. On the **Custom images** blade, Select **+Add**. 
+    :::image type="content" source="media/devtest-lab-upload-vhd-using-powershell/upload-image-powershell.png" alt-text="Screenshot that shows the link to upload a VHD by using PowerShell on the Custom image pane.":::
 
-1. On the **Custom image** blade, select **VHD**.
+1. In **Upload an image using PowerShell**, select and copy the generated PowerShell script to use in the next section.
 
-1. On the **VHD** blade, select **Upload a VHD using PowerShell**.
+## Upload a VHD file
 
-    ![Upload VHD using PowerShell](./media/devtest-lab-upload-vhd-using-powershell/upload-image-using-psh.png)
+To upload a VHD file by using PowerShell:
 
-1. On the **Upload an image using PowerShell** blade, copy the generated PowerShell script to a text editor.
+1. In a text editor, paste the generated PowerShell script you copied from the Azure portal.
 
-1. Modify the **LocalFilePath** parameter of the **Add-AzureVhd** cmdlet to point to the location of the VHD file you want to upload.
+1. Modify the `-LocalFilePath` parameter of the Add-AzureRmVhd cmdlet to point to the location of the VHD file you want to upload.
 
-1. At a PowerShell prompt, run the **Add-AzureVhd** cmdlet (with the modified **LocalFilePath** parameter).
+1. At a PowerShell command prompt, run the Add-AzureRmVhd cmdlet with the modified `-LocalFilePath` parameter.
 
-> [!WARNING] 
-> 
-> The process of uploading a VHD file can be lengthy depending on the size of the VHD file and your connection speed.
+The process of uploading a VHD file might be lengthy depending on the size of the VHD file and your connection speed.
 
 ## Next steps
 
-- [Create a custom image in Azure DevTest Labs from a VHD file using the Azure portal](devtest-lab-create-template.md)
-- [Create a custom image in Azure DevTest Labs from a VHD file using PowerShell](devtest-lab-create-custom-image-from-vhd-using-powershell.md)
+- Learn how to [create a custom image in Azure DevTest Labs from a VHD file by using the Azure portal](devtest-lab-create-template.md).
+- Learn how to [create a custom image in Azure DevTest Labs from a VHD file by using PowerShell](devtest-lab-create-custom-image-from-vhd-using-powershell.md).