Merge pull request #233309 from JustPies/jprefresh-4-4

Freshness Pass for User Story: 79519

Author: AnnaMHuff

articles/virtual-machines/windows/media/tutorial-automate-vm-deployment/running-iis-website.png

@@ -1,50 +1,52 @@
 ---
 title: Tutorial - Install applications on a Windows VM in Azure 
-description: In this tutorial, you learn how to use the Custom Script Extension to run scripts and deploy applications to Windows virtual machines in Azure  
+description: Learn how to use the Custom Script Extension to run scripts and deploy applications to Windows virtual machines in Azure.
 author: cynthn
 ms.service: virtual-machines
 ms.collection: windows
 ms.topic: tutorial
 ms.workload: infrastructure
-ms.date: 11/29/2018
+ms.date: 04/07/2023
 ms.author: cynthn
 ms.custom: mvc, devx-track-azurepowershell
 
-#Customer intent: As an IT administrator or developer, I want learn about how to install applications on Windows VMs so that I can automate the process and reduce the risk of human error of manual configuration tasks.
+#Customer intent: As an IT administrator or developer, I want to learn about how to install applications on Windows VMs so that I can automate the process and reduce the risk of human error of manual configuration tasks.
 ---
 
 # Tutorial - Deploy applications to a Windows virtual machine in Azure with the Custom Script Extension
+
 **Applies to:** :heavy_check_mark: Window :heavy_check_mark: Flexible scale sets :heavy_check_mark: Uniform scale sets
 
 To configure virtual machines (VMs) in a quick and consistent manner, you can use the [Custom Script Extension for Windows](../extensions/custom-script-windows.md). In this tutorial you learn how to:
 
 > [!div class="checklist"]
-> * Use the Custom Script Extension to install IIS
-> * Create a VM that uses the Custom Script Extension
-> * View a running IIS site after the extension is applied
+> * Use the Custom Script Extension to install IIS.
+> * Create a VM that uses the Custom Script Extension.
+> * View a running IIS site after the extension is applied.
 
 ## Launch Azure Cloud Shell
 
-The Azure Cloud Shell is a free interactive shell that you can use to run the steps in this article. It has common Azure tools preinstalled and configured to use with your account. 
+The Azure Cloud Shell is a free interactive shell that you can use to run the steps in this article. It has common Azure tools preinstalled and configured to use with your account.
 
-To open the Cloud Shell, just select **Try it** from the upper right corner of a code block. You can also launch Cloud Shell in a separate browser tab by going to [https://shell.azure.com/powershell](https://shell.azure.com/powershell). Select **Copy** to copy the blocks of code, paste it into the Cloud Shell, and press enter to run it.
+To open the Cloud Shell, select **Open Cloudshell** from the upper right corner of a code block. You can also launch Cloud Shell in a separate browser tab by going to [https://shell.azure.com/powershell](https://shell.azure.com/powershell). Select **Copy** to copy the blocks of code, paste it into the Cloud Shell, and press enter to run it.
 
 ## Custom script extension overview
-The Custom Script Extension downloads and executes scripts on Azure VMs. This extension is useful for post deployment configuration, software installation, or any other configuration / management task. Scripts can be downloaded from Azure storage or GitHub, or provided to the Azure portal at extension run time.
 
-The Custom Script extension integrates with Azure Resource Manager templates, and can also be run using the Azure CLI, PowerShell, Azure portal, or the Azure Virtual Machine REST API.
+The Custom Script Extension downloads and executes scripts on Azure VMs. This extension is useful for post-deployment configuration, software installation, or any other configuration or management task. You can download scripts from Azure storage or GitHub, or you can provide scripts to the Azure portal at extension run time.
 
-You can use the Custom Script Extension with both Windows and Linux VMs.
+The Custom Script extension integrates with Azure Resource Manager templates and can be run by using the Azure CLI, PowerShell, Azure portal, or the Azure Virtual Machine REST API.
 
+You can use the Custom Script Extension with both Linux and Windows VMs.
 
 ## Create virtual machine
+
 Set the administrator username and password for the VM with [Get-Credential](/powershell/module/microsoft.powershell.security/get-credential):
 
 ```azurepowershell-interactive
 $cred = Get-Credential
 ```
 
-Now you can create the VM with [New-AzVM](/powershell/module/az.compute/new-azvm). The following example creates a VM named *myVM* in the *EastUS* location. If they do not already exist, the resource group *myResourceGroupAutomate* and supporting network resources are created. To allow web traffic, the cmdlet also opens port *80*.
+Now you can create the VM with [New-AzVM](/powershell/module/az.compute/new-azvm). The following example creates a VM named *myVM* in the *EastUS* location. If they don't already exist, the resource group *myResourceGroupAutomate* and supporting network resources are created. To allow web traffic, the cmdlet also opens port *80*.
 
 ```azurepowershell-interactive
 New-AzVm `
@@ -59,10 +61,10 @@ New-AzVm `
     -Credential $cred
 ```
 
-It takes a few minutes for the resources and VM to be created.
-
+The resources and VM take a few minutes to be created.
 
 ## Automate IIS install
+
 Use [Set-AzVMExtension](/powershell/module/az.compute/set-azvmextension) to install the Custom Script Extension. The extension runs `powershell Add-WindowsFeature Web-Server` to install the IIS webserver and then updates the *Default.htm* page to show the hostname of the VM:
 
 ```azurepowershell-interactive
@@ -76,9 +78,9 @@ Set-AzVMExtension -ResourceGroupName "myResourceGroupAutomate" `
     -SettingString '{"commandToExecute":"powershell Add-WindowsFeature Web-Server; powershell Add-Content -Path \"C:\\inetpub\\wwwroot\\Default.htm\" -Value $($env:computername)"}'
 ```
 
-
 ## Test web site
-Obtain the public IP address of your load balancer with [Get-AzPublicIPAddress](/powershell/module/az.network/get-azpublicipaddress). The following example obtains the IP address for *myPublicIPAddress* created earlier:
+
+Obtain the public IP address of your load balancer with [Get-AzPublicIPAddress](/powershell/module/az.network/get-azpublicipaddress). The following example obtains the IP address for `myPublicIPAddress` created earlier:
 
 ```azurepowershell-interactive
 Get-AzPublicIPAddress `
@@ -88,17 +90,16 @@ Get-AzPublicIPAddress `
 
 You can then enter the public IP address in to a web browser. The website is displayed, including the hostname of the VM that the load balancer distributed traffic to as in the following example:
 
-![Running IIS website](./media/tutorial-automate-vm-deployment/running-iis-website.png)
-
+:::image type="content" source="./media/tutorial-automate-vm-deployment/running-iis-website.png" alt-text="Screenshot of the public IP address in a web browser.":::
 
 ## Next steps
 
 In this tutorial, you automated the IIS install on a VM. You learned how to:
 
 > [!div class="checklist"]
-> * Use the Custom Script Extension to install IIS
-> * Create a VM that uses the Custom Script Extension
-> * View a running IIS site after the extension is applied
+> * Use the Custom Script Extension to install IIS.
+> * Create a VM that uses the Custom Script Extension.
+> * View a running IIS site after the extension is applied.
 
 Advance to the next tutorial to learn how to create custom VM images.