Merge pull request #110541 from mumian/0407-tutorial-ref

0407 tutorial ref

Author: Jak-MS

articles/azure-resource-manager/templates/media/template-tutorial-use-template-reference/resource-manager-template-storage-resource.png

@@ -1,14 +1,14 @@
 ---
-title: Utilize template reference
-description: Utilize the Azure Resource Manager template reference to create a template.
+title: Use template reference
+description: Use the Azure Resource Manager template reference to create a template.
 author: mumian
 ms.date: 03/27/2020
 ms.topic: tutorial
 ms.author: jgao
 ms.custom: seodec18
 ---
 
-# Tutorial: Utilize the ARM template reference
+# Tutorial: Utilize the Resource Manager template reference
 
 Learn how to find the template schema information, and use the information to create Azure Resource Manager (ARM) templates.
 
@@ -60,10 +60,14 @@ To complete this article, you need:
     * **resources**: specify the resource types that are deployed or updated in a resource group.
     * **outputs**: specify the values that are returned after deployment.
 
-1. Expand **resources**. There is a `Microsoft.Storage/storageAccounts` resource defined.
+1. Expand **resources**. There is a `Microsoft.Storage/storageAccounts` resource defined. The SKU name uses a parameter value.  The parameter is called **storageAccountType**.
 
     ![Resource Manager template storage account definition](./media/template-tutorial-use-template-reference/resource-manager-template-storage-resource.png)
 
+1. Expand **parameters** to see how **storageAccountType** is defined. The parameter has four allowed values. You will find the other allowed values, and then revise the parameter definition.
+
+    ![Resource Manager template storage account resources skus](./media/template-tutorial-use-template-reference/resource-manager-template-storage-resources-skus-old.png)
+
 ## Find the template reference
 
 1. Browse to [Azure Template reference](https://docs.microsoft.com/azure/templates/).
@@ -79,7 +83,7 @@ To complete this article, you need:
 
     ![Resource Manager template reference storage account types versions](./media/template-tutorial-use-template-reference/resource-manager-template-resources-reference-storage-accounts-types-versions.png)
 
-1. Select the latest version of the **storageAccount** resource type.  The latest version is **2019-06-01** when this article is written.
+1. Select the latest version of the **storageAccount** resource type. The latest version is **2019-06-01** when this article is written. Make sure this version matches the version used for the storage account resource in your template. If you update the API version, verify the resource definition matches the template reference.
 
 1. This page lists the details of the storageAccount resource type.  For example, it lists the allowed values for the **Sku** object. There are more skus than what is listed in the quickstart template that you opened earlier. You can customize the quickstart template to include all the available storage types.
 
@@ -93,7 +97,21 @@ From Visual Studio Code, add the additional storage account types as shown in th
 
 ## Deploy the template
 
-Refer to the [Deploy the template](quickstart-create-templates-use-visual-studio-code.md#deploy-the-template) section in the Visual Studio Code quickstart for the deployment procedure. When you deploy the template, specify the **storageAccountType** parameter with a newly added value, for example, **Premium_ZRS**. The deploy would fail if you use the original quickstart template because **Premium_ZRS** was not an allowed value.
+Refer to the [Deploy the template](quickstart-create-templates-use-visual-studio-code.md#deploy-the-template) section in the Visual Studio Code quickstart for the deployment procedure. When you deploy the template, specify the **storageAccountType** parameter with a newly added value, for example, **Premium_ZRS**. The deploy would fail if you use the original quickstart template because **Premium_ZRS** was not an allowed value.  To pass the parameter value, add the following switch to the deployment command:
+
+# [CLI](#tab/CLI)
+
+```azurecli
+--parameters storageAccountType='Premium_ZRS'
+```
+
+# [PowerShell](#tab/PowerShell)
+
+```azurepowershell
+-storageAccountType "Premium_ZRS"
+```
+
+---
 
 ## Clean up resources
 

articles/azure-resource-manager/templates/media/template-tutorial-use-template-reference/resource-manager-template-storage-resources-skus-old.png

@@ -85,7 +85,7 @@
       href: deployment-tutorial-pipeline.md
   - name: Advanced templates
     items:
-    - name: Utilize template reference
+    - name: Use template reference
       href: template-tutorial-use-template-reference.md
     - name: Create multiple instances
       displayName: iteration,copy