Merge pull request #184943 from JnHs/jh-portal-cliqref

review and refresh quickstart

Author: GitHubber17

articles/azure-portal/azure-portal-markdown-tile.md

@@ -14,7 +14,6 @@ You can add a markdown tile to your Azure dashboards to display custom, static c
 
 1. Select **Dashboard** from the Azure portal menu.
 
-
 1. In the dashboard view, select the dashboard where the custom markdown tile should appear, then select **Edit**.
 
    ![Screenshot showing dashboard edit view](./media/azure-portal-markdown-tile/azure-portal-dashboard-edit.png)

articles/azure-portal/media/quick-create-template/cloud-shell.png

@@ -3,7 +3,7 @@ title: Create an Azure portal dashboard by using an Azure Resource Manager templ
 description: Learn how to create an Azure portal dashboard by using an Azure Resource Manager template.
 ms.topic: quickstart
 ms.custom: subject-armqs, mode-arm
-ms.date: 03/15/2021
+ms.date: 01/13/2022
 ---
 
 # Quickstart: Create a dashboard in the Azure portal by using an ARM template
@@ -18,69 +18,64 @@ If your environment meets the prerequisites and you're familiar with using ARM t
 
 ## Prerequisites
 
-- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
-- An existing VM.
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 
 ## Create a virtual machine
 
 The dashboard you create in the next part of this quickstart requires an existing VM. Create a VM by following these steps.
 
-1. In the Azure portal, select **Cloud Shell**.
+1. In the Azure portal, select **Cloud Shell** from the global controls at the top of the page.
 
-    ![Select Cloud shell from the Azure portal ribbon](media/quick-create-template/cloud-shell.png)
+    :::image type="content" source="media/quick-create-template/cloud-shell.png" alt-text="Screenshot showing the Cloud Shell option in the Azure portal.":::
 
 1. In the **Cloud Shell** window, select **PowerShell**.
 
-    ![Select PowerShell in the terminal window](media/quick-create-template/powershell.png)
+    :::image type="content" source="media/quick-create-template/powershell.png" alt-text="Screenshot showing the PowerShell option in Cloud Shell.":::
 
 1. Copy the following command and enter it at the command prompt to create a resource group.
 
     ```powershell
     New-AzResourceGroup -Name SimpleWinVmResourceGroup -Location EastUS
     ```
 
-    ![Copy a command into the command prompt](media/quick-create-template/command-prompt.png)
-
-1. Copy the following command and enter it at the command prompt to create a VM in the resource group.
+1. Next, copy the following command and enter it at the command prompt to create a VM in your new resource group.
 
     ```powershell
     New-AzVm `
         -ResourceGroupName "SimpleWinVmResourceGroup" `
-        -Name "SimpleWinVm" `
+        -Name "myVM1" `
         -Location "East US" 
     ```
 
 1. Enter a username and password for the VM. This is a new user name and password; it's not, for example, the account you use to sign in to Azure. For more information, see [username requirements](../virtual-machines/windows/faq.yml#what-are-the-username-requirements-when-creating-a-vm-) and [password requirements](../virtual-machines/windows/faq.yml#what-are-the-password-requirements-when-creating-a-vm-).
 
-    The VM deployment now starts and typically takes a few minutes to complete. After deployment completes, move on to the next section.
+    After the VM has been created, move on to the next section.
 
 ## Review the template
 
-The template used in this quickstart is from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/azure-portal-dashboard/). The template for this article is too long to show here. To view the template, see [azuredeploy.json](https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.portal/azure-portal-dashboard/azuredeploy.json). One Azure resource is defined in the template, [Microsoft.Portal/dashboards](/azure/templates/microsoft.portal/dashboards) - Create a dashboard in the Azure portal.
+The template used in this quickstart is from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/azure-portal-dashboard/). The template for this article is too long to show here. To view the template, see [azuredeploy.json](https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.portal/azure-portal-dashboard/azuredeploy.json). The template defines one Azure resource, a dashboard that displays data about the VM you created.
 
 ## Deploy the template
 
