Added 'update iot hub' and moved resource creation to prereqs

Author: w-azure

articles/iot-hub/iot-hub-create-through-portal.md

@@ -20,15 +20,17 @@ This article describes how to create and manage IoT hubs using the [Azure portal
 
 [!INCLUDE [iot-hub-include-create-hub](../../includes/iot-hub-include-create-hub.md)]
 
-## Change the settings of the IoT hub
+## Update the IoT hub
 
-You can change the settings of an existing IoT hub after it's created from the IoT Hub pane. Here are some of the properties you can set for an IoT hub:
+You can change the settings of an existing IoT hub after it's created from the IoT Hub pane. Here are some properties you can set for an IoT hub:
 
-**Pricing and scale**: You can use this property to migrate to a different tier or set the number of IoT Hub units.
+**Pricing and scale**: Migrate to a different tier or set the number of IoT Hub units.
 
 **IP Filter**: Specify a range of IP addresses that will be accepted or rejected by the IoT hub.
 
-**Properties**: Provides the list of properties that you can copy and use elsewhere, such as the resource ID, resource group, location, and so on.
+**Properties**: A list of properties that you can copy and use elsewhere, such as the resource ID, resource group, location, and so on.
+
+For a complete list of options to update an IoT hub, see the [**az iot hub update** commands](/cli/azure/iot/hub#az-iot-hub-update) reference page.
 
 ### Shared access policies
 

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

@@ -21,7 +21,9 @@ This article shows you how to use the [Azure IoT Tools for Visual Studio Code](h
 
 - [Visual Studio Code](https://code.visualstudio.com/)
 
-- [Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools) installed for Visual Studio Code.
+- [Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools) installed for Visual Studio Code
+
+- An Azure resource group: [create a resource group](/azure/azure-resource-manager/management/manage-resource-groups-portal#create-resource-groups) in the Azure portal
 
 ## Create an IoT hub without an IoT Project
 

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

@@ -17,11 +17,7 @@ This article shows you how to create an IoT hub using Azure CLI.
 
 [!INCLUDE [azure-cli-prepare-your-environment.md](../../includes/azure-cli-prepare-your-environment.md)]
 
-## 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](/cli/azure/resource):
+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](/cli/azure/resource):
 
    ```azurecli-interactive
    az group create --name {your resource group name} --location westus
@@ -33,9 +29,12 @@ Use the Azure CLI to create a resource group and then add an IoT hub.
    > ```azurecli-interactive
    > az account list-locations -o table
    > ```
-   >
 
-2. Run the following [command to create an IoT hub](/cli/azure/iot/hub#az-iot-hub-create) in your resource group, using a globally unique name for your IoT hub:
+## Create an IoT Hub
+
+Use the Azure CLI to create a resource group and then add an IoT hub.
+
+Run the following [command to create an IoT hub](/cli/azure/iot/hub#az-iot-hub-create) in your resource group, using a globally unique name for your IoT hub:
     
    ```azurecli-interactive
    az iot hub create --name {your iot hub name} \
@@ -47,7 +46,19 @@ Use the Azure CLI to create a resource group and then add an IoT hub.
 
 The previous command creates an IoT hub in the S1 pricing tier for which you're billed. For more information, see [Azure IoT Hub pricing](https://azure.microsoft.com/pricing/details/iot-hub/).
 
-For more information on Azure IoT Hub commands, see the [`az iot hub`](/cli/azure/iot/hub?view=azure-cli-latest&preserve-view=true) reference article.
+For more information on Azure IoT Hub commands, see the [`az iot hub`](/cli/azure/iot/hub) reference article.
+
+## Update the IoT hub
+
+You can change the settings of an existing IoT hub after it's created. Here are some properties you can set for an IoT hub:
+
+**Pricing and scale**: Migrate to a different tier or set the number of IoT Hub units.
+
+**IP Filter**: Specify a range of IP addresses that will be accepted or rejected by the IoT hub.
+
+**Properties**: A list of properties that you can copy and use elsewhere, such as the resource ID, resource group, location, and so on.
+
+For a complete list of options to update an IoT hub, see the [**az iot hub update** commands](/cli/azure/iot/hub#az-iot-hub-update) reference page.
 
 ## Register a new device in the IoT hub
 

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

@@ -14,17 +14,24 @@ ms.custom: devx-track-azurepowershell
 
 [!INCLUDE [iot-hub-resource-manager-selector](../../includes/iot-hub-resource-manager-selector.md)]
 
-## Introduction
-
 You can use Azure PowerShell cmdlets to create and manage Azure IoT hubs. This tutorial shows you how to create an IoT hub with PowerShell.
 
-
 [!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)]
 
+## Prerequisites
+
+You need a resource group to deploy an IoT hub. You can use an existing resource group or create a new one.
+
+To create a new resource group for your IoT hub, use the [New-AzResourceGroup](/powershell/module/az.Resources/New-azResourceGroup) command. This example creates a resource group called **MyIoTRG1** in the **East US** region:
+
+```azurepowershell-interactive
+New-AzResourceGroup -Name MyIoTRG1 -Location "East US"
+```
+
 ## Connect to your Azure subscription
 
 If you're using Cloud Shell, you're already logged in to your subscription, so you can skip this section. If you're running PowerShell locally instead, enter the following command to sign in to your Azure subscription:
@@ -34,19 +41,9 @@ If you're using Cloud Shell, you're already logged in to your subscription, so y
 Login-AzAccount
 ```
 
-## Create a resource group
-
-You need a resource group to deploy an IoT hub. You can use an existing resource group or create a new one.
-
-To create a resource group for your IoT hub, use the [New-AzResourceGroup](/powershell/module/az.Resources/New-azResourceGroup) command. This example creates a resource group called **MyIoTRG1** in the **East US** region:
-
-```azurepowershell-interactive
-New-AzResourceGroup -Name MyIoTRG1 -Location "East US"
-```
-
 ## Create an IoT hub
 
-To create an IoT hub in the resource group you created in the previous step, use the [New-AzIotHub](/powershell/module/az.IotHub/New-azIotHub) command. This example creates an **S1** hub called **MyTestIoTHub** in the **East US** region:
+Create an IoT hub, using your resource group,. Use the [New-AzIotHub](/powershell/module/az.IotHub/New-azIotHub) command. This example creates an **S1** hub called **MyTestIoTHub** in the **East US** region:
 
 ```azurepowershell-interactive
 New-AzIotHub `
@@ -76,6 +73,18 @@ Remove-AzIotHub `
     -Name MyTestIoTHub
 ```
 
+## Update the IoT hub
+
+You can change the settings of an existing IoT hub after it's created. Here are some properties you can set for an IoT hub:
+
+**Pricing and scale**: Migrate to a different tier or set the number of IoT Hub units.
+
+**IP Filter**: Specify a range of IP addresses that will be accepted or rejected by the IoT hub.
+
+**Properties**: A list of properties that you can copy and use elsewhere, such as the resource ID, resource group, location, and so on.
+
+Explore the [**Set-AzIotHub** commands](/powershell/module/az.iothub/set-aziothub) for a complete list of update options.
+
 ## Next steps
 
 Now that you've deployed an IoT hub using a PowerShell cmdlet, explore more articles: