Merge pull request #49916 from robinsh/robinsh-iot-set5

IoT Hub cleanup set 5

Author: Ja-Dunn

.openpublishing.redirection.json

@@ -165,6 +165,12 @@
             "redirect_url": "/azure/iot-fundamentals/iot-introduction",
             "redirect_document_id": false
         },
+
+        {
+            "source_path": "articles/iot-hub/iot-hub-create-using-cli-nodejs.md",
+            "redirect_url": "/azure/iot-hub/iot-hub-create-using-cli",
+            "redirect_document_id": true
+        },
         {
             "source_path": "articles/cognitive-services/custom-decision-service/custom-decision-service-tutorial-analytics.md",
             "redirect_url": "/azure/cognitive-services/custom-decision-service",

articles/iot-hub/TOC.yml

@@ -224,8 +224,6 @@
         href: iot-hub-create-using-powershell.md
       - name: Use Azure CLI
         href: iot-hub-create-using-cli.md
-      - name: Use CLI
-        href: iot-hub-create-using-cli-nodejs.md
       - name: Use the REST API
         href: iot-hub-rm-rest.md
       - name: Use a template from Azure PowerShell

articles/iot-hub/iot-hub-create-use-iot-toolkit.md

@@ -13,12 +13,14 @@ ms.author: junhan
 
 [!INCLUDE [iot-hub-resource-manager-selector](../../includes/iot-hub-resource-manager-selector.md)]
 
-You can use [Azure IoT Toolkit for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) to create Azure IoT hubs. This article shows you how to create an IoT hub with Azure IoT Toolkit.
+This article shows you how to use the [Azure IoT Toolkit for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) to create an Azure IoT hub. 
 
 To complete this article, you need the following:
 
-* An active Azure account.
+- An Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+
 - [Visual Studio Code](https://code.visualstudio.com/)
+
 - [Azure IoT Toolkit](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit)
 
 ## Create an IoT hub
@@ -49,8 +51,10 @@ To complete this article, you need the following:
 
 ## Next steps
 
-Now you have deployed an IoT hub using Azure IoT Toolkit for Visual Studio Code, you may want to explore further:
+Now you have deployed an IoT hub using the Azure IoT Toolkit for Visual Studio Code. To explore further, check out the following articles:
+
+* [Use the Azure IoT Toolkit extension for Visual Studio Code to send and receive messages between your device and an IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
+
+* [Use the Azure IoT Toolkit extension for Visual Studio Code for Azure IoT Hub device management](iot-hub-device-management-iot-toolkit.md)
 
-* [Use Azure IoT Toolkit extension for Visual Studio Code to send and receive messages between your device and IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
-* [Use Azure IoT Toolkit extension for Visual Studio Code for Azure IoT Hub device management](iot-hub-device-management-iot-toolkit.md)
-* [Wiki page](https://github.com/microsoft/vscode-azure-iot-toolkit/wiki) for Azure IoT Toolkit.
+* [See the Azure IoT Toolkit wiki page](https://github.com/microsoft/vscode-azure-iot-toolkit/wiki).

articles/iot-hub/iot-hub-create-using-cli-nodejs.md

@@ -1,119 +1,88 @@
 ---
-title: Create an IoT Hub using Azure CLI (az.py) | Microsoft Docs
-description: How to create an Azure IoT hub using the cross-platform Azure CLI 2.0 (az.py).
-author: dominicbetts
-manager: timlt
+title: Create an IoT Hub using Azure CLI | Microsoft Docs
+description: How to create an Azure IoT hub using Azure CLI.
+author: robinsh
 ms.service: iot-hub
 services: iot-hub
 ms.topic: conceptual
-ms.date: 06/16/2017
-ms.author: dobett
+ms.date: 08/23/2018
+ms.author: robinsh
 ---
 
-# Create an IoT hub using the Azure CLI 2.0
+# Create an IoT hub using Azure CLI
 
 [!INCLUDE [iot-hub-resource-manager-selector](../../includes/iot-hub-resource-manager-selector.md)]
 
-## Introduction
+This article shows you how to create an IoT hub using Azure CLI.
 
-You can use Azure CLI 2.0 (az.py) to create and manage Azure IoT hubs programmatically. This article shows you how to use the Azure CLI 2.0 (az.py) to create an IoT hub.
+## Prerequisites
 
-You can complete the task using one of the following CLI versions:
+To complete this how-to, you need an Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
-* [Azure CLI (azure.js)](iot-hub-create-using-cli-nodejs.md) – the CLI for the classic and resource management deployment models.
-* Azure CLI 2.0 (az.py) - the next generation CLI for the resource management deployment model as described in this article.
-
-To complete this tutorial, you need the following:
-
-* An active Azure account. If you don't have an account, you can create a [free account][lnk-free-trial] in just a couple of minutes.
-* [Azure CLI 2.0][lnk-CLI-install].
+[!INCLUDE [cloud-shell-try-it.md](../../includes/cloud-shell-try-it.md)]
 
 ## Sign in and set your Azure account
 
-Sign in to your Azure account and select your subscription.
-
-1. At the command prompt, run the [login command][lnk-login-command]:
-    
-    ```azurecli
-    az login
-    ```
+If you are running Azure CLI locally instead of using Cloud Shell, you need to sign in to your Azure account.
 
-    Follow the instructions to authenticate using the code and sign in to your Azure account through a web browser.
+At the command prompt, run the [login command](https://docs.microsoft.com/cli/azure/get-started-with-azure-cli):
 
-2. If you have multiple Azure subscriptions, signing in to Azure grants you access to all the Azure accounts associated with your credentials. Use the following [command to list the Azure accounts][lnk-az-account-command] available for you to use:
-    
     ```azurecli
-    az account list 
+    az login
     ```
 
-    Use the following command to select subscription that you want to use to run the commands to create your IoT hub. You can use either the subscription name or ID from the output of the previous command:
-
-    ```azurecli
-    az account set --subscription {your subscription name or id}
-    ```
+Follow the instructions to authenticate using the code and sign in to your Azure account through a web browser.
 
 ## Create an IoT Hub
 
 Use the Azure CLI to create a resource group and then add an IoT hub.
 
-1. When you create an IoT hub, you must create it in a resource group. Either use an existing resource group, or run the following [command to create a resource group][lnk-az-resource-command]:
+1. When you create an IoT hub, you must create it in a resource group. Either use an existing resource group, or run the following [command to create a resource group](https://docs.microsoft.com/cli/azure/resource):
 
-    ```azurecli
-     az group create --name {your resource group name} --location westus
-    ```
-
-    > [!TIP]
-    > The previous example creates the resource group in the West US location. You can view a list of available locations by running the command `az account list-locations -o table`.
-    >
-    >
-
-2. Run the following [command to create an IoT hub][lnk-az-iot-command] in your resource group, using a globally unique name for your IoT hub:
+   ```azurecli
+   az group create --name {your resource group name} --location westus
+   ```
+
+   > [!TIP]
+   > The previous example creates the resource group in the West US location. You can view a list of available locations by running this command: 
+   >
+   >``` bash
+   >az account list-locations -o table
+   >```
+   >
+
+2. Run the following [command to create an IoT hub](https://docs.microsoft.com/cli/azure/iot/hub#az-iot-hub-create) in your resource group, using a globally unique name for your IoT hub:
     
-    ```azurecli
-    az iot hub create --name {your iot hub name} --resource-group {your resource group name} --sku S1
-    ```
+   ```azurecli
+   az iot hub create --name {your iot hub name} \
+      --resource-group {your resource group name} --sku S1
+   ```
 
    [!INCLUDE [iot-hub-pii-note-naming-hub](../../includes/iot-hub-pii-note-naming-hub.md)]
 
 
-> [!NOTE]
-> The previous command creates an IoT hub in the S1 pricing tier for which you are billed. For more information, see [Azure IoT Hub pricing][lnk-iot-pricing].
->
+The previous command creates an IoT hub in the S1 pricing tier for which you are billed. For more information, see [Azure IoT Hub pricing](https://azure.microsoft.com/pricing/details/iot-hub/).
 
 ## Remove an IoT Hub
 
-You can use the Azure CLI to [delete an individual resource][lnk-az-resource-command], such as an IoT hub, or delete a resource group and all its resources, including any IoT hubs.
+You can use Azure CLI to [delete an individual resource](https://docs.microsoft.com/cli/azure/resource), such as an IoT hub, or delete a resource group and all its resources, including any IoT hubs.
 
-To delete an IoT hub, run the following command:
+To [delete an IoT hub](https://docs.microsoft.com/cli/azure/iot/hub#az-iot-hub-delete), run the following command:
 
 ```azurecli
-az iot hub delete --name {your iot hub name} --resource-group {your resource group name}
+az iot hub delete --name {your iot hub name} -\
+  -resource-group {your resource group name}
 ```
 
-To delete a resource group and all its resources, run the following command:
+To [delete a resource group](https://docs.microsoft.com/cli/azure/group#az-group-delete) and all its resources, run the following command:
 
 ```azurecli
 az group delete --name {your resource group name}
 ```
 
 ## Next steps
-To learn more about developing for IoT Hub, see the following articles:
-
-* [IoT Hub developer guide][lnk-devguide]
-
-To further explore the capabilities of IoT Hub, see:
-
-* [Using the Azure portal to manage IoT Hub][lnk-portal]
-
-<!-- Links -->
-[lnk-free-trial]: https://azure.microsoft.com/pricing/free-trial/
-[lnk-CLI-install]: https://docs.microsoft.com/cli/azure/install-az-cli2
-[lnk-login-command]: https://docs.microsoft.com/cli/azure/get-started-with-az-cli2
-[lnk-az-account-command]: https://docs.microsoft.com/cli/azure/account
-[lnk-az-register-command]: https://docs.microsoft.com/cli/azure/provider
-[lnk-az-addcomponent-command]: https://docs.microsoft.com/cli/azure/component
-[lnk-az-resource-command]: https://docs.microsoft.com/cli/azure/resource
-[lnk-az-iot-command]: https://docs.microsoft.com/cli/azure/iot
-[lnk-iot-pricing]: https://azure.microsoft.com/pricing/details/iot-hub/
-[lnk-devguide]: iot-hub-devguide.md
-[lnk-portal]: iot-hub-create-through-portal.md 
+
+To learn more about using an IoT hub, see the following articles:
+
+* [IoT Hub developer guide](iot-hub-devguide.md)
+* [Using the Azure portal to manage IoT Hub](iot-hub-create-through-portal.md)