Merge pull request #108719 from dbradish-microsoft/dbradish_notificationHubs2

PMEds28 · web-flow · commit a4c71fc0fae9 · 2020-03-27T07:40:14.000Z
added Azure CLI syntax for Google FCM
diff --git a/articles/notification-hubs/TOC.yml b/articles/notification-hubs/TOC.yml
@@ -13,7 +13,7 @@
     href: create-notification-hub-portal.md  
   - name: Create a notification hub - Azure CLI
     href: create-notification-hub-azure-cli.md 
-  - name: Configure a notification hub - Azure portal
+  - name: Configure a notification hub
     href: configure-notification-hub-portal-pns-settings.md  
 - name: Tutorials
   items:
diff --git a/articles/notification-hubs/configure-notification-hub-portal-pns-settings.md b/articles/notification-hubs/configure-notification-hub-portal-pns-settings.md
@@ -4,7 +4,7 @@ description: Learn how to set up Azure Notification Hubs in the Azure portal by
 services: notification-hubs
 author: sethmanheim
 manager: femila
-editor: jwargo
+editor: dbradish-microsoft
 
 ms.service: notification-hubs
 ms.workload: mobile
@@ -15,13 +15,13 @@ ms.reviewer: jowargo
 ms.lastreviewed: 02/14/2019
 ---
 
-# Set up push notifications in a notification hub in the Azure portal
+# Quickstart: Set up push notifications in a notification hub
 
 Azure Notification Hubs provides a push engine that's easy to use and that scales out. Use Notification Hubs to send notifications to any platform (iOS, Android, Windows, Baidu) and from any back end (cloud or on-premises). For more information, see [What is Azure Notification Hubs?](notification-hubs-push-notification-overview.md).
 
-In this quickstart, you'll use the platform notification system (PNS) settings in Notification Hubs to set up push notifications on multiple platforms. The quickstart shows you the steps to take in the Azure portal.
+In this quickstart, you'll use the platform notification system (PNS) settings in Notification Hubs to set up push notifications on multiple platforms. The quickstart shows you the steps to take in the Azure portal.  [Google Firebase Cloud Messaging](/azure/notification-hubs/configure-notification-hub-portal-pns-settings?tabs=azure-cli#google-firebase-cloud-messaging-fcm) includes instructions for using the Azure CLI.
 
-If you haven't already created a notification hub, create one now. For more information, see [Create an Azure notification hub in the Azure portal](create-notification-hub-portal.md). 
+If you haven't already created a notification hub, create one now. For more information, see [Create an Azure notification hub in the Azure portal](create-notification-hub-portal.md) or [Create an Azure notification hub using the Azure CLI](create-notification-hub-azure-cli.md)
 
 ## Apple Push Notification Service
 
@@ -47,19 +47,67 @@ To set up Apple Push Notification Service (APNS):
 
 For more information, see [Push notifications to iOS by using Azure Notification Hubs](notification-hubs-ios-apple-push-notification-apns-get-started.md).
 
-## Google Firebase Cloud Messaging
+## Google Firebase Cloud Messaging (FCM)
 
-To set up push notifications for Google Firebase Cloud Messaging (FCM):
+# [Portal](#tab/azure-portal)
 
-1. In the Azure portal, on the **Notification Hub** page, select **Google (GCM/FCM)** from the left menu. 
-2. Paste the **API Key** for the FCM project that you saved earlier. 
-3. Select **Save**. 
+To set up push notifications for Google FCM:
+
+1. In the Azure portal, on the **Notification Hub** page, select **Google (GCM/FCM)** from the left menu.
+2. Paste the **API Key** for the Google FCM project that you saved earlier.
+3. Select **Save**.
 
    ![Screenshot that shows how to configure Notification Hubs for Google FCM](./media/notification-hubs-android-push-notification-google-fcm-get-started/fcm-server-key.png)
 
