Merge pull request #111007 from mumian/0410-condition

update the use condition tutorial

Author: GitHubber17

articles/azure-resource-manager/templates/media/template-tutorial-use-conditions/resource-manager-tutorial-use-condition-template-parameters.png

@@ -50,23 +50,25 @@ To complete this article, you need:
 Azure QuickStart Templates is a repository for ARM templates. Instead of creating a template from scratch, you can find a sample template and customize it. The template used in this tutorial is called [Deploy a simple Windows VM](https://azure.microsoft.com/resources/templates/101-vm-simple-windows/).
 
 1. From Visual Studio Code, select **File**>**Open File**.
-2. In **File name**, paste the following URL:
+1. In **File name**, paste the following URL:
 
     ```url
     https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.json
     ```
 
-3. Select **Open** to open the file.
-4. There are five resources defined by the template:
+1. Select **Open** to open the file.
+1. There are six resources defined by the template:
 
-   * `Microsoft.Storage/storageAccounts`. See the [template reference](https://docs.microsoft.com/azure/templates/Microsoft.Storage/storageAccounts).
-   * `Microsoft.Network/publicIPAddresses`. See the [template reference](https://docs.microsoft.com/azure/templates/microsoft.network/publicipaddresses).
-   * `Microsoft.Network/virtualNetworks`. See the [template reference](https://docs.microsoft.com/azure/templates/microsoft.network/virtualnetworks).
-   * `Microsoft.Network/networkInterfaces`. See the [template reference](https://docs.microsoft.com/azure/templates/microsoft.network/networkinterfaces).
-   * `Microsoft.Compute/virtualMachines`. See the [template reference](https://docs.microsoft.com/azure/templates/microsoft.compute/virtualmachines).
+   * [**Microsoft.Storage/storageAccounts**](/azure/templates/Microsoft.Storage/storageAccounts).
+   * [**Microsoft.Network/publicIPAddresses**](/azure/templates/microsoft.network/publicipaddresses).
+   * [**Microsoft.Network/networkSecurityGroups**](/azure/templates/microsoft.network/networksecuritygroups).
+   * [**Microsoft.Network/virtualNetworks**](/azure/templates/microsoft.network/virtualnetworks).
+   * [**Microsoft.Network/networkInterfaces**](/azure/templates/microsoft.network/networkinterfaces).
+   * [**Microsoft.Compute/virtualMachines**](/azure/templates/microsoft.compute/virtualmachines).
 
-     It is helpful to get some basic understanding of the template before customizing it.
-5. Select **File**>**Save As** to save a copy of the file to your local computer with the name **azuredeploy.json**.
+    It is helpful to review the template reference before customizing a template.
+
+1. Select **File**>**Save As** to save a copy of the file to your local computer with the name **azuredeploy.json**.
 
 ## Modify the template
 
@@ -78,12 +80,12 @@ Make two changes to the existing template:
 Here is the procedure to make the changes:
 
 1. Open **azuredeploy.json** in Visual Studio Code.
-2. Replace the three **variables('storageAccountName')** with **parameters('storageAccountName')** in the whole template.
-3. Remove the following variable definition:
+1. Replace the three **variables('storageAccountName')** with **parameters('storageAccountName')** in the whole template.
+1. Remove the following variable definition:
 
     ![Resource Manager template use condition diagram](./media/template-tutorial-use-conditions/resource-manager-tutorial-use-condition-template-remove-storageaccountname.png)
 
-4. Add the following two parameters to the template:
+1. Add the following two parameters to the beginning of the parameters section:
 
     ```json
     "storageAccountName": {
@@ -98,11 +100,13 @@ Here is the procedure to make the changes:
     },
     ```
 
+    Press **[ALT]+[SHIFT]+F** to format the template in Visual Studio Code.
+
     The updated parameters definition looks like:
 
     ![Resource Manager use condition](./media/template-tutorial-use-conditions/resource-manager-tutorial-use-condition-template-parameters.png)
 
-5. Add the following line to the beginning of the storage account definition.
+1. Add the following line to the beginning of the storage account definition.
 
     ```json
     "condition": "[equals(parameters('newOrExisting'),'new')]",
@@ -113,29 +117,34 @@ Here is the procedure to make the changes:
     The updated storage account definition looks like:
 
     ![Resource Manager use condition](./media/template-tutorial-use-conditions/resource-manager-tutorial-use-condition-template.png)
-6. Update the **storageUri** property of the virtual machine resource definition with the following value:
+1. Update the **storageUri** property of the virtual machine resource definition with the following value:
 
     ```json
     "storageUri": "[concat('https://', parameters('storageAccountName'), '.blob.core.windows.net')]"
     ```
 
     This change is necessary when you use an existing storage account under a different resource group.
 
-7. Save the changes.
+1. Save the changes.
 
 ## Deploy the template
 
-Follow the instructions in [Deploy the template](./template-tutorial-create-templates-with-dependent-resources.md#deploy-the-template) to open the Cloud shell and upload the revised template, and then run the following PowerShell script to deploy the template.
+Follow the instructions in [Deploy the template](./template-tutorial-create-templates-with-dependent-resources.md#deploy-the-template) to open the Cloud Shell and upload the revised template, and then run the following PowerShell script to deploy the template.
+
+> [!IMPORTANT]
+> The storage account name must be unique across Azure. The name must have only lowercase letters or numbers. It can be no longer than 24 characters. The storage account name is the project name with "store" appended. Make sure the project name and the generated storage account name meet the storage account name requirements.
 
 ```azurepowershell
-$resourceGroupName = Read-Host -Prompt "Enter the resource group name"
-$storageAccountName = Read-Host -Prompt "Enter the storage account name"
+$projectName = Read-Host -Prompt "Enter a project name that is used to generate resource group name and resource names"
 $newOrExisting = Read-Host -Prompt "Create new or use existing (Enter new or existing)"
 $location = Read-Host -Prompt "Enter the Azure location (i.e. centralus)"
 $vmAdmin = Read-Host -Prompt "Enter the admin username"
 $vmPassword = Read-Host -Prompt "Enter the admin password" -AsSecureString
 $dnsLabelPrefix = Read-Host -Prompt "Enter the DNS Label prefix"
 
+$resourceGroupName = "${projectName}rg"
+$storageAccountName = "${projectName}store"
+
 New-AzResourceGroup -Name $resourceGroupName -Location $location
 New-AzResourceGroupDeployment `
     -ResourceGroupName $resourceGroupName `
@@ -154,7 +163,7 @@ Try making another deployment with **newOrExisting** set to "existing" and speci
 
 ## Clean up resources
 
-When the Azure resources are no longer needed, clean up the resources you deployed by deleting the resource group. To delete the resource group, select **Try it** to open the Cloud shell. To paste the PowerShell script, right-click the shell pane, and then select **Paste**.
+When the Azure resources are no longer needed, clean up the resources you deployed by deleting the resource group. To delete the resource group, select **Try it** to open the Cloud Shell. To paste the PowerShell script, right-click the shell pane, and then select **Paste**.
 
 ```azurepowershell-interactive
 $resourceGroupName = Read-Host -Prompt "Enter the same resource group name you used in the last procedure"