Skip to content

Files

Latest commit

GitHubber17GitHubber17
fix Acrolinx issues
Jan 13, 2022
9642fd0 · Jan 13, 2022

History

History
100 lines (60 loc) · 5.78 KB

quick-create-template.md

File metadata and controls

100 lines (60 loc) · 5.78 KB
title description ms.topic ms.custom ms.date
Create an Azure portal dashboard by using an Azure Resource Manager template
Learn how to create an Azure portal dashboard by using an Azure Resource Manager template.
quickstart
subject-armqs, mode-arm
01/13/2022

Quickstart: Create a dashboard in the Azure portal by using an ARM template

A dashboard in the Azure portal is a focused and organized view of your cloud resources. This quickstart focuses on the process of deploying an Azure Resource Manager template (ARM template) to create a dashboard. The dashboard shows the performance of a virtual machine (VM), as well as some static information and links.

[!INCLUDE About Azure Resource Manager]

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.

Deploy to Azure

Prerequisites

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 from the global controls at the top of the page.

    :::image type="content" source="media/quick-create-template/cloud-shell.png" alt-text="Screenshot showing the Cloud Shell option in the Azure portal.":::

  2. In the Cloud Shell window, select PowerShell.

    :::image type="content" source="media/quick-create-template/powershell.png" alt-text="Screenshot showing the PowerShell option in Cloud Shell.":::

  3. Copy the following command and enter it at the command prompt to create a resource group.

    New-AzResourceGroup -Name SimpleWinVmResourceGroup -Location EastUS

  4. Next, copy the following command and enter it at the command prompt to create a VM in your new resource group.

    New-AzVm `
    -ResourceGroupName "SimpleWinVmResourceGroup" `
    -Name "myVM1" `
    -Location "East US"

  5. 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 and password requirements.

    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. The template for this article is too long to show here. To view the template, see 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 CLI, or REST API.

  1. Select the following image to sign in to Azure and open a template.

    Deploy to Azure

  2. Select or enter the following values, then select Review + create.

    :::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 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.

  3. Select Create. You'll see a notification confirming when the dashboard has been deployed successfully.

Review deployed resources

[!INCLUDE azure-portal-review-deployed-resources]

Clean up resources

If you want to remove the VM and associated dashboard, delete the resource group that contains them.

  1. In the Azure portal, search for SimpleWinVmResourceGroup, then select it in the search results.

  2. On the SimpleWinVmResourceGroup page, select Delete resource group, enter the resource group name to confirm, then select Delete.

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

For more information about dashboards in the Azure portal, see:

[!div class="nextstepaction"] Create and share dashboards in the Azure portal