管理目录

Azure Sphere 目录提供了一种安全的方式，使组织能够独立于其他客户的设备远程管理其 Azure Sphere 设备。 组织必须创建一个 Azure Sphere 目录，然后将其每个设备声明到该目录中，以便你可以远程安全地管理这些设备。

先决条件

• 安装 适用于 Windows 或 Linux 的 Azure Sphere SDK。

创建 Azure Sphere 目录

Azure Sphere 目录隔离 Azure Sphere 设备，并提供组织和部署应用程序的方法。 将自动为创建目录的帐户分配目录管理员角色。

提示

• 创建目录后，无法删除该目录，并且无法在目录之间迁移设备。 如果团队或组织已有 Azure Sphere 目录，请考虑请求访问它，而不是创建其他目录。

创建 Azure Sphere 目录：

1. 通过 USB 将 Azure Sphere 设备连接到计算机。

2. 使用 PowerShell、Windows 命令提示符或 Linux 命令行界面打开 Azure Sphere CLI 并输入以下命令：

   az sphere catalog create --name <catalog-name> --resource-group <resource-group-name>
   

   将 catalog-name> 替换为<其他用户可以识别的名称，例如“Contoso Ltd”或“Contoso 洗碗机部门”。命名目录时，请仅使用字母数字字符和空格。 如果包含空格，请将名称括在引号中。 名称不得以空格开头或超过 30 个字符。 不允许使用特殊字符。 名称区分大小写。

az sphere catalog create 命令创建目录，但不将设备声明到目录中。 有关详细信息，请参阅 声明设备。

列出目录

可以使用以下选项列出可用的 Azure Sphere 目录：

运行以下命令以列出可用的 Azure Sphere 目录。

az sphere catalog list

更新现有目录

注意

不能使用 CLI 或门户重命名现有 Azure Sphere 目录。

下载目录的错误报告

若要获取目录中所有设备的错误报告，请使用 az sphere catalog download-error-report 命令。