Merge pull request #222022 from KennedyDMSFT/US44747-01A

December freshness (1/11)

Author: 19BMG00

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

@@ -5,7 +5,7 @@ author: kgremban
 ms.service: iot-hub
 services: iot-hub
 ms.topic: conceptual
-ms.date: 09/06/2018
+ms.date: 12/20/2022
 ms.author: kgremban
 ms.custom: ['Role: Cloud Development']
 ---
@@ -38,7 +38,7 @@ You can also view or modify the list of shared access policies by choosing **Sha
 
 Select **Add shared access policy** to open the **Add shared access policy** blade.  You can enter the new policy name and the permissions that you want to associate with this policy, as shown in the following screenshot:
 
-:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-add-shared-access-policy.png" alt-text="Screenshot showing how to add a shared access policy." lightbox="./media/iot-hub-create-through-portal/iot-hub-add-shared-access-policy.png":::
+:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-add-shared-access-policy.png" alt-text="Screen capture showing how to add a shared access policy." lightbox="./media/iot-hub-create-through-portal/iot-hub-add-shared-access-policy.png":::
 
 * The **Registry Read** and **Registry Write** policies grant read and write access rights to the identity registry. These permissions are used by back-end cloud services to manage device identities. Choosing the write option automatically includes the read option.
 
@@ -56,33 +56,33 @@ For more detailed information about the access granted by specific permissions,
 
 ## Message routing for an IoT hub
 
-Select **Message Routing** under **Messaging** to see the Message Routing pane, where you define routes and custom endpoints for the hub. [Message routing](iot-hub-devguide-messages-d2c.md) enables you to manage how data is sent from your devices to your endpoints. The first step is to add a new route. Then you can add an existing endpoint to the route, or create a new one of the types supported, such as blob storage.
+Select **Message routing** under **Hub settings** to see the **Message routing** pane for your IoT hub, where you define routes, custom endpoints, and message enrichments. [Message routing](iot-hub-devguide-messages-d2c.md) enables you to manage how data is sent from your devices to your endpoints. The first step is to add a new route. Then you can add an existing endpoint to the route, or create a new one of the types supported, such as blob storage.
 
 ### Routes
 
-**Routes** is the first tab on the **Message Routing** pane. To add a new route, select **+ Add**. 
+**Routes** is the first tab on the **Message routing** pane. To add a new route, select **+ Add**. 
 
-![Screenshot showing the 'Message Routing' pane with the '+ Add' button.](./media/iot-hub-create-through-portal/iot-hub-message-routing.png)
+:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-message-routing.png" alt-text="Screen capture showing the 'Message Routing' pane with the '+ Add' button." lightbox="./media/iot-hub-create-through-portal/iot-hub-message-routing.png":::
 
-You see the following screen.
+You see the following screen, which allows you to add a route to your IoT hub.
 
-:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-add-route-storage-endpoint.png" alt-text="Screenshot showing how to add an endpoint to a route." lightbox="./media/iot-hub-create-through-portal/iot-hub-add-route-storage-endpoint.png":::
+:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-add-route-storage-endpoint.png" alt-text="Screen capture showing how to add an endpoint to a new route." lightbox="./media/iot-hub-create-through-portal/iot-hub-add-route-storage-endpoint.png":::
 
 Name your route. The route name must be unique within the list of routes for that hub.
 
-For **Endpoint**, select one from the dropdown list or add a new one. In this example, a storage account and container are already available. To add them as an endpoint, choose **+ Add** next to the Endpoint dropdown and select **Blob Storage**. 
+For **Endpoint**, select one from the dropdown list or add a new one. In this example, a storage account and container are already available. To add them as an endpoint, choose **+ Add endpoint** next to the **Endpoint** dropdown and select **Storage**. 
 
 The following screen shows where the storage account and container are specified.
 
-![Screenshot showing how to add a storage endpoint for the routing rule.](./media/iot-hub-create-through-portal/iot-hub-routing-add-storage-endpoint.png)
+:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-routing-add-storage-endpoint.png" alt-text="Screen capture showing how to add a storage endpoint for a route." lightbox="./media/iot-hub-create-through-portal/iot-hub-routing-add-storage-endpoint.png":::
 
