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

在 Azure IoT Central 应用程序中管理单个设备

本文介绍如何在 Azure IoT Central 应用程序中管理设备。 您可以:

  • 使用 “设备” 页查看、添加和删除连接到 Azure IoT Central 应用程序的设备。
  • 通过从视图中更改存储在设备属性中的值,使你的设备元数据保持最新。
  • 通过从视图中更新特定设备上的设置来控制设备的行为。

若要了解如何批量管理设备,请参阅 在 Azure IoT Central 应用程序中批量管理设备

若要了解如何使用 IoT Central REST API 管理设备,请参阅 如何使用 IoT Central REST API 来管理设备。

查看你的设备

若要查看单个设备,请执行以下步骤:

  1. 在左窗格中选择 “设备 ”。 在这里,你将看到设备模板的列表,以及组织可访问的所有设备的列表。

  2. 选择设备模板。

  3. “设备 ”页的右侧窗格中,可以看到组织可从该设备模板创建的设备列表:

    显示恒温器设备列表的屏幕截图。

    选择单个设备以查看该设备的设备详细信息页。

    小窍门

    可以使用此页面上的筛选器工具查看特定组织中的设备。

监视您的设备

使用 “设备” 页监视和管理设备。

以下视频将引导你完成监视设备连接状态:

设备状态值

每个设备在 UI 中都有一个状态值。 设备状态可以是以下项之一:

  • 设备的初始状态为 注册。 此状态表示设备是在 IoT Central 中创建的,并且具有设备 ID。 设备在以下情况下注册:

    • “设备” 页上添加了新的真实设备。
    • 使用“设备”页上的“导入”功能添加一组设备。
  • 当已注册的设备使用设备预配服务(DPS)完成预配步骤时,设备状态将更改为 已预配”。 若要完成预配过程,设备需要用于注册设备 的设备 ID 、SAS 密钥或 X.509 证书以及 ID 范围。 DPS 预配设备后,可以连接到 IoT Central 应用程序并开始发送数据。

  • 被阻止的设备的状态为 “已阻止”。 操作员可以阻止和取消阻止设备。 当设备被阻止时,它无法将数据发送到 IoT Central 应用程序。 操作员必须先解除阻止设备,然后才能恢复发送数据。 当操作员取消阻止设备时,状态将返回到其以前的值 “已注册 ”或 “已预配”。

  • 如果设备状态为“正在等待审批”,则表示“设备连接组”页上禁用“自动批准”选项。 操作员必须先显式批准设备,然后才能预配和发送数据。 设备未在 “设备” 页上手动注册,但已连接到有效凭据的设备状态为 “正在等待审批”。 操作员可以使用“批准”按钮从“设备”页批准这些设备。

下表显示了 UI 中设备的状态值如何映射到 REST API 用来与设备交互的值:

UI 设备状态 注释 REST API 获取数据
等待审批 自动批准选项在设备连接组中处于禁用状态,并且未通过 UI 添加设备。
用户必须先通过 UI 手动批准设备,然后才能使用它。
Provisioned: false
Enabled: false
已注册 设备已自动或手动获得批准。 Provisioned: false
Enabled: true
已预配 设备已预配,可以连接到 IoT Central 应用程序。 Provisioned: true
Enabled: true
Blocked 不允许设备连接到 IoT Central 应用程序。 可以阻止处于任何其他状态的设备。 Provisioned: 取决于 Waiting for approval/Registered/Provisioned status
Enabled: false

设备还可以具有 “未分配”状态。 此状态未显示在 UI 中的 “设备状态 ”字段中,该状态显示在 UI 中的 “设备模板 ”字段中。 但是,可以筛选出状态为 未分配 的设备列表。 如果设备状态为 “未分配”,则连接到 IoT Central 的设备不会分配到设备模板。 这种情况通常在以下情况下发生:

  • “设备”页上使用“导入”添加一组设备,而无需指定设备模板。
  • 设备在 “设备” 页上手动注册,而无需指定设备模板。 然后,设备使用有效的凭据进行连接。

操作员可以使用“迁移”按钮从“设备”页将设备分配到设备模板。

设备连接状态

当设备或边缘设备使用 MQTT 协议进行连接时,将生成设备的 已连接断开连接 事件。 设备不会发送这些事件,IoT Central 会在内部生成它们。

下图显示了设备连接时如何在时间窗口结束时注册连接。 如果发生多个连接和断开事件,IoT Central 会注册最接近时间窗口结束时的那个事件。 例如,如果设备在时间范围内断开连接并重新连接,IoT Central 会注册连接事件。 目前,时间窗口大约为一分钟。

