Merge pull request #210347 from w-azure/winona-hub-manage

Added missing ToC item

Author: v-stsavell

articles/iot-hub/TOC.yml

@@ -407,6 +407,7 @@
               href: iot-hub-create-using-powershell.md
             - name: Use Azure CLI
               displayName: create IoT Hub, change settings, shared access policies, register device, message routing, delete IoT hub, az iot hub create
+              href: iot-hub-create-using-cli.md
             - name: Use the REST API
               displayName: create IoT Hub, change settings, shared access policies, register device, message routing, delete IoT hub, cmdlets, Azure Resource Manager, token
               href: iot-hub-rm-rest.md

articles/iot-hub/iot-hub-create-using-powershell.md

@@ -21,11 +21,13 @@ You can use Azure PowerShell cmdlets to create and manage Azure IoT hubs. This t
 
 [!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
 
+Alternatively, you can use Azure Cloud Shell, if you'd rather not install additional modules onto your machine. The following section gets you started with Azure Cloud Shell.
+
 [!INCLUDE [cloud-shell-try-it.md](../../includes/cloud-shell-try-it.md)]
 
 ## Connect to your Azure subscription
 
-If you're using the Cloud Shell, you're already logged in to your subscription. If you're running PowerShell locally instead, enter the following command to sign in to your Azure subscription:
+If you're using Cloud Shell, you're already logged in to your subscription, so you can skip this step. If you're running PowerShell locally instead, enter the following command to sign in to your Azure subscription:
 
 ```powershell
 # Log into Azure account.

articles/iot-hub/iot-hub-managed-identity.md

@@ -12,15 +12,15 @@ ms.custom: subject-rbac-steps
 
 # IoT Hub support for managed identities 
 
-Managed identities provide Azure services with an automatically managed identity in Azure AD in a secure manner. This eliminates the needs for developers having to manage credentials by providing an identity. There are two types of managed identities: system-assigned and user-assigned. IoT Hub supports both. 
+Managed identities provide Azure services with an automatically managed identity in Azure AD in a secure manner. This eliminates the need for developers having to manage credentials by providing an identity. There are two types of managed identities: system-assigned and user-assigned. IoT Hub supports both. 
 
 In IoT Hub, managed identities can be used for egress connectivity from IoT Hub to other Azure services for features such as [message routing](iot-hub-devguide-messages-d2c.md), [file upload](iot-hub-devguide-file-upload.md), and [bulk device import/export](iot-hub-bulk-identity-mgmt.md). In this article, you learn how to use system-assigned and user-assigned managed identities in your IoT hub for different functionalities.
 
 ## Prerequisites
 
-- Read the documentation of [managed identities for Azure resources](./../active-directory/managed-identities-azure-resources/overview.md) to understand the differences between system-assigned and user-assigned managed identity.
+- Understand the managed identity differences between *system-assigned* and *user-assigned* in [What are managed identities for Azure resources?](./../active-directory/managed-identities-azure-resources/overview.md)
 
-- If you don’t have an IoT hub, [create one](iot-hub-create-through-portal.md) before continuing.
+- An [IoT hub](iot-hub-create-through-portal.md) 
 
 ## System-assigned managed identity
 

articles/iot-hub/iot-hub-rm-rest.md

@@ -21,9 +21,9 @@ You can use the [IoT Hub resource provider REST API](/rest/api/iothub/iothubreso
 
 ## Prerequisites
 
-* Visual Studio.
+* Visual Studio
 
-* [Azure PowerShell](/powershell/azure/install-Az-ps).
+* [Azure PowerShell module](/powershell/azure/install-az-ps)
 
 [!INCLUDE [iot-hub-prepare-resource-manager](../../includes/iot-hub-prepare-resource-manager.md)]
 

articles/iot-hub/iot-hub-rm-template.md

@@ -25,10 +25,9 @@ You can use Azure Resource Manager to create and manage Azure IoT hubs programma
 
 To complete this tutorial, you need the following:
 
-* Visual Studio.
-* An active Azure account. <br/>If you don't have an account, you can create a [free account][lnk-free-trial] in just a couple of minutes.
-* An [Azure Storage account][lnk-storage-account] where you can store your Azure Resource Manager template files.
-* [Azure PowerShell 1.0][lnk-powershell-install] or later.
+* Visual Studio
+* An [Azure Storage account][lnk-storage-account] where you can store your Azure Resource Manager template files
+* [Azure PowerShell module][lnk-powershell-install]
 
 [!INCLUDE [iot-hub-prepare-resource-manager](../../includes/iot-hub-prepare-resource-manager.md)]
 

includes/cloud-shell-try-it-no-header.md

@@ -16,16 +16,16 @@ To start Azure Cloud Shell:
 
 | Option | Example/Link |
 |-----------------------------------------------|---|
-| Select **Try It** in the upper-right corner of a code block. Selecting **Try It** doesn't automatically copy the code to Cloud Shell. | ![Screenshot that shows an example of Try It for Azure Cloud Shell.](./media/cloud-shell-try-it/hdi-azure-cli-try-it.png) |
+| Select **Try It** in the upper-right corner of a code or command block. Selecting **Try It** doesn't automatically copy the code or command to Cloud Shell. | ![Screenshot that shows an example of Try It for Azure Cloud Shell.](./media/cloud-shell-try-it/hdi-azure-cli-try-it.png) |
 | Go to [https://shell.azure.com](https://shell.azure.com), or select the **Launch Cloud Shell** button to open Cloud Shell in your browser. | [![Screenshot that shows how to launch Cloud Shell in a new window.](media/cloud-shell-try-it/hdi-launch-cloud-shell.png)](https://shell.azure.com) |
 | Select the **Cloud Shell** button on the menu bar at the upper right in the [Azure portal](https://portal.azure.com). | ![Screenshot that shows the Cloud Shell button in the Azure portal](./media/cloud-shell-try-it/hdi-cloud-shell-menu.png) |
 
-To run the code in this article in Azure Cloud Shell:
+To use Azure Cloud Shell:
 
 1. Start Cloud Shell.
 
-1. Select the **Copy** button on a code block to copy the code.
+1. Select the **Copy** button on a code block (or command block) to copy the code or command.
 
-1. Paste the code into the Cloud Shell session by selecting **Ctrl**+**Shift**+**V** on Windows and Linux, or by selecting **Cmd**+**Shift**+**V** on macOS.
+1. Paste the code or command into the Cloud Shell session by selecting **Ctrl**+**Shift**+**V** on Windows and Linux, or by selecting **Cmd**+**Shift**+**V** on macOS.
 
-1. Select **Enter** to run the code.
+1. Select **Enter** to run the code or command.

includes/cloud-shell-try-it.md

@@ -6,6 +6,6 @@ ms.author: dbradish
 manager: barbkess
 ---
 
-## Use Azure Cloud Shell
+## Azure Cloud Shell
 
 [!INCLUDE [Use Azure Cloud Shell](cloud-shell-try-it-no-header.md)]