在 IoT 中心的设备更新中创建设备组

IoT 中心的设备更新允许将更新部署到一组 IoT 设备。

注释

如果要部署到默认组而不是用户创建的组,可以直接移动到“如何部署更新

先决条件

向设备添加标签

IoT 中心的设备更新允许将更新部署到一组 IoT 设备。 若要创建组,第一步是向 IoT 中心的目标设备集添加标记。 只有在设备连接到设备更新之后,才能成功将标记添加到设备上。

以下文档介绍如何添加和更新标记。

以编程方式更新设备孪生

在使用设备更新注册设备后,可以使用 RegistryManager 搭配适当的标签来更新设备孪生。

设备更新标记格式

     "tags": {
              "ADUGroup": "<CustomTagValue>"
             }

使用作业

可以在多个设备上计划作业以添加或更新设备更新标记。 有关示例,请参阅 在多台设备上计划作业。 可以通过使用作业来更新设备孪生或模块孪生(如果设备更新代理被设置为模块标识)。 有关详细信息,请参阅计划和广播作业

注释

此作将计入 IoT 中心消息配额,建议一次仅更改最多 50,000 个设备或模块孪生标记,否则,如果超过每日 IoT 中心消息配额,可能需要购买更多 IoT 中心单元。 有关详细信息,请参阅 配额和速率限制

直接孪生更新

还可以直接在设备孪生或模块孪生中添加或更新标记。

  1. 登录 Azure 门户并导航到 IoT 中心。

  2. 从导航菜单中选择 “设备” ,然后选择 IoT 设备以打开其设备详细信息。

  3. 打开孪生体详细信息。

    • 如果设备更新代理配置为设备标识,请选择 “设备孪生”。
    • 如果设备更新代理配置为模块标识,请选择“设备更新”模块,然后选择 “模块标识孪生”。
  4. 在设备孪生或模块孪生中,将任意设备更新标记值设置为 null 即可删除。

  5. 添加新的设备更新标记值,如下所示。 带标记的设备孪生 JSON 文档示例。

    "tags": {
            "ADUGroup": "<CustomTagValue>"
            }

局限性

  • 可以将任何值添加到标记,但“未分类”除外,这是保留值。
  • 标记值不能超过 255 个字符。
  • 标记值可以包含字母数字字符和以下特殊字符“.”,“-”,“_”,“~”。
  • 标签和组名称区分大小写。
  • 设备只能有一个名称为 ADUGroup 的标记,具有该名称的标记的任何后续添加都将替代标记名称 ADUGroup 的现有值。
  • 一个设备只能属于一个组。

通过选择现有的 IoT 中心标记创建设备组

  1. 转到 Azure 门户

  2. 选择之前连接到设备更新实例的 IoT 中心。

  3. 从左侧导航栏中选择“设备管理”下的“更新”选项。

  4. 选择页面顶部的 “组和部署 ”选项卡。

    未分组设备的屏幕截图。

  5. 选择 “添加组 ”以创建新组。

    设备组添加的屏幕截图。

  6. 从列表中选择 IoT 中心标记和设备类,然后选择“ 创建组”。

    标记选择的屏幕截图。

  7. 创建组后,你将看到更新符合性图表和组列表已被更新。 更新合规性图表显示处于不同合规状态的设备数量:已更新至最新、存在可用新更新以及更新进行中。 了解关于更新合规性的信息。

    更新合规性视图的屏幕截图。

  8. 你应该可以看到你新创建的组以及新组中设备的任何可用更新。 如果存在不符合该组设备类别要求的设备,它们将显示在相应的无效设备组中。 可以通过单击组旁边的“部署”按钮,从此视图中将最佳可用更新部署到新的用户定义的组。 有关更多详细信息,请参阅下一步:部署更新。

查看所创建的组的设备详细信息

  1. 导航到新创建的组,然后单击组名称。

  2. 将连同其设备更新属性一起显示属于组的设备列表。 在此视图中,还可以查看组成员的所有设备的更新符合性信息。 更新符合性图表显示处于各种符合性状态的设备计数:已更新到最新版本、有新更新可用和更新进行中。

    设备组详细信息视图的屏幕截图。

  3. 还可以单击组中的每个单个设备,以重定向到 IoT 中心的设备详细信息页。

    设备详细信息视图的屏幕截图。

后续步骤

部署更新

了解更多关于设备组的信息

了解更新符合性。