Merge pull request #232805 from asudbring/prvlink-review-1

Review of Private Link service ARM template article and template

Author: v-regandowner

articles/private-link/create-private-link-service-template.md

@@ -2,11 +2,10 @@
 title: 'Quickstart: Create a private link service - ARM template'
 titleSuffix: Azure Private Link
 description: In this quickstart, you use an Azure Resource Manager template (ARM template) to create a private link service.
-services: private-link
 author: asudbring
 ms.service: private-link
 ms.topic: quickstart
-ms.date: 05/29/2020
+ms.date: 03/30/2023
 ms.author: allensu
 ms.custom: subject-armqs, mode-arm, template-quickstart
 ---
@@ -19,7 +18,7 @@ In this quickstart, you use an Azure Resource Manager template (ARM template) to
 
 You can also complete this quickstart by using the [Azure portal](create-private-link-service-portal.md), [Azure PowerShell](create-private-link-service-powershell.md), or the [Azure CLI](create-private-link-service-cli.md).
 
-If your environment meets the prerequisites and you're familiar with using ARM templates, select the **Deploy to Azure** button. The template will open in the Azure portal.
+If your environment meets the prerequisites and you're familiar with using ARM templates, select the **Deploy to Azure** button. The template opens in the Azure portal.
 
 [![Deploy to Azure](../media/template-deployments/deploy-to-azure.svg)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.network%2Fprivatelink-service%2Fazuredeploy.json)
 
@@ -38,12 +37,19 @@ The template used in this quickstart is from [Azure Quickstart Templates](https:
 Multiple Azure resources are defined in the template:
 
 - [**Microsoft.Network/virtualNetworks**](/azure/templates/microsoft.network/virtualnetworks): There's one virtual network for each virtual machine.
+
 - [**Microsoft.Network/loadBalancers**](/azure/templates/microsoft.network/loadBalancers): The load balancer that exposes the virtual machines that host the service.
+
 - [**Microsoft.Network/networkInterfaces**](/azure/templates/microsoft.network/networkinterfaces): There are two network interfaces, one for each virtual machine.
+
 - [**Microsoft.Compute/virtualMachines**](/azure/templates/microsoft.compute/virtualmachines): There are two virtual machines, one that hosts the service and one that tests the connection to the private endpoint.
+
 - [**Microsoft.Compute/virtualMachines/extensions**](/azure/templates/Microsoft.Compute/virtualMachines/extensions): The extension that installs a web server.
+
 - [**Microsoft.Network/privateLinkServices**](/azure/templates/microsoft.network/privateLinkServices): The private link service to expose the service.
+
 - [**Microsoft.Network/publicIpAddresses**](/azure/templates/microsoft.network/publicIpAddresses): There are two public IP addresses, one for each virtual machine.
+
 - [**Microsoft.Network/privateendpoints**](/azure/templates/microsoft.network/privateendpoints): The private endpoint to access the service.
 
 ## Deploy the template
@@ -55,8 +61,14 @@ Here's how to deploy the ARM template to Azure:
    [![Deploy to Azure](../media/template-deployments/deploy-to-azure.svg)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.network%2Fprivatelink-service%2Fazuredeploy.json)
 
 2. Select or create your resource group.
-3. Type the virtual machine administrator username and password.
-4. Read the terms and conditions statement. If you agree, select **I agree to the terms and conditions stated above** > **Purchase**.
+
+3. Enter the virtual machine administrator username and password.
+
+4. Select **Review + create**.
+
+5. Select **Create**.
+
+   The deployment takes a few minutes to complete.
 
 ## Validate the deployment
 
@@ -73,7 +85,7 @@ Connect to the VM _myConsumerVm{uniqueid}_ from the internet as follows:
 
 3.  Select **Download RDP File**. Azure creates a Remote Desktop Protocol (_.rdp_) file and downloads it to your computer.
 
-4.  Open the downloaded .rdp file.
+4.  Open the RDP file that was downloaded to your computer.
 
     a. If prompted, select **Connect**.
 
@@ -93,12 +105,14 @@ Connect to the VM _myConsumerVm{uniqueid}_ from the internet as follows:
 Here's how to connect to the http service from the VM by using the private endpoint.
 
 1.  Go to the Remote Desktop of _myConsumerVm{uniqueid}_.
+
 2.  Open a browser, and enter the private endpoint address: `http://10.0.0.5/`.
+
 3.  The default IIS page appears.
 
 ## Clean up resources
 
-When you no longer need the resources that you created with the private link service, delete the resource group. This removes the private link service and all the related resources.
+When you no longer need the resources that you created with the private link service, delete the resource group. This operation removes the private link service and all the related resources.
 
 To delete the resource group, call the `Remove-AzResourceGroup` cmdlet:
 
@@ -108,7 +122,6 @@ Remove-AzResourceGroup -Name <your resource group name>
 
 ## Next steps
 
-
 For more information on the services that support a private endpoint, see:
 > [!div class="nextstepaction"]
 > [Private Link availability](private-link-overview.md#availability)