[Azure portal] - add Bicep quickstart

Author: mumian

articles/azure-portal/quick-create-bicep.md

@@ -0,0 +1,98 @@
+---
+title: Create an Azure portal dashboard by using a Bicep file
+description: Learn how to create an Azure portal dashboard by using a Bicep file.
+ms.topic: quickstart
+ms.custom: subject-bicepqs,
+ms.date: 09/07/2022
+---
+
+# Quickstart: Create a dashboard in the Azure portal by using a Bicep file
+
+A dashboard in the Azure portal is a focused and organized view of your cloud resources. This quickstart focuses on the process of deploying a Bicep file to create a dashboard. The dashboard shows the performance of a virtual machine (VM), as well as some static information and links.
+
+[!INCLUDE [About Bicep](../../includes/resource-manager-quickstart-bicep-introduction.md)]
+
+## Prerequisites
+
+- 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** 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.":::
+
+1. 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.":::
+
+1. Copy the following command and enter it at the command prompt to create a resource group.
+
+    ```powershell
+    New-AzResourceGroup -Name SimpleWinVmResourceGroup -Location EastUS
+    ```
+
+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 "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-).
+
+    After the VM has been created, move on to the next section.
+
+## Review the Bicep file
+
+The Bicep file used in this quickstart is from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/azure-portal-dashboard/). The Bicep file for this article is too long to show here. To view the Bicep file, see [main.bicep](https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.portal/azure-portal-dashboard/main.bicep). The Bicep file defines one Azure resource, a dashboard that displays data about the VM you created:
+
+- [Microsoft.Portal/dashboards](/azure/templates/microsoft.portal/dashboards?pivots=deployment-language-bicep)
+
+## Deploy the Bicep file
+
+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**.
+
+    :::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**.
+
+1. Select **Create**. You'll see a notification confirming when the dashboard has been deployed successfully.
+
+## Review deployed resources
+
+[!INCLUDE [azure-portal-review-deployed-resources](../../includes/azure-portal-review-deployed-resources.md)]
+
+## 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.
+
+1. 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](azure-portal-dashboards.md)