| title | description | author | manager | ms.author | ms.service | services | ms.date | ms.topic |
|---|---|---|---|---|---|---|---|---|
Remote Monitoring solution add Edge device - Azure | Microsoft Docs |
This article describes how to add an IoT Edge device to a Remote Monitoring solution accelerator |
dominicbetts |
timlt |
dobett |
iot-accelerators |
iot-accelerators |
10/09/2018 |
conceptual |
To add an IoT Edge device to your solution accelerator, you register it with the IoT hub that's part of your deployment. In the current version of the Remote Monitoring solution accelerator, you can use either the Azure portal or the Azure CLI to add an Edge device.
This article shows you how to use the Azure CLI to add an Edge device. You need the name you chose when you deployed your solution accelerator to complete the steps in this how-to guide.
[!INCLUDE cloud-shell-try-it.md]
Before you can add a device, you need to know the name of your IoT hub. The IoT hub was created when you deployed the Remote Monitoring solution accelerator. The following command lists the contents in the resource group that contains all the Azure resources used by your Remote Monitoring solution. The name of the resource group is the name you chose when you deployed the Remote Monitoring solution accelerator:
# The resource group name is the name of your Remote Monitoring solution
# You can see a list of your resource groups using:
# az group list -o table
az resource list -g {resource group name} -o table
Make a note of the name of the IoT hub, you need this name in the following section.
Before an IoT Edge device can connect to an IoT hub, you must register it.
You have three options for registering an IoT Edge device. Make sure you add the Edge device to the IoT hub you identified in the previous section:
- Register a new Azure IoT Edge device from the Azure portal
- Register a new Azure IoT Edge device with Azure CLI
- Register a new Azure IoT Edge device from Visual Studio Code
When you register a device with the IoT hub in the Remote Monitoring solution accelerator, it's listed on the Devices page in the web UI:
TODO - Add a screenshot here.
Before you can deploy modules to your Edge device, you must install the IoT Edge runtime on the physical device. The following how-to guides show you how to install the runtime on common device platforms:
- Install the Azure IoT Edge runtime on Linux (x64)
- Install Azure IoT Edge runtime on Linux (ARM32v7/armhf)
- Install Azure IoT Edge runtime on Windows to use with Windows containers
- Install the Azure IoT Edge runtime on Windows to use with Linux containers
- Install the IoT Edge runtime on Windows IoT Core
TODO - make sure this next step is updated. Now that you have prepared your IoT Edge device, the next step is to deploy modules to it.