通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

安装和使用 Azure IoT 资源管理器

重要

本文介绍使用共享访问签名连接到服务的步骤。 虽然可使用此身份验证方法进行测试和评估，但使用 Microsoft Entra ID 或托管标识对设备进行身份验证是一种更安全的方法。 若要了解详细信息，请参阅 IoT 解决方案 > 云安全性的安全最佳做法。

Azure IoT 资源管理器是一种图形工具，用于与连接到 IoT 中心的设备进行交互。 本文重点介绍如何使用该工具测试 IoT 即插即用设备。 在本地计算机上安装该工具后，可以使用该工具连接到中心。 可以使用该工具查看设备正在发送的遥测数据、处理设备属性和调用命令。

本文介绍如何：

  • 安装和配置 Azure IoT 资源管理器工具。
  • 使用该工具与 IoT 即插即用设备进行交互和测试。

有关使用该工具的更多常规信息，请参阅 GitHub 自述文件。

要使用 Azure IoT 资源管理器工具，需要：

  • Azure IoT 中心。 可以通过多种方式将 IoT 中心添加到 Azure 订阅，例如 使用 Azure CLI 创建 IoT 中心。 你需要 IoT 中心连接字符串来运行 Azure IoT 资源管理器工具。 如果没有 Azure 订阅，请在开始之前创建一个免费帐户。
  • 在 IoT 中心注册的设备。 可以使用 IoT 资源管理器在 IoT 中心创建和管理设备注册。

安装 Azure IoT 资源管理器

请转到 Azure IoT 资源管理器版本，展开最新版本的资产列表。 下载并安装最新版本的应用程序。 安装包配置了在平台上启动应用程序的方法。 例如，在 Windows 中，可以从“开始”菜单启动应用程序。

重要

更新到版本 0.13.x 或更高版本，以基于 https://github.com/Azure/iot-plugandplay-models 解析存储库中的模型

使用 Azure IoT Explorer

对于设备，您可以连接自己的设备，也可以使用其中一个模拟示例设备。

连接到中心

首次运行 Azure IoT 资源管理器时，系统会提示输入 IoT 中心的连接字符串。 添加连接字符串后，选择 “连接”。 可以通过更新连接字符串，使用该工具的设置切换到另一个 IoT 中心。

IoT 即插即用设备的模型定义存储在公共存储库、连接的设备或本地文件夹中。 默认情况下，该工具在公共存储库和连接的设备中查找模型定义。 可以在 “设置”中添加和删除源，或配置源的优先级：

要添加源，请执行以下操作：

  1. 转到 主页/IoT 即插即用设置
  2. 从存储库或本地文件夹中选择 “添加 ”并选择源。

删除源的步骤：

  1. 转到 主页/IoT 即插即用设置
  2. 找到要删除的源。
  3. 选择 X 将其删除。

更改源优先级：

可以将其中一个模型定义源拖放到列表中的不同位置。

查看设备

该工具连接到 IoT 中心后，会显示“ 设备 ”列表页，其中列出了注册到 IoT 中心的设备标识。 可以选择列表中的任意条目以查看详细信息。

在 “设备 ”列表页上，可以：

  • 选择“ 新建 ”以向中心注册新设备。 然后输入设备 ID。 使用默认设置自动生成身份验证密钥并启用与中心的连接。
  • 选择设备，然后选择“ 删除 ”以删除设备标识。 在完成此作之前，请查看设备详细信息，以确保删除正确的设备标识。

与设备交互

在 “设备 列表”页上，选择 “设备 ID ”列中的值以查看已注册设备的详细信息页。 对于每个设备，有两个部分：设备和数字孪生。

装置

本部分包括 设备标识、 设备孪生、 遥测、 直接方法、 云到设备消息、 模块标识 选项卡。

  • 可以在 “设备标识 ”选项卡上查看和更新 设备标识 信息。
  • 可以在“设备孪生”选项卡上访问设备孪生信息。
  • 如果设备已连接并主动发送数据，则可以在“遥测”选项卡上查看遥测数据。
  • 可以在“ 直接方法 ”选项卡上的设备上调用 直接方法 。
  • 可以在 “云到设备消息 ”选项卡上发送 云到设备的消息 。
  • 可以访问模块孪生信息。

IoT 即插即用组件

如果设备使用 模型 ID 连接到中心，该工具会显示 IoT 即插即用组件 选项卡，可在其中查看 模型 ID。

如果 模型 ID 在某个配置的源（公共存储库或本地文件夹）中可用，则会显示组件列表。 选择组件会显示可用的属性、命令和遥测。

在 “组件 ”页上，可以查看只读属性、更新可写属性、调用命令，并查看此组件生成的遥测消息。

在 Azure IoT 资源管理器中查看组件

性能

在 Azure IoT 资源管理器中查看属性

可以在“ 属性”（只读） 选项卡上的接口中查看定义的只读属性。可以在 “属性”（可写） 选项卡上的接口中更新定义的可写属性：

  1. 转到“ 属性”（可写） 选项卡。
  2. 选择要更新的属性。
  3. 输入属性的新值。
  4. 预览要发送到设备的有效负载。
  5. 提交更改。

提交更改后，可以跟踪更新状态： 同步、 成功或 错误。 同步完成后，可在“ 报告值 ”列中看到属性的新值。 如果在同步完成之前导航到其他页面，该工具在更新完成时仍会通知你。 还可以使用该工具的通知中心查看通知历史记录。

指令

若要将命令发送到设备，请转到 “命令 ”选项卡：

  1. 展开要在命令列表中触发的命令。
  2. 输入命令的任何必需值。
  3. 预览要发送到设备的有效负载。
  4. 提交命令。

遥测

若要查看所选接口的遥测数据，请转到其 “遥测 ”选项卡。选择 “开始” 以开始接收遥测数据。

已知问题

有关该工具最新版本支持的 IoT 功能的列表，请参阅 功能列表。