通过

管理设备组

  • 项目

重要

这是 Azure Sphere（旧版）文档。 Azure Sphere（旧版）将于 2027 年 9 月 27 日停用，用户此时必须迁移到 Azure Sphere（集成）。 使用位于 TOC 上方的版本选择器查看 Azure Sphere（集成）文档。

本主题介绍如何使用 CLI 或 Azure Sphere Explorer 管理设备组。 本主题中的步骤假定你熟悉 Azure Sphere 租户、产品和设备组的概念。

列出设备组

使用 azsphere device-group list 命令或使用设备组 - 列表 API 列出 Azure Sphere 租户中的所有设备组。

列出所有设备组：

azsphere device-group list

使用 azsphere product device-group list 命令或使用 Product - List Groups API 列出特定产品中的设备组。

azsphere product device-group list --product <product-name>

  1. 打开 Azure Sphere 资源管理器。

  2. 展开你感兴趣的租户的租户节点。

  1. 打开 Azure Sphere 资源管理器。

  2. 展开你感兴趣的租户的租户节点。

若要查看租户的产品和设备组，请执行以下操作：

  1. 打开 Azure Sphere 资源管理器。

  2. 展开你感兴趣的租户的租户节点。

如果没有列出的产品， 请创建一个产品。

如果设备已与产品关联并分配给组，可以随时 更新其设备组 。

若要查看租户的产品和设备组，请执行以下操作：

  1. 打开 Azure Sphere 资源管理器。

  2. 展开你感兴趣的租户的租户节点。

如果没有列出的产品， 请创建一个产品。

如果设备已与产品关联并分配给组，可以随时 更新其设备组 。

创建设备组

使用 azsphere device-group create 命令或使用设备组创建设备组 - 创建 API。

若要创建设备组：

azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>

设备组的名称只能包含字母数字字符和空格。 它们不能超过 50 个字符。 如果名称或说明包含空格，请将它括在引号中。

可以包括以下可选参数：

  • --os-feed 指定要用于 OS 更新的 OS 源类型。
  • --application-update 设置此设备组的应用程序更新策略。

  1. 打开 Azure Sphere 资源管理器。

  2. 对于感兴趣的租户，展开“产品”节点。

  3. 对于感兴趣的产品，右键单击并选择“ 新建设备组”。

  4. 指定设备组的名称，然后按 Enter。 设备组的名称只能包含字母数字字符和空格。 它们不能超过 50 个字符。 如果指定了无效名称，则会在 “输出 ”窗口中报告错误。

可以在 Visual Studio Code 中创建设备组，但不能将其删除。 若要删除设备组，请使用 azsphere device-group delete 命令或 Azure Sphere 公共 API。

  1. 打开 Azure Sphere 资源管理器。

  2. 对于感兴趣的租户，展开“产品”节点。

  3. 对于感兴趣的产品，右键单击并选择“ 新建设备组”。

  4. 指定设备组的名称，然后按 Enter 或单击“ 应用”。 设备组的名称只能包含字母数字字符和空格。 它们不能超过 50 个字符。 如果指定了无效名称，则会在 “输出 ”窗口中报告错误。

可以在 Visual Studio 中创建设备组，但不能将其删除。 若要删除产品，请使用 azsphere device-group delete 命令或 Azure Sphere 公共 API。

更新设备组

可以使用 azsphere device-group update 命令或使用设备组 - 修补程序 API 修改设备组的名称或说明。

更新设备组的名称和说明：

azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>

还可以使用 azsphere device-group update 命令更新os-feed和application-update参数。

  1. 打开 Azure Sphere 资源管理器。

  2. 对于感兴趣的租户，展开“产品”节点。

  3. 对于感兴趣的产品，展开产品节点以显示其包含的设备组。 可以重命名设备组或更新其说明、OS 源类型或更新策略：

  • 若要重命名设备组，请右键单击设备组名称，然后选择“重命名”，键入新名称，然后按 Enter。 设备组的名称只能包含字母数字字符和空格。 它们不能超过 50 个字符。 如果指定了无效名称，则会在 “输出 ”窗口中报告错误。

  • 若要更新设备组的说明，请右键单击设备组名称并选择“更新说明”，键入新说明，然后按 Enter。

  • 若要更新 OS 源类型，请展开设备组，右键单击 OS 源类型，选择“更新”，然后从菜单中选择“零售”或“RetailEval”。

  • 若要更改更新策略，请展开设备组，右键单击“更新策略”，选择“更新”，然后从菜单中选择 No3rdPartyAppUpdates 或 UpdateAll。 （第三个选项， NoUpdates 目前保留供内部使用。如果选择此选项，则会在 “输出 ”窗口中报告错误。

使用 azsphere device update 命令或使用设备 - 移动 API 将设备移动到其他设备组。

  1. 打开 Azure Sphere 资源管理器。

  2. 对于感兴趣的租户，展开“产品”节点。

  3. 对于感兴趣的产品，展开产品节点以显示其包含的设备组。 可以重命名设备组或更新其说明、OS 源类型或更新策略：

  • 若要重命名设备组，请选择设备组名称，然后按 F2 或右键单击设备组名称，然后选择“重命名”，键入新名称，然后按 Enter 或单击“应用”。 设备组的名称只能包含字母数字字符和空格。 它们不能超过 50 个字符。 如果指定了无效名称，则会在 “输出 ”窗口中报告错误。

  • 若要更新设备组的说明，请展开设备组，选择“说明”，然后按 F2 或右键单击“说明”，然后选择“修改”，键入新说明，然后按 Enter 或单击“应用”。

  • 若要更新 OS 源类型，请展开设备组，选择 OS 源类型，然后按 F2 或右键单击 OS 源类型并选择“修改”，从菜单中选择“零售”或“RetailEval”，然后按 Enter 或单击“应用”。

  • 若要更改更新策略，请展开设备组，选择“更新策略”，然后按 F2 或右键单击“更新策略”并选择“修改”，从菜单中选择 No3RdPartyAppUpdates 或 UpdateAll，然后按 Enter 或单击“应用”。 （第三个选项， NoUpdates 目前保留供内部使用。如果选择此选项，则会在 “输出 ”窗口中报告错误。

使用 azsphere device update 命令或使用设备 - 移动 API 将设备移动到其他设备组。

将设备移动到其他设备组

使用 azsphere device update 命令或使用设备 - 移动 API 将设备移动到其他设备组。

以产品名称>/<device-group-name 格式指定设备组 ID 或产品名称和设备组名称<>的组合：

azsphere device update --device-group <device-group-id>

azsphere device update --device-group <product-name/device-group-name>

删除设备组

使用 azsphere device-group delete 命令或使用设备组 - 删除 API 在 Azure Sphere 租户中删除指定的设备组。

只能在以下情况下删除设备组：

以产品名称>/<device-group-name 格式指定设备组 ID 或产品名称和设备组名称<>的组合：

azsphere device-group delete --device-group <device-group-id>

azsphere device-group delete --device-group <product-name/device-group-name>