-Add an endpoint name in **Endpoint name** if needed. Select **Pick a container** to select the storage account and container. When you've chosen a container then **Select**, the page returns to the **Add a storage endpoint** pane. Use the defaults for the rest of the fields and **Create** to create the endpoint for the storage account and add it to the routing rules. 
+Add an endpoint name in **Endpoint name** if needed. Select **Pick a container** to select the storage account and container. Choose a storage account and a container, then select **Select** to return to the **Add a storage endpoint** pane. Use the defaults for the rest of the fields and **Create** to create the endpoint for the storage account and add it to the routing rules. 
 
 You return to the **Add a route** page. For **Data source**, select Device Telemetry Messages.
 
 Next, add a routing query. In this example, the messages that have an application property called `level` with a value equal to `critical` are routed to the storage account.
 
-![Screenshot showing how to save a new routing rule.](./media/iot-hub-create-through-portal/iot-hub-add-route.png)
+:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-add-route.png" alt-text="Screen capture showing how to save a new route." lightbox="./media/iot-hub-create-through-portal/iot-hub-add-route.png":::
 
 Select **Save** to save the routing rule. You return to the **Message routing** pane, and your new routing rule is displayed.
 
@@ -103,13 +103,13 @@ To see a full example of how to use custom endpoints with routing, see [Message
 
 Here a few ways to find a specific IoT hub in your subscription:
 
-1. From the Azure homepage, select the IoT Hub icon. Find and select your IoT hub from the list.
+1. From the Azure homepage, select the **IoT Hub** icon. Find and select your IoT hub from the list.
 
-:::image type="content" source="./media/iot-hub-create-through-portal/select-iot-hub.png" alt-text="Screenshot showing how to find your IoT hub.":::
+    :::image type="content" source="./media/iot-hub-create-through-portal/select-iot-hub.png" alt-text="Screen capture showing how to find your IoT hub.":::
 
 1. If you know the resource group to which the IoT hub belongs, choose **Resource groups**, then select the resource group from the list. The resource group screen shows all of the resources in that group, including IoT hubs. Select your hub.
 
-2. Choose **All resources**. On the **All resources** pane, there's a dropdown list that defaults to `All types`. Select the dropdown list, uncheck `Select all`. Find `IoT Hub` and check it. Select the dropdown list box to close it, and the entries will be filtered, showing only your IoT hubs.
+2. Choose **All resources**. On the **All resources** pane, there's a filter that defaults to `Type equals **all**`. Select the filter, uncheck `Select all`. Find `IoT Hub` in the list of resource types for the filter and check it. Select **Apply** to apply the new filter, and the entries are filtered to show only your IoT hubs.
 
 ## Delete the IoT hub
 

articles/iot-hub/media/iot-hub-create-through-portal/iot-hub-add-route-storage-endpoint.png

@@ -5,7 +5,7 @@
  author: kgremban
  ms.service: iot-hub
  ms.topic: include
- ms.date: 10/21/2021
+ ms.date: 12/20/2022
  ms.author: kgremban
  ms.custom: include file
 ---
@@ -23,9 +23,9 @@ In this section, you create a device identity in the identity registry in your I
 
     [!INCLUDE [iot-hub-pii-note-naming-device](iot-hub-pii-note-naming-device.md)]
 
-1. After the device is created, open the device from the list in the **Devices** pane. Copy the **Primary Connection String**. This connection string is used by device code to communicate with the hub.
+1. After the device is created, open the device from the list in the **Devices** pane. Copy the value of **Primary connection string**. This connection string is used by device code to communicate with the IoT hub.
 
-    By default, the keys and connection strings are masked as they're sensitive information. If you click the eye icon, they're revealed. It's not necessary to reveal them to copy them with the copy button.
+    By default, the keys and connection strings are masked because they're sensitive information. If you click the eye icon, they're revealed. It's not necessary to reveal them to copy them with the copy button.
 
     :::image type="content" source="./media/iot-hub-include-create-device/device-details.png" alt-text="Screen capture that shows the device connection string." border="true" lightbox="./media/iot-hub-include-create-device/device-details.png":::
 

articles/iot-hub/media/iot-hub-create-through-portal/iot-hub-add-route.png

@@ -5,7 +5,7 @@ author: kgremban
 ms.service: iot-hub
 services: iot-hub
 ms.topic: include
-ms.date: 11/08/2022
+ms.date: 12/20/2022
 ms.author: kgremban
 ms.custom: include file
 ---
@@ -16,7 +16,7 @@ This section describes how to create an IoT hub using the [Azure portal](https:/
 
 1. On the Azure homepage, select the **+ Create a resource** button.
 
-1. From the **Categories** menu, select **Internet of Things** then **IoT Hub**.
+1. From the **Categories** menu, select **Internet of Things**, and then select **IoT Hub**.
 
 1. On the **Basics** tab, complete the fields as follows:
 
@@ -41,7 +41,7 @@ This section describes how to create an IoT hub using the [Azure portal](https:/
    > [!NOTE]
    > Prices shown are for example purposes only.
 
-   :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-create-screen-basics.png" alt-text="Screenshot that shows how to create an IoT hub in the Azure portal.":::
+   :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-create-screen-basics.png" alt-text="Screen capture that shows how to create an IoT hub in the Azure portal.":::
 
 1. Select **Next: Networking** to continue creating your hub.
 
@@ -51,11 +51,11 @@ This section describes how to create an IoT hub using the [Azure portal](https:/
 
       - **Minimum TLS Version**: Select the minimum TLS version to be supported by your IoT hub. Once the IoT hub is created, this value can't be changed. Accept the default setting, **1.0**, for this example.
 
-   :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-create-network-screen.png" alt-text="Screenshot that shows how to choose the endpoints that can connect to a new IoT hub.":::
+   :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-create-network-screen.png" alt-text="Screen capture that shows how to choose the endpoints that can connect to a new IoT hub.":::
 
 1. Select **Next: Management** to continue creating your hub.
 
-   :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-management.png" alt-text="Screenshot that shows how to set the role-based access control and scale for a new IoT hub.":::
+   :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-management.png" alt-text="Screen capture that shows how to set the role-based access control and scale for a new IoT hub.":::
 
    Accept the default settings here. If desired, you can modify any of the following fields:
 
@@ -73,7 +73,7 @@ This section describes how to create an IoT hub using the [Azure portal](https:/
    > [!NOTE]
    > Prices shown are for example purposes only.
    
-   :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-create-add-ons.png" alt-text="Screenshot that shows how to set the optional add-ons for a new IoT hub.":::
+   :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-create-add-ons.png" alt-text="Screen capture that shows how to set the optional add-ons for a new IoT hub.":::
 
    Accept the default settings here. If desired, you can modify any of the following fields:
 
@@ -83,13 +83,13 @@ This section describes how to create an IoT hub using the [Azure portal](https:/
 
     Tags are name/value pairs. You can assign the same tag to multiple resources and resource groups to categorize resources and consolidate billing. In this document, you won't be adding any tags. For more information, see [Use tags to organize your Azure resources](../articles/azure-resource-manager/management/tag-resources.md).
 
-    :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-create-tags.png" alt-text="Screenshot that shows how to assign tags for a new IoT hub.":::
+    :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-create-tags.png" alt-text="Screen capture that shows how to assign tags for a new IoT hub.":::
 
 1. Select **Next: Review + create** to review your choices. You see something similar to this screen, but with the values you selected when creating the hub.
 
    > [!NOTE]
    > Prices shown are for example purposes only.
 
-    :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-review-and-create.png" alt-text="Screenshot that shows the review information for creating a new IoT hub.":::
+    :::image type="content" source="./media/iot-hub-include-create-hub/iot-hub-review-and-create.png" alt-text="Screen capture that shows the review information for creating a new IoT hub.":::
 
 1. Select **Create** to start the deployment of your new hub. Your deployment will be in progress a few minutes while the hub is being created. Once the deployment is complete, select **Go to resource** to open the new hub.

articles/iot-hub/media/iot-hub-create-through-portal/iot-hub-message-routing.png

@@ -3,7 +3,7 @@ author: kgremban
 ms.author: kgremban
 ms.service: iot-hub
 ms.topic: include
-ms.date: 10/26/2018
+ms.date: 12/20/2022
 ---
 > [!div class="op_single_selector"]
 > * [Azure portal](../articles/iot-hub/iot-hub-create-through-portal.md)