+This example uses the Azure portal to deploy the template. You can also use other methods to deploy ARM templates, such as [Azure PowerShell](../azure-resource-manager/templates/deploy-powershell.md), [Azure CLI](../azure-resource-manager/templates/deploy-cli.md), or [REST API](../azure-resource-manager/templates/deploy-rest.md).
+
 1. Select the following image to sign in to Azure and open a template.
 
     [![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.portal%2Fazure-portal-dashboard%2Fazuredeploy.json)
 
 1. Select or enter the following values, then select **Review + create**.
 
-    ![ARM template, create dashboard, deploy portal](media/quick-create-template/create-dashboard-using-template-portal.png)
+    :::image type="content" source="media/quick-create-template/create-dashboard-using-template-portal.png" alt-text="Screenshot of the dashboard template deployment screen in the Azure portal.":::
 
     Unless it's specified, use the default values to create the dashboard.
 
-    * **Subscription**: select an Azure subscription.
-    * **Resource group**: select **SimpleWinVmResourceGroup**.
-    * **Location**: select **East US**.
-    * **Virtual Machine Name**: enter **SimpleWinVm**.
-    * **Virtual Machine Resource Group**: enter **SimpleWinVmResourceGroup**.
-
-1. Select **Create** or **Purchase**. After the dashboard has been deployed successfully, you get a notification:
-
-    ![ARM template, create dashboard, deploy portal notification](media/quick-create-template/resource-manager-template-portal-deployment-notification.png)
+    - **Subscription**: select the Azure subscription.
+    - **Resource group**: select **SimpleWinVmResourceGroup**.
+    - **Location**: If not automatically selected, choose **East US**.
+    - **Virtual Machine Name**: enter **myVM1**.
+    - **Virtual Machine Resource Group**: enter **SimpleWinVmResourceGroup**.
 
-The Azure portal was used to deploy the template. In addition to the Azure portal, you can also use Azure PowerShell, Azure CLI, and REST API. To learn other deployment methods, see [Deploy templates](../azure-resource-manager/templates/deploy-powershell.md).
+1. Select **Create**. You'll see a notification confirming when the dashboard has been deployed successfully.
 
 ## Review deployed resources
 
@@ -94,7 +89,8 @@ If you want to remove the VM and associated dashboard, delete the resource group
 
 1. On the **SimpleWinVmResourceGroup** page, select **Delete resource group**, enter the resource group name to confirm, then select **Delete**.
 
-    ![Delete resource group](media/quick-create-template/delete-resource-group.png)
+> [!CAUTION]
+> Deleting a resource group will delete all of the resources contained within it. If the resource group contains additional resources aside from your virtual machine and dashboard, those resources will also be deleted.
 
 ## Next steps
 

articles/azure-portal/media/quick-create-template/command-prompt.png

@@ -3,115 +3,107 @@ title: Create an Azure portal dashboard with Azure CLI
 description: "Quickstart: Learn how to create a dashboard in the Azure portal using the Azure CLI. A dashboard is a focused and organized view of your cloud resources."
 ms.topic: quickstart
 ms.custom: devx-track-azurepowershell, devx-track-azurecli, mode-api
-ms.date: 12/4/2020
+ms.date: 01/13/2022
 ---
 
 # Quickstart: Create an Azure portal dashboard with Azure CLI
 
-A dashboard in the Azure portal is a focused and organized view of your cloud resources. This
-article focuses on the process of using Azure CLI to create a dashboard.
-The dashboard shows the performance of a virtual machine (VM), as well as some static information
-and links.
+A dashboard in the Azure portal is a focused and organized view of your cloud resources. This article shows you how to use Azure CLI to create a dashboard. In this example, the dashboard shows the performance of a virtual machine (VM), as well as some static information and links.
 
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 
 [!INCLUDE [azure-cli-prepare-your-environment.md](../../includes/azure-cli-prepare-your-environment.md)]
 
 - If you have multiple Azure subscriptions, choose the appropriate subscription in which to bill the resources.
-Select a subscription by using the [az account set](/cli/azure/account#az_account_set) command:
+Select a subscription by using the [az account set](/cli/azure/account#az-account-set) command:
 
   ```azurecli
   az account set --subscription 00000000-0000-0000-0000-000000000000
   ```
 
-- Create an [Azure resource group](../azure-resource-manager/management/overview.md) by using the [az group create](/cli/azure/group#az_group_create) command or use an existing resource group:
+- Create an [Azure resource group](../azure-resource-manager/management/overview.md#resource-groups) by using the [az group create](/cli/azure/group#az-group-create) command (or use an existing resource group):
 
   ```azurecli
   az group create --name myResourceGroup --location centralus
   ```
 
-   A resource group is a logical container in which Azure resources are deployed and managed as a group.
-
 ## Create a virtual machine
 
-Create a virtual machine by using the [az vm create](/cli/azure/vm#az_vm_create) command:
+Create a virtual machine by using the [az vm create](/cli/azure/vm#az-vm-create) command:
 
 ```azurecli
-az vm create --resource-group myResourceGroup --name SimpleWinVM --image win2016datacenter \
+az vm create --resource-group myResourceGroup --name myVM1 --image win2016datacenter \
    --admin-username azureuser --admin-password 1StrongPassword$
 ```
 
 > [!Note]
-> The password must be complex.
-> This is a new user name and password.
-> It's not, for example, the account you use to sign in to Azure.
-> For more information, see [username requirements](../virtual-machines/windows/faq.yml#what-are-the-username-requirements-when-creating-a-vm-)
+> This is a new username and password (not the account you use to sign in to Azure). The password must be complex. For more information, see [username requirements](../virtual-machines/windows/faq.yml#what-are-the-username-requirements-when-creating-a-vm-)
 and [password requirements](../virtual-machines/windows/faq.yml#what-are-the-password-requirements-when-creating-a-vm-).
 
 The deployment starts and typically takes a few minutes to complete.
-After deployment completes, move on to the next section.
 
 ## Download the dashboard template
 
-Since Azure dashboards are resources, they can be represented as JSON.
-For more information, see [The structure of Azure Dashboards](./azure-portal-dashboards-structure.md).
+Since Azure dashboards are resources, they can be represented as JSON. For more information, see [The structure of Azure dashboards](./azure-portal-dashboards-structure.md).
 
-Download the following file: [portal-dashboard-template-testvm.json](https://raw.githubusercontent.com/Azure/azure-docs-powershell-samples/master/azure-portal/portal-dashboard-template-testvm.json).
+Download the file [portal-dashboard-template-testvm.json](https://raw.githubusercontent.com/Azure/azure-docs-powershell-samples/master/azure-portal/portal-dashboard-template-testvm.json).
 
-Customize the downloaded template by changing the following values to your values:
+Then, customize the downloaded template file by changing the following to your values:
 
-* `<subscriptionID>`: Your subscription
-* `<rgName>`: Resource group, for example `myResourceGroup`
-* `<vmName>`: Virtual machine name, for example `SimpleWinVM`
-* `<dashboardTitle>`: Dashboard title, for example `Simple VM Dashboard`
-* `<location>`: Your Azure region, for example, `centralus`
+- `<subscriptionID>`: Your subscription
+- `<rgName>`: Resource group, for example `myResourceGroup`
+- `<vmName>`: Virtual machine name, for example `myVM1`
+- `<dashboardTitle>`: Dashboard title, for example `Simple VM Dashboard`
+- `<location>`: Your Azure region, for example `centralus`
 
 For more information, see [Microsoft portal dashboards template reference](/azure/templates/microsoft.portal/dashboards).
 
 ## Deploy the dashboard template
 
 You can now deploy the template from within Azure CLI.
 
-1. Run the [az portal dashboard create](/cli/azure/portal/dashboard#az_portal_dashboard_create) command to deploy the template:
+1. Run the [az portal dashboard create](/cli/azure/portal/dashboard#az-portal-dashboard-create) command to deploy the template:
 
    ```azurecli
    az portal dashboard create --resource-group myResourceGroup --name 'Simple VM Dashboard' \
       --input-path portal-dashboard-template-testvm.json --location centralus
    ```
 
-1. Check that the dashboard was created successfully by running the [az portal dashboard show](/cli/azure/portal/dashboard#az_portal_dashboard_show) command:
+1. Check that the dashboard was created successfully by running the [az portal dashboard show](/cli/azure/portal/dashboard#az-portal-dashboard-show) command:
 
    ```azurecli
    az portal dashboard show --resource-group myResourceGroup --name 'Simple VM Dashboard'
    ```
 
-To see all the dashboards for the current subscription, use [az portal dashboard list](/cli/azure/portal/dashboard#az_portal_dashboard_list):
+To see all the dashboards for the current subscription, use [az portal dashboard list](/cli/azure/portal/dashboard#az-portal-dashboard-list):
 
 ```azurecli
 az portal dashboard list
 ```
 
-You can also see all the dashboards for a resource group:
+You can also see all the dashboards for a specific resource group:
 
 ```azurecli
 az portal dashboard list --resource-group myResourceGroup
 ```
 
-You can update a dashboard by using the [az portal dashboard update](/cli/azure/portal/dashboard#az_portal_dashboard_update) command:
+To update a dashboard, use the [az portal dashboard update](/cli/azure/portal/dashboard#az-portal-dashboard-update) command:
 
 ```azurecli
 az portal dashboard update --resource-group myResourceGroup --name 'Simple VM Dashboard' \
    --input-path portal-dashboard-template-testvm.json --location centralus
 ```
 
+## Review deployed resources
+
 [!INCLUDE [azure-portal-review-deployed-resources](../../includes/azure-portal-review-deployed-resources.md)]
 
 ## Clean up resources
 
-To remove the virtual machine and associated dashboard, delete the resource group that contains them.
+To remove the virtual machine and associated dashboard that you created, delete the resource group that contains them.
 
 > [!CAUTION]
-> The following example deletes the specified resource group and all resources contained within it.
-> If resources outside the scope of this article exist in the specified resource group, they will also be deleted.
+> Deleting the resource group will delete all of the resources contained within it. If the resource group contains additional resources aside from your virtual machine and dashboard, those resources will also be deleted.
 
 ```azurecli
 az group delete --name myResourceGroup
@@ -125,4 +117,7 @@ az portal dashboard delete --resource-group myResourceGroup --name "Simple VM Da
 
 ## Next steps
 
-For more information about Azure CLI support for dashboards, see [az portal dashboard](/cli/azure/portal/dashboard).
+For more information about Azure CLI commands for dashboards, see:
+
+> [!div class="nextstepaction"]
+> [Azure CLI: az portal dashboard](/cli/azure/portal/dashboard).