Merge pull request #115333 from sethmanheim/arm

Add NH resource manager quickstart

Author: v-dihans

articles/notification-hubs/TOC.yml

@@ -9,10 +9,12 @@
 - name: Quickstarts
   expanded: true
   items:
-  - name: Create a notification hub - Azure portal
+  - name: Create notification hub - Azure portal
     href: create-notification-hub-portal.md  
-  - name: Create a notification hub - Azure CLI
-    href: create-notification-hub-azure-cli.md 
+  - name: Create notification hub - Azure CLI
+    href: create-notification-hub-azure-cli.md
+  - name: Create notification hub - Azure Resource Manager template
+    href: create-notification-hub-template.md
   - name: Configure a notification hub
     href: configure-notification-hub-portal-pns-settings.md  
 - name: Tutorials

articles/notification-hubs/create-notification-hub-template.md

@@ -0,0 +1,90 @@
+---
+title: Create an Azure notification hub using Azure Resource Manager template
+description: Learn how to create an Azure notification hub by using an Azure Resource Manager template.
+services: notification-hubs
+author: sethmanheim
+
+ms.service: notification-hubs
+ms.topic: quickstart
+ms.custom: subject-armqs
+ms.author: sethm
+ms.date: 05/15/2020
+ms.reviewer: thsomasu
+ms.lastreviewed: 05/15/2020
+---
+
+# Quickstart: create a notification hub using an Azure Resource Manager template
+
+Azure Notification Hubs provides an easy-to-use and scaled-out push engine that enables you to send notifications to any platform (iOS, Android, Windows, Kindle, etc.) from any backend (cloud or on-premises). For more information about the service, see [What is Azure Notification Hubs](notification-hubs-push-notification-overview.md).
+
+This quickstart uses an Azure Resource Manager template to create an Azure Notification Hubs namespace, and a notification hub named "MyHub" within that namespace.
+
+[!INCLUDE [About Azure Resource Manager](../../includes/resource-manager-quickstart-introduction.md)]
+
+If you don't have an Azure subscription, create a [free](https://azure.microsoft.com/free/) account before you begin.
+
+## Prerequisites
+
+None.
+
+## Create a Notification Hubs namespace and hub
+
+<!-- The second H2 must start with "Create a". For example,  'Create a Key Vault', 'Create a virtual machine', etc. -->
+
+### Review the template
+
+The template used in this quickstart is from [Azure Quickstart templates](https://azure.microsoft.com/resources/templates/101-notification-hub/).
+
+:::code language="json" source="~/quickstart-templates/101-notification-hub/azuredeploy.json" range="1-45" highlight="22-40":::
+
+* [Microsoft.NotificationHubs/namespaces](/azure/templates/microsoft.notificationhubs/2017-04-01/namespaces)
+* [Microsoft.NotificationHubs/namespaces/notificationHubs](/azure/templates/microsoft.notificationhubs/2017-04-01/namespaces/notificationhubs)
+
+## Deploy the template
+
+Select the following image to sign in to Azure and open a template. The template takes a Notification Hubs namespace name as a parameter. The template then creates a namespace with that name and a notification hub named **MyHub** within that namespace.
+
+[![Deploy to Azure](./media/create-notification-hub-template/deploy-to-azure.png)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2F101-notification-hub%2Fazuredeploy.json)
+
+## Review deployed resources
+
+You can either use the Azure portal to check the deployed resources, or use Azure CLI or Azure PowerShell script to list the deployed Notification Hubs namespace and hub:
+
+# [PowerShell](#tab/PowerShell)
+
+```azurepowershell-interactive
+Get-AzNotificationHub -Namespace "nhtestns123" -ResourceGroup "ContosoNotificationsGroup"
+Get-AzNotificationHubsNamespace -Namespace "nhtestns123"
+```
+
+# [CLI](#tab/CLI)
+
+```azurecli-interactive
+az notification-hub show --resource-group ContosoNotificationsGroup --namespace-name nhtestns123 --name MyHub
+az notification-hub namespace show --resource-group ContosoNotificationsGroup --name nhtestns123
+```
+
+---
+
+The output looks similar to:
+
+:::image type="content" source="media/create-notification-hub-template/verify-deploy.png" alt-text="Verify deployment":::
+
+---
+
+## Clean up resources
+
+When no longer needed, delete the resource group, which deletes the resources in the resource group.
+
+```azurepowershell-interactive
+$resourceGroupName = Read-Host -Prompt "Enter the resource group name"
+Remove-AzResourceGroup -Name $resourceGroupName
+Write-Host "Press [ENTER] to continue..."
+```
+
+## Next steps
+
+For a step-by-step tutorial that guides you through the process of creating a template, see:
+
+> [!div class="nextstepaction"]
+> [Tutorial: Create and deploy your first Azure Resource Manager template](/azure/azure-resource-manager/templates/template-tutorial-create-first-template.md)