Merge pull request #212294 from PatAltimore/patricka-device-list

BCS2022 · web-flow · commit c133fc67336f · 2022-10-04T08:49:11.000-07:00
Portal UI change for IoT Hub
diff --git a/articles/iot-edge/configure-connect-verify-gpu.md b/articles/iot-edge/configure-connect-verify-gpu.md
@@ -121,9 +121,9 @@ There are different ways to enable an IoT Edge module so that it uses a GPU for
 
 If you have an existing module on your IoT Edge device, adding a configuration using `DeviceRequests` in `createOptions` of the deployment manifest makes the module GPU-optimized. Follow these steps to configure an existing module.
 
-1. Go to your IoT Hub in the Azure portal and choose **IoT Edge** from the **Device management** menu.
+1. Go to your IoT Hub in the Azure portal and choose **Devices** under the **Device management** menu.
 
-1. Select your device to open it.
+1. Select your IoT Edge device to open it.
 
 1. Select the **Set modules** tab at the top.
 
@@ -172,11 +172,11 @@ If you have an existing module on your IoT Edge device, adding a configuration u
 
 Let's add an [NVIDIA DIGITS](https://docs.nvidia.com/deeplearning/digits/index.html) module to the IoT Edge device and then allocate a GPU to the module by setting its environment variables. This NVIDIA module is already in a Docker container. 
 
-1. Select your IoT Edge device in the Azure portal from your IoT Hub's **IoT Edge** menu.
+1. Select your IoT Edge device in the Azure portal from your IoT Hub's **Devices** menu.
 
-1. Select the **Set modules** tab at the top
+1. Select the **Set modules** tab at the top.
 
-1. Select **+ Add** under the IoT Edge modules heading and choose **IoT Edge Module**
+1. Select **+ Add** under the IoT Edge modules heading and choose **IoT Edge Module**.
 
 1. Provide a name in the **IoT Edge Module Name** field.
 
diff --git a/articles/iot-edge/deploy-modbus-gateway.md b/articles/iot-edge/deploy-modbus-gateway.md
@@ -6,7 +6,7 @@ author: PatAltimore
 ms.service: iot-edge
 services: iot-edge
 ms.topic: conceptual
-ms.date: 11/19/2019
+ms.date: 09/21/2022
 ms.author: patricka
 ---
 