-When you complete these steps, an alert indicates that the notification hub has been successfully updated. The **Save** button is disabled. 
+When you complete these steps, an alert indicates that the notification hub has been successfully updated. The **Save** button is disabled.
+
+# [Azure CLI](#tab/azure-cli)
+
+### Prerequisites
+
+Before you begin, you must have the following:
+
+* The [Azure CLI](/cli/azure/install-azure-cli) version 2.0.67 or later.
+
+* The Azure CLI [extension for Notification Hubs](/cli/azure/ext/notification-hub/notification-hub).
+* The **API Key** for a Google Firebase Cloud Messaging (FCM) project.
+
+### Set up push notifications for Google FCM
+
+1. Use the [az notification-hub credential gcm update](/cli/azure/ext/notification-hub/notification-hub/credential/gcm#ext-notification-hub-az-notification-hub-credential-gcm-update) command to add your Google API Key to your notification hub.
+
+   ```azurecli
+   az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey
+   ```
+
+2. The Android App needs a connection string to connect with the notification hub.  Use the [az notification-hub authorization-rule list](/cli/azure/ext/notification-hub/notification-hub/authorization-rule#ext-notification-hub-az-notification-hub-authorization-rule-list) command to list the available access policies.  Use the [az notification-hub authorization-rule list-keys](/cli/azure/ext/notification-hub/notification-hub/authorization-rule#ext-notification-hub-az-notification-hub-authorization-rule-list-keys) command to get the access policy connection strings.  Specify the **primaryConnectionString** or **secondaryConnectionString** in the `--query` parameter to get the primary connection string directly.
 
-For more information, see [Push notifications to Android devices by using Notification Hubs and Google FCM](notification-hubs-android-push-notification-google-fcm-get-started.md).
+   ```azurecli
+   #list access policies for a notification hub
+   az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table
+
+   #list keys and connection strings for a notification hub access policy
+   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --output json
+
+   #get the primaryConnectionString for an access policy
+   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --query primaryConnectionString
+   ```
+
+3. Use the [az notification-hub test-send](/cli/azure/ext/notification-hub/notification-hub#ext-notification-hub-az-notification-hub-test-send) command to test sending messages to the Android App.
+
+   ```azurecli
+   #test with message body
+   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --message "my message body"
+
+   #test with JSON string
+   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --payload "{\"data\":{\"message\":\"my JSON string\"}}"
+   ```
+
+Get Azure CLI references for other platforms with the [az notification-hub credential](/cli/azure/ext/notification-hub/notification-hub/credential) command.
+
+---
+
+For more information on pushing notifications to an Android application, see [Send push notifications to Android devices using Firebase](notification-hubs-android-push-notification-google-fcm-get-started.md).
 
 ## Windows Push Notification Service
 
@@ -75,7 +123,7 @@ For information, see [Send notifications to UWP apps by using Azure Notification
 
 ## Microsoft Push Notification Service for Windows Phone
 
-To set up Microsoft Push Notification Service (MPNS) for Windows Phone: 
+To set up Microsoft Push Notification Service (MPNS) for Windows Phone:
 
 1. In the Azure portal, on the **Notification Hub** page, select **Windows Phone (MPNS)** from the left menu.
 1. Enable either unauthenticated or authenticated push notifications:
@@ -92,30 +140,30 @@ To set up Microsoft Push Notification Service (MPNS) for Windows Phone:
       * On the **Windows Phone (MPNS)** page, select **Save**.
 
 For more information, see [Push notifications to Windows Phone apps by using Notification Hubs](notification-hubs-windows-mobile-push-notifications-mpns.md).
-      
 
 ## Baidu (Android China)
 
 To set up push notifications for Baidu:
 
-1. In the Azure portal, on the **Notification Hub** page, select **Baidu (Android China)** from the left menu. 
-2. Enter the **Api Key** that you obtained from the Baidu console in the Baidu cloud push project. 
-3. Enter the **Secret Key** that you obtained from the Baidu console in the Baidu cloud push project. 
-4. Select **Save**. 
+1. In the Azure portal, on the **Notification Hub** page, select **Baidu (Android China)** from the left menu.
+2. Enter the **Api Key** that you obtained from the Baidu console in the Baidu cloud push project.
+3. Enter the **Secret Key** that you obtained from the Baidu console in the Baidu cloud push project.
+4. Select **Save**.
 
     ![Screenshot of Notification Hubs that shows the Baidu (Android China) configuration for push notifications](./media/notification-hubs-baidu-get-started/AzureNotificationServicesBaidu.png)
 
-When you complete these steps, an alert indicates that the notification hub has been successfully updated. The **Save** button is disabled. 
+When you complete these steps, an alert indicates that the notification hub has been successfully updated. The **Save** button is disabled.
 
 For more information, see [Get started with Notification Hubs by using Baidu](notification-hubs-baidu-china-android-notifications-get-started.md).
 
 ## Next steps
-In this quickstart, you learned how to configure platform notification system settings for a notification hub in the Azure portal. 
+
+In this quickstart, you learned how to configure platform notification system settings for a notification hub in the Azure portal.
 
 To learn more about how to push notifications to various platforms, see these tutorials:
 
-- [Push notifications to iOS devices by using Notification Hubs and APNS](notification-hubs-ios-apple-push-notification-apns-get-started.md)
-- [Push notifications to Android devices by using Notification Hubs and Google FCM](notification-hubs-android-push-notification-google-fcm-get-started.md)
-- [Push notifications to a UWP app running on a Windows device](notification-hubs-windows-store-dotnet-get-started-wns-push-notification.md)
-- [Push notifications to a Windows Phone 8 app by using MPNS](notification-hubs-windows-mobile-push-notifications-mpns.md)
-- [Push notifications by using Notification Hubs and Baidu cloud push](notification-hubs-baidu-china-android-notifications-get-started.md)
+-[Push notifications to iOS devices by using Notification Hubs and APNS](notification-hubs-ios-apple-push-notification-apns-get-started.md)
+-[Push notifications to Android devices by using Notification Hubs and Google FCM](notification-hubs-android-push-notification-google-fcm-get-started.md)
+-[Push notifications to a UWP app running on a Windows device](notification-hubs-windows-store-dotnet-get-started-wns-push-notification.md)
+-[Push notifications to a Windows Phone 8 app by using MPNS](notification-hubs-windows-mobile-push-notifications-mpns.md)
+-[Push notifications by using Notification Hubs and Baidu cloud push](notification-hubs-baidu-china-android-notifications-get-started.md)
diff --git a/articles/notification-hubs/create-notification-hub-portal.md b/articles/notification-hubs/create-notification-hub-portal.md
@@ -15,7 +15,7 @@ ms.reviewer: jowargo
 ms.lastreviewed: 02/14/2019
 ---
 
-# Create an Azure notification hub in the Azure portal 
+# Quickstart: Create an Azure notification hub in the Azure portal 
 Azure Notification Hubs provide an easy-to-use and scaled-out push engine that allows you to send notifications to any platform (iOS, Android, Windows, Kindle, Baidu, 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).
 
 In this quickstart, you create a notification hub in the Azure portal. The first section gives you steps to create a Notification Hubs namespace and a hub in that namespace. The second section gives you steps to create a notification hub in an existing Notification Hubs namespace. 