显示连接和断开事件的事件窗口关系图。

观看以下视频,详细了解如何监视设备连接状态:

可以在使用 Blob 存储将 IoT 数据导出到云目标的过程中,包含连接和断开连接事件。 若要了解更多信息,请参阅 使用事件网格响应 IoT 中心事件并触发动作 > 设备连接状态事件的限制

添加设备

若要将设备添加到 Azure IoT Central 应用程序,请执行以下作:

  1. 在左窗格中选择 “设备 ”。

  2. 选择要从中创建设备的设备模板。

  3. 选择“+ 新建”。

  4. 输入设备名称和 ID 或接受默认值。 设备名称的最大长度为 148 个字符。 设备 ID 的最大长度为 128 个字符。

  5. 模拟 开关设置为 “打开 ”或 “关闭”。 真实设备是指连接到 Azure IoT Central 应用程序的物理设备。 模拟设备包含 Azure IoT Central 为你生成的示例数据。

  6. 如果应用程序使用组织,请选择设备所属的组织。

    小窍门

    可以将 默认组织 设置为显示在组织下拉列表中。

  7. 选择 创建

  8. 此设备现在会显示在此模板的设备列表中。 选择设备以查看设备详细信息页,其中包含设备的所有视图。

获取设备连接信息

当设备预配并连接到 IoT Central 时,它需要来自 IoT Central 应用程序的连接信息:

  • 标识应用程序与 DPS 之间关系的 ID 范围
  • 用于注册设备的 设备 ID
  • SAS 密钥或 X.509 证书。

若要查找这些值:

  1. 在左窗格中选择 “设备 ”。

  2. 若要查看设备详细信息,请在设备列表中选择设备。

  3. 选择 “连接” 以查看连接信息。 QR 代码对 JSON 文档进行编码,其中包含从默认 SAS-IoT-Devices 设备连接组派生的 ID 范围设备 ID主密钥

注释

如果身份验证类型为 共享访问签名,则显示的密钥派生自默认 SAS-IoT-Devices 设备连接组。

更改组织

若要将设备移动到其他组织,必须有权访问源组织和目标组织。 要移动设备:

  1. 在左窗格中选择 “设备 ”。

  2. 在设备列表中选择要移动的设备。

  3. 从下拉菜单中选择“管理设备和组织”。

  4. 为设备选择新组织:

    显示如何将设备移动到另一个组织的屏幕截图。

  5. 选择“保存”

将设备迁移到模板

如果通过在 所有设备 下启动导入来注册设备,则会创建设备而不会与任何设备模板关联。 必须将设备分配到模板,以浏览有关设备的数据和其他详细信息。 按照以下步骤将设备分配到模板:

  1. 在左窗格中选择 “设备 ”。

  2. 在左侧面板中,选择 “所有设备”。

  3. 选择要分配给模板的 未分配 设备:

  4. 选择 “迁移”

    显示如何将设备分配到设备模板的屏幕截图。

  5. 从可用模板列表中选择模板,然后选择“ 迁移”。

  6. 所选设备将分配到所选设备模板。

删除设备

若要从 Azure IoT Central 应用程序中删除实际设备或模拟设备,请执行以下作:

  1. 在左窗格中选择 “设备 ”。

  2. 选择要删除的设备的设备模板。

  3. 请使用筛选器工具以筛选和查找您的设备。 选中要删除的设备旁边的框。

  4. 选择删除。 可以在“设备操作”面板中跟踪此删除操作的状态。

更改属性

云属性是与设备关联的设备元数据,例如城市和序列号。 云属性仅存在于 IoT Central 应用程序中,并且不会同步到设备。 可写属性控制设备的行为,并允许你远程设置设备的状态,例如,通过设置恒温器设备的目标温度。 设备设置设备属性,这些属性在 IoT Central 中是只读的。 可以在设备的 “设备详细信息 ”视图上查看和更新属性。

  1. 在左窗格中选择 “设备 ”。

  2. 选择要更改其属性的设备的设备模板,然后选择目标设备。

  3. 选择包含设备属性的视图,此视图使你能够输入值,然后选择页面顶部的 “保存 ”。 在这里,你将看到设备具有的属性及其当前值。 云属性和可写属性具有可编辑字段,而设备属性是只读的。 对于可写属性,可以在字段底部看到其同步状态。

  4. 将属性修改为所需的值。 可以一次修改多个属性,并同时更新它们。

  5. 选择“保存”。 如果保存了可写属性,则值将发送到设备。 当设备确认可写属性的更改时,状态将返回回 同步。 如果保存了云属性,则会更新该值。