Merge pull request #230859 from kgremban/mar15-metarefresh-devicemgmt

Metadata and filename refresh -- device management

Author: Court72

articles/iot-hub/.openpublishing.redirection.iot-hub.json

@@ -938,6 +938,26 @@
       "redirect_url": "/azure/iot-hub/tutorial-routing",
       "redirect_document_id": false
     },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-csharp-csharp-device-management-get-started.md",
+      "redirect_url": "/azure/iot-hub/device-management-dotnet",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-python-python-device-management-get-started.md",
+      "redirect_url": "/azure/iot-hub/device-management-python",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-node-node-device-management-get-started.md",
+      "redirect_url": "/azure/iot-hub/device-management-node",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-java-java-device-management-getstarted.md",
+      "redirect_url": "/azure/iot-hub/device-management-java",
+      "redirect_document_id": true
+    },
     {
       "source_path_from_root": "/articles/iot-hub/iot-hub-store-data-in-azure-table-storage.md",
       "redirect_url": "/azure/iot-hub/tutorial-routing#routing-to-a-storage-account",

articles/iot-hub/TOC.yml

@@ -382,16 +382,16 @@
               href: device-management-cli.md
             - name: .NET
               displayName: device management, status updates, device maintenance windows
-              href: iot-hub-csharp-csharp-device-management-get-started.md
+              href: device-management-dotnet.md
             - name: Python
               displayName: device management, status updates, device maintenance windows
-              href: iot-hub-python-python-device-management-get-started.md
+              href: device-management-python.md
             - name: Node.js
               displayName: device management, status updates, device maintenance windows
-              href: iot-hub-node-node-device-management-get-started.md
+              href: device-management-node.md
             - name: Java
               displayName: device management, status updates, device maintenance windows
-              href: iot-hub-java-java-device-management-getstarted.md
+              href: device-management-java.md
         - name: Schedule and broadcast jobs
           items:
             - name: CLI

articles/iot-hub/device-management-cli.md

@@ -1,14 +1,14 @@
 ---
-title: Get started with Azure IoT Hub device management (Azure CLI)
-description: How to use Azure IoT Hub device management to initiate a remote device reboot. You use the Azure CLI to implement a simulated device and invoke a direct method from that device.
+title: Device management using direct methods (CLI)
+titleSuffix: Azure IoT Hub
+description: How to use Azure IoT Hub direct methods with the Azure CLI for device management tasks including invoking a remote device reboot.
 author: kgremban
 
+ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: azurecli
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 01/30/2023
-ms.author: kgremban
 ms.custom:  "mqtt, devx-track-azurecli"
 ---
 

articles/iot-hub/iot-hub-csharp-csharp-device-management-get-started.md renamed to articles/iot-hub/device-management-dotnet.md

@@ -1,14 +1,14 @@
 ---
-title: Get started with Azure IoT Hub device management (.NET/.NET) | Microsoft Docs
-description: How to use Azure IoT Hub device management to initiate a remote device reboot. You use the Azure IoT device SDK for .NET to implement a simulated device app that includes a direct method and the Azure IoT service SDK for .NET to implement a service app that invokes the direct method.
+title: Device management using direct methods (.NET)
+titleSuffix: Azure IoT Hub
+description: How to use Azure IoT Hub direct methods with the .NET SDK for device management tasks including invoking a remote device reboot.
 author: kgremban
 
+ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: csharp
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 08/20/2019
-ms.author: kgremban
 ms.custom:  "mqtt, devx-track-csharp"
 ---
 
@@ -239,8 +239,8 @@ You're now ready to run the apps.
 
 1. After that the device is connected and waiting for method invocations, right-click the **TriggerReboot** project, select **Debug**, and then select **Start new instance**.
 
-   You should see "Rebooting!" written in the **SimulatedManagedDevice** console and the reported properties of the device, which include the last reboot time,  written in the **TriggerReboot** console.
+   You should see **Rebooting** written in the **SimulatedManagedDevice** console and the reported properties of the device, which include the last reboot time,  written in the **TriggerReboot** console.
 
-    ![Service and device app run](./media/iot-hub-csharp-csharp-device-management-get-started/combinedrun.png)
+   ![Service and device app run](./media/iot-hub-csharp-csharp-device-management-get-started/combinedrun.png)
 
 [!INCLUDE [iot-hub-dm-followup](../../includes/iot-hub-dm-followup.md)]

articles/iot-hub/iot-hub-java-java-device-management-getstarted.md renamed to articles/iot-hub/device-management-java.md

@@ -1,13 +1,13 @@
 ---
-title: Get started with Azure IoT Hub device management (Java) | Microsoft Docs
-description: How to use Azure IoT Hub device management to initiate a remote device reboot. You use the Azure IoT device SDK for Java to implement a simulated device app that includes a direct method and the Azure IoT service SDK for Java to implement a service app that invokes the direct method.
+title: Device management using direct methods (Java)
+titleSuffix: Azure IoT Hub
+description: How to use Azure IoT Hub direct methods with the Java SDK for device management tasks including invoking a remote device reboot.
 author: kgremban
 
 ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: java
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 08/20/2019
 ms.custom: mqtt, devx-track-java
 ---

articles/iot-hub/iot-hub-node-node-device-management-get-started.md renamed to articles/iot-hub/device-management-node.md

@@ -1,12 +1,13 @@
 ---
-title: Get started with Azure IoT Hub device management (Node) | Microsoft Docs
-description: How to use IoT Hub device management to initiate a remote device reboot. You use the Azure IoT SDK for Node.js to implement a simulated device app that includes a direct method and a service app that invokes the direct method.
+title: Device management using direct methods (Node.js)
+titleSuffix: Azure IoT Hub
+description: How to use Azure IoT Hub direct methods with the Node.js SDK for device management tasks including invoking a remote device reboot.
 author: kgremban
 
 ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
-ms.topic: conceptual
+ms.devlang: nodejs
+ms.topic: how-to
 ms.date: 08/20/2019
 ms.custom: mqtt, devx-track-js
 ---
@@ -43,19 +44,19 @@ In this section, you:
 
 * Use the reported properties to enable device twin queries to identify devices and when they last rebooted.
 
-1. Create an empty folder called **manageddevice**.  In the **manageddevice** folder, create a package.json file using the following command at your command prompt.  Accept all the defaults:
+1. Create an empty folder called **managed-device**.  In the **managed-device** folder, create a package.json file using the following command at your command prompt.  Accept all the defaults:
 
     ```cmd/sh
     npm init
     ```
 
-2. At your command prompt in the **manageddevice** folder, run the following command to install the **azure-iot-device** Device SDK package and **azure-iot-device-mqtt** package:
+2. At your command prompt in the **managed-device** folder, run the following command to install the **azure-iot-device** Device SDK package and **azure-iot-device-mqtt** package:
 
     ```cmd/sh
     npm install azure-iot-device azure-iot-device-mqtt --save
     ```
 
-3. Using a text editor, create a **dmpatterns_getstarted_device.js** file in the **manageddevice** folder.
+3. Using a text editor, create a **dmpatterns_getstarted_device.js** file in the **managed-device** folder.
 
 4. Add the following 'require' statements at the start of the **dmpatterns_getstarted_device.js** file:
 
@@ -143,19 +144,19 @@ In this section, you:
 
 In this section, you create a Node.js console app that initiates a remote reboot on a device using a direct method. The app uses device twin queries to discover the last reboot time for that device.
 
-1. Create an empty folder called **triggerrebootondevice**. In the **triggerrebootondevice** folder, create a package.json file using the following command at your command prompt. Accept all the defaults:
+1. Create an empty folder called **trigger-reboot-on-device**. In the **trigger-reboot-on-device** folder, create a package.json file using the following command at your command prompt. Accept all the defaults:
 
     ```cmd/sh
     npm init
     ```
 
-2. At your command prompt in the **triggerrebootondevice** folder, run the following command to install the **azure-iothub** Device SDK package and **azure-iot-device-mqtt** package:
+2. At your command prompt in the **trigger-reboot-on-device** folder, run the following command to install the **azure-iothub** Device SDK package and **azure-iot-device-mqtt** package:
 
     ```cmd/sh
     npm install azure-iothub --save
     ```
 
-3. Using a text editor, create a **dmpatterns_getstarted_service.js** file in the **triggerrebootondevice** folder.
+3. Using a text editor, create a **dmpatterns_getstarted_service.js** file in the **trigger-reboot-on-device** folder.
 
 4. Add the following 'require' statements at the start of the **dmpatterns_getstarted_service.js** file:
 
@@ -232,13 +233,13 @@ In this section, you create a Node.js console app that initiates a remote reboot
 
 You're now ready to run the apps.
 
-1. At the command prompt in the **manageddevice** folder, run the following command to begin listening for the reboot direct method.
+1. At the command prompt in the **managed-device** folder, run the following command to begin listening for the reboot direct method.
 
     ```cmd/sh
     node dmpatterns_getstarted_device.js
     ```
 
-2. At the command prompt in the **triggerrebootondevice** folder, run the following command to trigger the remote reboot and query for the device twin to find the last reboot time.
+2. At the command prompt in the **trigger-reboot-on-device** folder, run the following command to trigger the remote reboot and query for the device twin to find the last reboot time.
 
     ```cmd/sh
     node dmpatterns_getstarted_service.js

articles/iot-hub/iot-hub-python-python-device-management-get-started.md renamed to articles/iot-hub/device-management-python.md

@@ -1,13 +1,14 @@
 ---
-title: Get started with Azure IoT Hub device management (Python) | Microsoft Docs
-description: How to use IoT Hub device management to initiate a remote device reboot. You use the Azure IoT SDK for Python to implement a simulated device app that includes a direct method and a service app that invokes the direct method.
+title: Device management using direct methods (Python)
+titleSuffix: Azure IoT Hub
+description: How to use Azure IoT Hub direct methods with the Python SDK for device management tasks including invoking a remote device reboot.
 author: kgremban
+
+ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: python
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 12/29/2022
-ms.author: kgremban
 ms.custom: mqtt, devx-track-python, devx-track-azurecli, py-fresh-zinc
 ---
 
@@ -52,7 +53,7 @@ In this section, you:
 
 * Use the reported properties to enable device twin queries to identify devices and when they last rebooted.
 
-In Azure Cloud Shell you used above or any other environment with Python, create the device code.
+In Azure Cloud Shell you used previously, or any other environment with Python, create the device code.
 
 1. At your command prompt, run the following command to install the **azure-iot-device** package:
 

articles/iot-hub/iot-hub-c-c-module-twin-getstarted.md

@@ -380,5 +380,5 @@ int main(void)
 
 To continue getting started with IoT Hub and to explore other IoT scenarios, see:
 
-* [Getting started with device management](iot-hub-node-node-device-management-get-started.md)
+* [Getting started with device management](device-management-node.md)
 * [Getting started with IoT Edge](../iot-edge/quickstart-linux.md)

articles/iot-hub/iot-hub-csharp-csharp-module-twin-getstarted.md

@@ -171,6 +171,6 @@ You can now run the apps.
 
 To continue getting started with IoT Hub and to explore other IoT scenarios, see:
 
-* [Getting started with device management](iot-hub-node-node-device-management-get-started.md)
+* [Getting started with device management](device-management-node.md)
 
 * [Getting started with IoT Edge](../iot-edge/quickstart-linux.md)

articles/iot-hub/iot-hub-device-management-overview.md

@@ -72,7 +72,7 @@ Within each of these five stages, there are several device operator requirements
 
 ## Device management patterns
 
-IoT Hub enables the following set of device management patterns. The [device management tutorials](iot-hub-node-node-device-management-get-started.md) show you in more detail how to extend these patterns to fit your exact scenario and how to design new patterns based on these core templates.
+IoT Hub enables the following set of device management patterns. The [device management tutorials](device-management-node.md) show you in more detail how to extend these patterns to fit your exact scenario and how to design new patterns based on these core templates.
 
 * **Reboot**: The back-end app informs the device through a direct method that it has started a reboot.  The device uses the reported properties to update the reboot status of the device.
 
@@ -112,4 +112,4 @@ For more information, see [Device Update for IoT Hub](../iot-hub-device-update/i
 
 The capabilities, patterns, and code libraries that IoT Hub provides for device management, enable you to create IoT applications that fulfill enterprise IoT operator requirements within each device lifecycle stage.
 
-To continue learning about the device management features in IoT Hub, see the [Get started with device management](iot-hub-node-node-device-management-get-started.md) tutorial.
+To continue learning about the device management features in IoT Hub, see [Get started with device management (Node.js)](device-management-node.md).