Merge pull request #210476 from w-azure/winona-hub-create

19BMG00 · web-flow · commit 473aa2d7574c · 2022-09-08T20:25:14.000-07:00
Wrapping up the Create an IoT Hub section
diff --git a/articles/iot-hub/iot-hub-create-through-portal.md b/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
 
@@ -107,7 +109,9 @@ Here are two ways to find a specific IoT hub in your subscription:
 
 ## Delete the IoT hub
 
-To delete an IoT hub, find the IoT hub you want to delete, then choose **Delete**.
+To delete an IoT hub, open your IoT hub in the Azure portal, then choose **Delete**.
+
+:::image type="content" source="./media/iot-hub-create-through-portal/delete-iot-hub.png" alt-text="Screenshot showing where to find the delete button for an IoT hub in the Azure portal." lightbox="./media/iot-hub-create-through-portal/delete-iot-hub.png":::
 
 ## Next steps
 
diff --git a/articles/iot-hub/iot-hub-create-use-iot-toolkit.md b/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
 
@@ -94,6 +96,9 @@ This method allows you to provision in VS Code without leaving your development
 
    :::image type="content" source="media/iot-hub-create-use-iot-toolkit/provision-done.png" alt-text="A screenshot that shows IoT Hub details in the output window in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/provision-done.png":::
 
+> [!TIP]
+> To delete a device from your IoT hub, use the `Azure IoT Hub: Delete Device` option from the Command Palette. There is no option to delete your IoT hub in Visual Studio Code, however you can [delete your hub in the Azure portal](iot-hub-create-through-portal.md#delete-the-iot-hub).
+
 ## Next steps
 
 Now that you've deployed an IoT hub using the Azure IoT Tools for Visual Studio Code, explore these articles:
diff --git a/articles/iot-hub/iot-hub-create-using-cli.md b/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,21 +46,43 @@ 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/).
 
-## Remove an IoT Hub
+For more information on Azure IoT Hub commands, see the [`az iot hub`](/cli/azure/iot/hub) reference article.
 
-There are various commands to [delete an individual resource](/cli/azure/resource), such as an IoT hub, or delete a resource group and all its resources, including any IoT hubs.
+## Update the IoT hub
 
-To [delete an IoT hub](/cli/azure/iot/hub#az-iot-hub-delete), run the following command:
+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
+
+In this section, you create a device identity in the identity registry in your IoT hub. A device can't connect to a hub unless it has an entry in the identity registry. For more information, see [Understand the identity registry in your IoT hub](iot-hub-devguide-identity-registry.md). This device identity is [IoT Edge](/azure/iot-edge) enabled.
+
+Run the following command to create a device identity. Use your IoT hub name and create a new device ID name in place of `{iothub_name}` and `{device_id}`. This command creates a device identity with default authorization (shared private key).
 
 ```azurecli-interactive
-az iot hub delete --name {your iot hub name} -\
-  -resource-group {your resource group name}
+az iot hub device-identity create -n {iothub_name} -d {device_id} --ee
 ```
 
-To [delete a resource group](/cli/azure/group#az-group-delete) and all its resources, run the following command:
+The result is a JSON printout which includes your keys and other information.
+
+Alternatively, there are several options to register a device using different kinds of authorization. To explore the options, see [Examples](/device-identity?view=azure-cli-latest#az-iot-hub-device-identity-create-examples&preserve-view=true) on the **az iot hub device-identity** reference page.
+
+## Remove an IoT Hub
+
+There are various commands to [delete an individual resource](/cli/azure/resource), such as an IoT hub.
+
+To [delete an IoT hub](/cli/azure/iot/hub#az-iot-hub-delete), run the following command:
 
 ```azurecli-interactive
-az group delete --name {your resource group name}
+az iot hub delete --name {your iot hub name} -\
+  -resource-group {your resource group name}
 ```
 
 ## Next steps
diff --git a/articles/iot-hub/iot-hub-create-using-powershell.md b/articles/iot-hub/iot-hub-create-using-powershell.md
@@ -14,39 +14,36 @@ 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)]
 
-## Connect 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.
-Login-AzAccount
-```
-
-## Create a resource group
+## 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 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:
+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:
+
+```powershell
+# Log into Azure account.
+Login-AzAccount
+```
+
 ## 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,11 +73,17 @@ Remove-AzIotHub `
     -Name MyTestIoTHub
 ```
 
-Alternatively, to remove a resource group and all the resources it contains, use the [Remove-AzResourceGroup](/powershell/module/az.Resources/Remove-azResourceGroup) command:
+## Update the IoT hub
 
-```azurepowershell-interactive
-Remove-AzResourceGroup -Name MyIoTRG1
-```
+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
 
diff --git a/articles/iot-hub/media/iot-hub-create-through-portal/delete-iot-hub.png b/articles/iot-hub/media/iot-hub-create-through-portal/delete-iot-hub.png
