管理产品
重要
这是 Azure Sphere(旧版)文档。 Azure Sphere(旧版)将于 2027 年 9 月 27 日停用,用户此时必须迁移到 Azure Sphere(集成)。 使用位于 TOC 上方的版本选择器查看 Azure Sphere(集成)文档。
产品标识合并到已连接设备中以执行特定功能的 Azure Sphere MCU。 作为制造商,你可以为连接的设备的每个型号(如洗衣机或咖啡机)创建产品。 例如,Contoso 为其 DW100 洗碗机创建产品,并在制造过程中将此产品分配给每台 DW100 洗碗机。 每个产品都有一个在租户中唯一且无法更改的 GUID。
每个连接的设备都有单个产品,但单个产品可以与多台设备关联。 每个产品都有一个在租户中必须唯一的名称,以及描述。 产品名称和描述以用户可读的方式来区分产品与其他产品。 可以根据需要修改产品的名称和描述。
列出产品
使用 azsphere product list 命令或使用 Azure Sphere 公共 API 列出 Azure Sphere 租户中的所有产品。
列出所有产品:
azsphere product list
如果未选择默认租户,可能会显示一条消息。 从列表中选择所需的租户,然后重试该命令。
列出 Azure Sphere 租户中的所有产品:
在 Visual Studio Code 的活动栏中选择 Azure Sphere 资源管理器图标以打开 Azure Sphere 资源管理器。 如果“租户”窗格显示“登录以查看租户”,请登录到 Azure Sphere,然后选择“刷新”以查看可用的租户。
展开你感兴趣的租户。
展开产品节点。
选择“查看>其他 Windows>Azure Sphere 资源管理器”以打开 Azure Sphere 资源管理器。 如果“租户”窗格显示“登录以查看租户”,请登录到 Azure Sphere,然后选择“刷新”以查看可用的租户。
展开你感兴趣的租户。
展开产品节点。
创建产品
使用 azsphere product create 命令或使用 Azure Sphere 公共 API 在 Azure Sphere 租户中创建产品。
创建产品:
azsphere product create --name <product-name>
将产品名称>替换为<产品的可读名称,例如 DW100。 产品的名称只能包含字母数字字符和空格。 它们不能超过 50 个字符。 如果名称或说明包含空格,请将它括在引号中。
默认情况下,创建新产品时,Azure Sphere 会自动创建五个设备组用于创建部署。 五个默认设备组是“开发”、“现场测试”、“生产”、“现场测试 OS 评估”和“生产 OS 评估”。 若要创建没有默认设备组的产品,请使用以下命令:
azsphere product create --name <product-name> --no-default-device-groups
租户可能包含许多产品,提供每个产品的说明非常有用。 可以按如下所示向产品添加说明:
azsphere product create --name <product-name> --description <product-description>
创建产品:
对于感兴趣的租户,右键单击“产品”节点并选择“ 新产品”。
指定产品的名称,然后按 Enter。 产品的名称只能包含字母数字字符和空格。 它们不能超过 50 个字符。 如果指定了无效名称,则会在 “输出 ”窗口中报告错误。
在 Azure Sphere 资源管理器中创建产品时,会自动创建五个默认设备组。 如果要在没有设备组的情况下创建产品,请使用 azsphere product create 命令或 Azure Sphere 公共 API 并指定 --no-default-device-groups。
可以在 Azure Sphere 资源管理器中创建产品,但不能将其删除。 若要删除产品,请使用 azsphere product delete 命令或 Azure Sphere 公共 API。
创建产品:
对于感兴趣的租户,右键单击“产品”节点并选择“ 新产品”。
指定产品的名称,然后按 Enter 或单击“ 应用”。 产品的名称只能包含字母数字字符和空格。 它们不能超过 50 个字符。 如果指定了无效名称,则会在 “输出 ”窗口中报告错误。
在 Azure Sphere 资源管理器中创建产品时,会自动创建五个默认设备组。 如果要在没有设备组的情况下创建产品,请使用 azsphere product create 命令或 Azure Sphere 公共 API 并指定 --no-default-device-groups。
可以在 Azure Sphere 资源管理器中创建产品,但不能将其删除。 若要删除产品,请使用 azsphere product delete 命令或 Azure Sphere 公共 API。
更新产品
使用 azsphere product update 命令或使用 Azure Sphere 公共 API 随时修改产品的名称或说明。 若要更新产品名称和说明,请执行以下操作:
azsphere product update --product <product-name> --new-name <new-product-name> --new-description <new-product-description>
删除产品
使用 azsphere product delete 命令或使用 Azure Sphere 公共 API 随时删除产品。
只有在以下情况下才能删除产品:
- 用户对租户具有管理员权限。
- 产品为空,设备组中没有设备。 azsphere product device list 命令列出产品中的所有设备。 运行 azsphere device update --device-group 将设备移动到其他 device-group 或 azsphere device-group delete 以删除设备组。
删除产品:
azsphere product delete --product <product-name>
对于感兴趣的租户,展开“产品”节点。
若要重命名产品,请右键单击产品名称并选择“重命名”,指定新的产品名称,然后按 Enter。
若要更新说明,请右键单击产品名称并选择“更新说明”,指定新说明,然后按 Enter。
对于感兴趣的租户,展开“产品”节点。
若要重命名产品,请选择产品名称,然后按 F2 或右键单击产品名称,然后选择“重命名”,指定新的产品名称,然后按 Enter 或单击“应用”。
若要更新说明,请展开产品,选择“说明”,然后按 F2 或右键单击“说明”,然后选择“修改”,指定新说明,然后按 Enter 或单击“应用”。
显示产品详细信息
使用 azsphere product show 命令或使用 Azure Sphere 公共 API 查看租户中产品的详细信息。
azsphere product show --product <product-name>
若要查看租户中产品的详细信息,请执行以下操作:
在 Visual Studio Code 的活动栏中选择 Azure Sphere 资源管理器图标以打开 Azure Sphere 资源管理器。 如果“租户”窗格显示“登录以查看租户”,请登录到 Azure Sphere,然后选择“刷新”以查看可用的租户。
对于感兴趣的租户,展开“产品”节点。
展开你感兴趣的产品。
选择“查看>其他 Windows>Azure Sphere 资源管理器”以打开 Azure Sphere 资源管理器。 如果“租户”窗格显示“登录以查看租户”,请登录到 Azure Sphere,然后选择“刷新”以查看可用的租户。
对于感兴趣的租户,展开“产品”节点。
展开你感兴趣的产品。