@@ -40,7 +40,7 @@ This section walks through deploying Microsoft's sample Modbus module to your Io
 
 1. On the [Azure portal](https://portal.azure.com/), go to your IoT hub.
 
-2. Go to **IoT Edge** and click on your IoT Edge device.
+2. Go to **Devices** and select your IoT Edge device.
 
 3. Select **Set modules**.
 
diff --git a/articles/iot-edge/how-to-connect-downstream-iot-edge-device.md b/articles/iot-edge/how-to-connect-downstream-iot-edge-device.md
@@ -58,17 +58,17 @@ In the Azure portal, you can manage the parent/child relationship when you creat
 When you create a new IoT Edge device, you have the option of choosing parent and children devices from the list of existing IoT Edge devices in that hub.
 
 1. In the [Azure portal](https://portal.azure.com), navigate to your IoT hub.
-1. Select **IoT Edge** from the navigation menu.
-1. Select **Add an IoT Edge device**.
+1. Select **Devices** under the **Device management** menu.
+1. Select **Add device** then check the **IoT Edge Device** checkbox.
 1. Along with setting the device ID and authentication settings, you can **Set a parent device** or **Choose child devices**.
 1. Choose the device or devices that you want as a parent or child.
 
 You can also create or manage parent/child relationships for existing devices.
 
 1. In the [Azure portal](https://portal.azure.com), navigate to your IoT hub.
-1. Select **IoT Edge** from the navigation menu.
-1. Select the device you want to manage from the list of **IoT Edge devices**.
-1. Select **Set a parent device** or **Manage child devices**.
+1. Select **Devices** in the **Device management** menu.
+1. Select the **IoT Edge device** you want to manage from the list.
+1. Select the **Set a parent device** *gear* icon or **Manage child devices**.
 1. Add or remove any parent or child devices.
 
 # [Azure CLI](#tab/azure-cli)
@@ -527,8 +527,8 @@ The API proxy module was designed to be customized to handle most common gateway
 # [Portal](#tab/azure-portal)
 
 1. In the [Azure portal](https://portal.azure.com), navigate to your IoT hub.
-1. Select **IoT Edge** from the navigation menu.
-1. Select the top layer device that you're configuring from the list of **IoT Edge devices**.
+1. Select **Devices** under the **Device management** menu.
+1. Select the top layer IoT Edge device that you're configuring from the list.
 1. Select **Set modules**.
 1. In the **IoT Edge modules** section, select **Add** then choose **Marketplace module**.
 1. Search for and select the **IoT Edge API Proxy** module.
@@ -759,8 +759,8 @@ The **API proxy module** is required for routing all communications between the
 The API proxy module was designed to be customized to handle most common gateway scenarios. This article briefly touches on the steps to set up the modules in a basic configuration. Refer to [Configure the API proxy module for your gateway hierarchy scenario](how-to-configure-api-proxy-module.md) for more detailed information and examples.
 
 1. In the [Azure portal](https://portal.azure.com), navigate to your IoT hub.
-1. Select **IoT Edge** from the navigation menu.
-1. Select the lower layer device that you're configuring from the list of **IoT Edge devices**.
+1. Select **Devices** under the **Device management** menu.
+1. Select the lower layer IoT Edge device that you're configuring from the list.
 1. Select **Set modules**.
 1. In the **IoT Edge modules** section, select **Add** then choose **Marketplace module**.
 1. Search for and select the **IoT Edge API Proxy** module.
diff --git a/articles/iot-edge/how-to-create-transparent-gateway.md b/articles/iot-edge/how-to-create-transparent-gateway.md
@@ -236,7 +236,7 @@ To deploy the IoT Edge hub module and configure it with routes to handle incomin
 
 1. In the Azure portal, navigate to your IoT hub.
 
-2. Go to **IoT Edge** and select your IoT Edge device that you want to use as a gateway.
+2. Go to **Devices** under the **Device management** menu and select your IoT Edge device that you want to use as a gateway.
 
 3. Select **Set Modules**.
 
diff --git a/articles/iot-edge/how-to-deploy-at-scale.md b/articles/iot-edge/how-to-deploy-at-scale.md
@@ -44,8 +44,8 @@ IoT Edge provides two different types of automatic deployments that you can use
 The steps for creating a deployment and a layered deployment are very similar. Any differences are called out in the following steps.
 
 1. In the [Azure portal](https://portal.azure.com), go to your IoT Hub.
-1. On the menu in the left pane, select **IoT Edge** under **Device Management**.
-1. On the upper bar, select **Add Deployment** or **Add Layered Deployment**.
+1. On the menu in the left pane, select **Configurations + Deployments** under **Device Management**.
+1. On the upper bar, select **Add** > **Add Deployment** or **Add Layered Deployment**.
 
 There are five steps to create a deployment. The following sections walk through each one.
 
@@ -153,9 +153,9 @@ When you modify a deployment, the changes immediately replicate to all targeted
 
 ### Modify target conditions, custom metrics, and labels
 
-1. In your IoT hub, select **IoT Edge** from the left pane menu.
-1. Select the **IoT Edge deployments** tab and then select the deployment you want to configure.
-1. Select the **Target Condition** tab. Change the **Target Condition** to target the intended devices. You can also adjust the **Priority**.  Select **Save**.
+1. In your IoT hub, select **Configurations + Deployments** from the left pane menu.
+1. Select the deployment you want to configure.
+1. Select the **Target Devices** tab. Change the **Target Condition** to target the intended devices. You can also adjust the **Priority**.
 
     If you update the target condition, the following updates occur:
 
@@ -174,14 +174,10 @@ When you modify a deployment, the changes immediately replicate to all targeted
 When you delete a deployment, any deployed devices take on their next highest priority deployment. If your devices don't meet the target condition of any other deployment, then the modules are not removed when the deployment is deleted.
 
 1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your IoT Hub.
-1. Select **IoT Edge**.
-1. Select the **IoT Edge Deployments** tab.
-
-   ![View IoT Edge deployments](./media/how-to-deploy-monitor/iot-edge-deployments.png)
-
+1. Select **Configurations + Deployments**.
 1. Use the checkbox to select the deployment that you want to delete.
 1. Select **Delete**.
-1. A prompt will inform you that this action will delete this deployment and revert to the previous state for all devices. A deployment with a lower priority will apply. If no other deployment is targeted, no modules will be removed. If you want to remove all modules from your device, create a deployment with zero modules and deploy it to the same devices. Select **Yes** to continue.
+1. A prompt will inform you that this action will delete this deployment and revert to the previous state for all devices. A deployment with a lower priority will apply. If no other deployment is targeted, no modules will be removed. If you want to remove all modules from your device, create a deployment with zero modules and deploy it to the same devices. Select **Yes** to continue.
 
 ## Next steps
 
diff --git a/articles/iot-edge/how-to-deploy-blob.md b/articles/iot-edge/how-to-deploy-blob.md
@@ -30,8 +30,8 @@ The Azure portal guides you through creating a deployment manifest and pushing t
 ### Select your device
 
 1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your IoT hub.
-1. Select **IoT Edge** from the menu.
-1. Click on the ID of the target device from the list of devices.
+1. Select **Devices** under the **Device management** menu.
+1. Select the target IoT Edge device from the list.
 1. Select **Set Modules**.
 
 ### Configure a deployment manifest
@@ -152,7 +152,7 @@ Review your deployment information, then select **Create**.
 
 ### Verify your deployment
 
-After you create the deployment, you return to the **IoT Edge** page of your IoT hub.
+After you create the deployment, you return to the **Devices** page of your IoT hub.
 
 1. Select the IoT Edge device that you targeted with the deployment to open its details.
 1. In the device details, verify that the blob storage module is listed as both **Specified in deployment** and **Reported by device**.
@@ -281,7 +281,7 @@ This process is described in [Configure an IoT Edge device to communicate throug
 
 In addition, a blob storage module also requires the HTTPS_PROXY setting in the manifest deployment file. You can directly edit the deployment manifest file, or use the Azure portal.
 
-1. Navigate to your Iot hub in the Azure portal and select **IoT Edge** from the left pane menu.
+1. Navigate to your IoT Hub in the Azure portal and select **Devices** under the **Device management** menu
 
 1. Select the device with the module to configure.
 
diff --git a/articles/iot-edge/how-to-deploy-modules-portal.md b/articles/iot-edge/how-to-deploy-modules-portal.md
@@ -39,10 +39,10 @@ The Azure portal has a wizard that walks you through creating the deployment man
 ### Select device and add modules
 
 1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your IoT hub.
-1. On the left pane, select **IoT Edge** from the menu.
-1. Click on the ID of the target device from the list of devices.
+1. On the left pane, select **Devices** under the **Device management** menu.
+1. Select the target IoT Edge device from the list.
 1. On the upper bar, select **Set Modules**.
-1. In the **Container Registry Settings** section of the page, provide the credentials to access any private container registries that contain your module images.
+1. In the **Container Registry Credentials** section of the page, provide the credentials to access any private container registries that contain your module images.
 1. In the **IoT Edge Modules** section of the page, select **Add**.
 1. Choose one of the three types of modules from the drop-down menu:
 
@@ -102,7 +102,7 @@ Verify that the module is deployed in your IoT Hub in the Azure portal. Select y
 You can quickly deploy a module from the Azure Marketplace onto your device in your IoT Hub in the Azure portal.
 
 1. In the Azure portal, navigate to your IoT Hub.
-1. On the left pane, under **Device Management**, select **IoT Edge**.
+1. On the left pane, select **Devices** under the **Device management** menu.
 1. Select the IoT Edge device that is to receive the deployment.
 1. On the upper bar, select **Set Modules**.
 1. In the **IoT Edge Modules** section, click **Add**, and select **Marketplace Module** from the drop-down menu.
diff --git a/articles/iot-edge/how-to-monitor-iot-edge-deployments.md b/articles/iot-edge/how-to-monitor-iot-edge-deployments.md
@@ -34,9 +34,8 @@ The IoT Hub service makes this data available for you to monitor in the Azure po
 To view the details of a deployment and monitor the devices running it, use the following steps:
 
 1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your IoT Hub.
-1. Select **IoT Edge** from the left pane menu.
-1. Select the **IoT Edge deployments** tab.
-1. Inspect the deployment list. For each deployment, you can view the following details:
+1. Select **Configurations + Deployments** under the **Device management** menu.
+1. Inspect the deployment list. For each deployment, you can view the following details:
 
     | Column | Description |
     | --- | --- |
@@ -47,9 +46,9 @@ To view the details of a deployment and monitor the devices running it, use the
     | System metrics | The number of device twins in IoT Hub that match the targeting condition. **Applied** specifies the number of devices that have had the deployment content applied to their module twins in IoT Hub. |
     | Device Metrics | The number of IoT Edge devices reporting success or errors from the IoT Edge client runtime. |
     | Custom Metrics | The number of IoT Edge devices reporting data for any metrics that you defined for the deployment. |
-    | Creation Time | The timestamp from when the deployment was created. This timestamp is used to break ties when two deployments have the same priority. |
+    | Created | The timestamp from when the deployment was created. This timestamp is used to break ties when two deployments have the same priority. |
 
-1. Select the deployment that you want to monitor.  
+1. Select the deployment that you want to monitor.
 1. On the **Deployment Details** page, scroll down to the bottom section and select the **Target Condition** tab. Select **View** to list the devices that match the target condition. You can change the condition and also the **Priority**. Select **Save** if you made changes.
 
    ![View targeted devices for a deployment](./media/how-to-monitor-iot-edge-deployments/target-devices.png)
diff --git a/articles/iot-edge/how-to-monitor-module-twins.md b/articles/iot-edge/how-to-monitor-module-twins.md
@@ -183,8 +183,8 @@ You can review the JSON for module twins in the Azure IoT Hub, in Visual Studio
 To view the JSON for the module twin:
 
 1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your IoT hub.
-1. Select **IoT Edge** from the left pane menu.
-1. On the **IoT Edge devices** tab, select the **Device ID** of the device with the modules you want to monitor.
+1. Select **Devices** under the **Device management** menu.
+1. Select the **Device ID** of the IoT Edge device with the modules you want to monitor.
 1. Select the module name from the **Modules** tab and then select **Module Identity Twin** from the upper menu bar.
 
   ![Select a module twin to view in the Azure portal](./media/how-to-monitor-module-twins/select-module-twin.png)
diff --git a/articles/iot-edge/how-to-visual-studio-develop-module.md b/articles/iot-edge/how-to-visual-studio-develop-module.md
@@ -82,13 +82,11 @@ This article assumes that you use a machine running Windows as your development
 
 * To test your module on a device, you'll need an active IoT Hub with at least one IoT Edge device. To create an IoT Edge device for testing you can create one in the Azure portal or with the CLI:
 
-    * Creating one in the [Azure portal](https://portal.azure.com/) is the quickest. From the Azure portal, go to your IoT Hub resource. Select **IoT Edge** from the menu on the left and then select **Add IoT Edge Device**.
+    * Creating one in the [Azure portal](https://portal.azure.com/) is the quickest. From the Azure portal, go to your IoT Hub resource. Select **Devices** under the **Device management** menu and then select **Add Device**.
 
-        :::image type="content" source="./media/how-to-visual-studio-develop-module/create-new-iot-edge-device.png" alt-text="Screenshot of how to add a new I o T Edge device":::
+       In **Create a device**,name your device using **Device ID**, check **IoT Edge Device**, then select **Save** in the lower left. 
     
-       A new popup called **Create a device** will appear. Add a name to your device (known as the Device ID), then select **Save** in the lower left. 
-    
-        Finally, confirm that your new device exists in your IoT Hub, from the **Device management > IoT Edge** menu. For more information on creating an IoT Edge device through the Azure portal, read [Create and provision an IoT Edge device on Linux using symmetric keys](how-to-provision-single-device-linux-symmetric.md).
+        Finally, confirm that your new device exists in your IoT Hub, from the **Device management > Devices** menu. For more information on creating an IoT Edge device through the Azure portal, read [Create and provision an IoT Edge device on Linux using symmetric keys](how-to-provision-single-device-linux-symmetric.md).
 
     * To create an IoT Edge device with the CLI follow the steps in the quickstart for [Linux](quickstart-linux.md#register-an-iot-edge-device) or [Windows](quickstart.md#register-an-iot-edge-device). In the process of registering an IoT Edge device, you create an IoT Edge device.
 
diff --git a/articles/iot-edge/quickstart-linux.md b/articles/iot-edge/quickstart-linux.md
@@ -269,9 +269,9 @@ Follow these steps to start the **Set Modules** wizard to deploy your first modu
 
 1. Sign in to the [Azure portal](https://portal.azure.com) and go to your IoT hub.
 
-1. From the menu on the left, under **Device Management**, select **IoT Edge**.
+1. From the menu on the left, under **Device Management**, select **Devices**.
 
-1. Select the device ID of the target device from the list of devices.
+1. Select the device ID of the target IoT Edge device from the list.
 
    When you create a new IoT Edge device, it will display the status code `417 -- The device's deployment configuration is not set` in the Azure portal. This status is normal, and means that the device is ready to receive a module deployment.
 
diff --git a/articles/iot-edge/quickstart.md b/articles/iot-edge/quickstart.md
@@ -206,7 +206,7 @@ Follow these steps to deploy your first module from Azure Marketplace.
 
 1. Sign in to the [Azure portal](https://portal.azure.com) and go to your IoT hub.
 
-1. From the menu on the left, under **Device Management**, select **IoT Edge**.
+1. From the menu on the left, select **Devices** under the **Device management** menu.
 
 1. Select the device ID of the target device from the list of devices.
 
diff --git a/articles/iot-edge/troubleshoot-common-errors.md b/articles/iot-edge/troubleshoot-common-errors.md
@@ -190,7 +190,7 @@ If you don't need to use the IoT Edge device as a gateway, then you can remove t
 
 In the Azure portal:
 
-1. Navigate to your IoT hub and select **IoT Edge**.
+1. Navigate to your IoT hub and select **Devices** under the **Device management** menu.
 
 2. Select the IoT Edge device that you want to update.
 
diff --git a/articles/iot-edge/troubleshoot-in-portal.md b/articles/iot-edge/troubleshoot-in-portal.md
@@ -26,7 +26,7 @@ You can access the troubleshooting page in the portal through either the IoT Edg
 
 1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your IoT hub.
 
-1. In the left pane, select **IoT Edge** from the menu.
+1. In the left pane,select **Devices** under the **Device management** menu.
 
 1. Select the IoT Edge device that you want to monitor from the list of devices.
 
diff --git a/articles/iot-edge/tutorial-deploy-stream-analytics.md b/articles/iot-edge/tutorial-deploy-stream-analytics.md
@@ -159,7 +159,7 @@ For this tutorial, you deploy two modules. The first is **SimulatedTemperatureSe
 
 1. In the Azure portal, navigate to your IoT hub.
 
-1. Go to **IoT Edge**, and then open the details page for your IoT Edge device.
+1. Select **Devices** under the **Device management** menu, and then open the details page for your IoT Edge device.
 
 1. Select **Set modules**.  
 
diff --git a/articles/iot-edge/tutorial-monitor-with-workbooks.md b/articles/iot-edge/tutorial-monitor-with-workbooks.md
@@ -73,7 +73,7 @@ Follow these steps to deploy and configure the collector module:
 
 1. Sign in to the [Azure portal](https://portal.azure.com) and go to your IoT hub.
 
-1. From the menu on the left, under **Automatic Device Management**, select **IoT Edge**.
+1. From the menu on the left, select **Devices** under the **Device management** menu.
 
 1. Select the device ID of the target device from the list of IoT Edge devices to open the device details page.
 
diff --git a/articles/iot-edge/tutorial-nested-iot-edge-for-linux-on-windows.md b/articles/iot-edge/tutorial-nested-iot-edge-for-linux-on-windows.md
@@ -349,7 +349,7 @@ You can view the status of your modules using the command:
 
    This command will output all the edgeAgent reported properties. Here are some helpful ones for monitoring the status of the device: *runtime status*, *runtime start time*, *runtime last exit time*, *runtime restart count*.
 
-You can also see the status of your modules on the [Azure portal](https://portal.azure.com/). Navigate to the **IoT Edge** section of your IoT Hub to see your devices and modules.
+You can also see the status of your modules on the [Azure portal](https://portal.azure.com/). Navigate to the **Devices** section of your IoT Hub to see your devices and modules.
 
 Once you're satisfied with your module deployments, you're ready to proceed.
 
diff --git a/articles/iot-edge/tutorial-nested-iot-edge.md b/articles/iot-edge/tutorial-nested-iot-edge.md
diff --git a/includes/iot-edge-deploy-module.md b/includes/iot-edge-deploy-module.md
diff --git a/includes/iot-edge-register-device-symmetric.md b/includes/iot-edge-register-device-symmetric.md
diff --git a/includes/iot-edge-register-device-x509.md b/includes/iot-edge-register-device-x509.md
diff --git a/includes/media/iot-edge-register-device/portal-add-iot-edge-device.png b/includes/media/iot-edge-register-device/portal-add-iot-edge-device.png
diff --git a/includes/media/iot-edge-register-device/portal-view-devices.png b/includes/media/iot-edge-register-device/portal-view-devices.png
