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

az sphere

Note

此参考是 Azure CLI（版本 2.45.0 或更高版本）的 azure-sphere 扩展的一部分。该扩展将在首次运行 az sphere 命令时自动安装。了解更多关于扩展的信息。

管理 Azure Sphere 资源。

命令

名称	说明	类型	Status
az sphere ca-certificate	管理资源组和目录中的证书。	Extension	GA
az sphere ca-certificate download	下载目录的证书。	Extension	GA
az sphere ca-certificate download-chain	将目录的证书链下载为 PKCS#7 “.p7b” 文件。	Extension	GA
az sphere ca-certificate download-proof	下载目录的所有权证明证书，以便与提供的代码一起使用。	Extension	GA
az sphere ca-certificate list	列出资源组和目录中的所有证书。	Extension	GA
az sphere catalog	管理目录。	Extension	GA
az sphere catalog create	创建目录。	Extension	GA
az sphere catalog delete	删除目录。	Extension	GA
az sphere catalog download-error-report	列出或下载所选目录的可用错误报告。	Extension	GA
az sphere catalog list	列出资源组或订阅中的可用目录。	Extension	GA
az sphere catalog show	显示目录的详细信息。	Extension	GA
az sphere deployment	管理资源组和目录中的部署。	Extension	GA
az sphere deployment create	创建部署。	Extension	GA
az sphere deployment list	列出所有部署。	Extension	GA
az sphere deployment show	显示部署的详细信息。	Extension	GA
az sphere device	管理 Azure Sphere 设备。	Extension	GA
az sphere device-group	管理资源组和目录中的设备组。	Extension	GA
az sphere device-group create	创建设备组。	Extension	GA
az sphere device-group create-defaults	创建面向产品的默认设备组。	Extension	GA
az sphere device-group delete	删除指定的设备组。	Extension	GA
az sphere device-group list	列出目录中的所有设备组。	Extension	GA
az sphere device-group show	显示设备组的详细信息。	Extension	GA
az sphere device-group update	更新设备组的详细信息。	Extension	GA
az sphere device app	管理附加设备上的应用程序。	Extension	GA
az sphere device app show-memory-stats	显示附加设备上的应用程序的内存统计信息。	Extension	GA
az sphere device app show-quota	显示附加设备上的应用程序的存储配额和使用情况。	Extension	GA
az sphere device app show-status	显示附加设备上的应用程序的状态。	Extension	GA
az sphere device app start	在附加设备上启动应用程序。	Extension	GA
az sphere device app stop	停止附加设备上的应用程序。	Extension	GA
az sphere device assign	将设备分配到资源组和目录中的设备组。	Extension	GA
az sphere device capability	管理设备功能配置。	Extension	GA
az sphere device capability apply	暂时在附加设备上应用功能会话。	Extension	GA
az sphere device capability download	从 Azure Sphere 安全服务下载设备功能文件。	Extension	GA
az sphere device capability show-attached	显示附加设备的当前设备功能配置。	Extension	GA
az sphere device capability update	更新附加设备的设备功能配置。	Extension	GA
az sphere device certificate	管理附加设备上的证书。	Extension	GA
az sphere device certificate add	在附加设备的证书存储中添加证书。	Extension	GA
az sphere device certificate delete	删除附加设备的证书存储中的证书。	Extension	GA
az sphere device certificate list	列出附加设备的证书存储中的证书。	Extension	GA
az sphere device certificate show	在附加设备的证书存储中显示证书的详细信息。	Extension	GA
az sphere device certificate show-quota	显示附加设备的证书存储中的可用可用空间。	Extension	GA
az sphere device claim	在资源组和目录中声明设备。	Extension	GA
az sphere device enable-cloud-test	通过在附加设备上禁用开发和调试，并将设备分配到支持云中的应用程序更新的设备组，启用设备以测试云加载。默认情况下，这是设备的产品的 Field Test 设备组，但可以指定其他设备组。不适用于制造方案：有关详细信息，请参阅 https://aka.ms/AzureSphereManufacturing。	Extension	GA
az sphere device enable-development	通过在附加设备上启用旁加载和调试，并将其分配给禁用云中的应用程序更新的设备组，启用设备进行开发。默认情况下，这是设备的产品的开发设备组，但可以指定其他设备组。不适用于制造方案：有关详细信息，请参阅 https://aka.ms/AzureSphereManufacturing。	Extension	GA
az sphere device image	管理目录中的映像和附加设备。	Extension	GA
az sphere device image list-installed	列出附加设备上安装的映像。默认情况下，仅列出应用程序。	Extension	GA
az sphere device image list-targeted	列出目录中的图像。默认情况下，仅列出更新设备时将安装的映像。	Extension	GA
az sphere device list	列出目录、产品或设备组中的所有设备。	Extension	GA
az sphere device list-attached	列出所有附加设备。	Extension	GA
az sphere device manufacturing-state	管理附加设备的制造状态。	Extension	GA
az sphere device manufacturing-state show	显示附加设备的制造状态。	Extension	GA
az sphere device manufacturing-state update	更新附加设备的制造状态。警告：制造状态更改是永久的和不可逆的。	Extension	GA
az sphere device network	提供有关附加设备上的网络接口状态的信息。	Extension	GA
az sphere device network disable	禁用附加设备上的网络接口。	Extension	GA
az sphere device network enable	在附加设备上启用网络接口。	Extension	GA
az sphere device network list-firewall-rules	列出附加设备的防火墙规则。	Extension	GA
az sphere device network list-interfaces	列出附加设备的网络接口。	Extension	GA
az sphere device network proxy	管理用于网络连接的代理地址。	Extension	GA
az sphere device network proxy apply	在附加设备上配置网络代理。	Extension	GA
az sphere device network proxy delete	删除附加设备上的代理连接。	Extension	GA
az sphere device network proxy disable	禁用附加设备上的网络代理。	Extension	GA
az sphere device network proxy enable	在附加设备上启用网络代理。	Extension	GA
az sphere device network proxy show	在附加设备上显示代理连接。	Extension	GA
az sphere device network show-diagnostics	显示附加设备上的一个或多个 Wi-Fi 网络的诊断。	Extension	GA
az sphere device network show-status	显示附加设备的网络状态。	Extension	GA
az sphere device network update-interface	更新附加设备的网络接口配置。	Extension	GA
az sphere device recover	使用恢复模式将新固件加载到附加设备上。	Extension	GA
az sphere device rescan-attached	显示附加设备的数量。	Extension	GA
az sphere device restart	重启附加设备。	Extension	GA
az sphere device show	显示资源组和目录中现有设备的详细信息。	Extension	GA
az sphere device show-attached	显示附加设备的详细信息。	Extension	GA
az sphere device show-count	显示目录、产品或设备组中的设备数。	Extension	GA
az sphere device show-deployment-status	显示设备上的作系统的部署状态。	Extension	GA
az sphere device show-os-version	显示附加设备上的作系统版本。	Extension	GA
az sphere device sideload	在附加设备上部署和管理应用程序。	Extension	GA
az sphere device sideload delete	从附加设备中删除应用程序或板配置。	Extension	GA
az sphere device sideload deploy	将应用程序或板配置部署到附加设备。	Extension	GA
az sphere device sideload set-deployment-timeout	为应用程序或板配置设置部署超时（以秒为单位）。	Extension	GA
az sphere device sideload show-deployment-timeout	显示应用程序或板配置的部署超时（以秒为单位）。	Extension	GA
az sphere device unassign	从资源组和目录中的设备组取消分配设备。	Extension	GA
az sphere device wifi	管理附加设备的 Wi-Fi 配置。	Extension	GA
az sphere device wifi add	在附加设备上添加 Wi-Fi 网络。	Extension	GA
az sphere device wifi disable	禁用附加设备上的 Wi-Fi 连接。	Extension	GA
az sphere device wifi enable	在附加设备上启用 Wi-Fi 网络。	Extension	GA
az sphere device wifi forget	忘记附加设备上的 Wi-Fi 网络。	Extension	GA
az sphere device wifi list	列出附加设备的当前 Wi-Fi 配置。	Extension	GA
az sphere device wifi reload-config	重新加载附加设备上的 Wi-Fi 网络配置。在添加或删除证书（azsphere device certificate）后使用此命令，以确保 EAP-TLS 网络使用证书存储的最新内容。	Extension	GA
az sphere device wifi scan	扫描对附加设备可见的可用 Wi-Fi 网络。	Extension	GA
az sphere device wifi show	显示附加设备上的 Wi-Fi 网络的详细信息。	Extension	GA
az sphere device wifi show-status	显示附加设备上的无线接口的状态。	Extension	GA
az sphere get-support-data	收集有关本地系统、云和设备配置的诊断数据。	Extension	GA
az sphere hardware-definition	管理硬件定义。	Extension	GA
az sphere hardware-definition generate-header	生成与硬件定义对应的 C 头文件，并将其放置在相对于输入 JSON 的文件夹“inc/hw”中。	Extension	GA
az sphere hardware-definition test-header	测试“inc/hw”文件夹中的 C 头文件是否与输入 JSON up-to-date。	Extension	GA
az sphere image	管理资源组和目录中的映像。	Extension	GA
az sphere image-package	管理映像包。	Extension	GA
az sphere image-package pack-application	创建应用程序映像包。	Extension	GA
az sphere image-package show	显示给定映像包的详细信息。	Extension	GA
az sphere image add	从本地计算机将映像添加到目录。	Extension	GA
az sphere image list	列出资源组和目录中的所有映像。	Extension	GA
az sphere image show	显示目录中现有图像的详细信息。	Extension	GA
az sphere product	管理资源组和目录中的产品。	Extension	GA
az sphere product create	在资源组和目录中创建新产品。	Extension	GA
az sphere product delete	删除指定的产品。	Extension	GA
az sphere product list	列出资源组和目录中的所有产品。	Extension	GA
az sphere product show	在资源组和目录中显示产品的详细信息。	Extension	GA
az sphere product update	更新资源组和目录中的产品详细信息。	Extension	GA
az sphere show-sdk-version	显示已安装的 Azure Sphere SDK 版本。	Extension	GA

az sphere get-support-data

收集有关本地系统、云和设备配置的诊断数据。

az sphere get-support-data --catalog
                           --resource-group
                           [--output-file]

示例

收集有关资源组和目录中设备的本地系统、云和设备配置的诊断数据。

az sphere get-support-data --resource-group MyResourceGroup --catalog MyCatalog --output-file archive.zip

必需参数

--catalog -c

用于执行此操作的 Azure Sphere 目录。指定 Azure Sphere 目录名称。可以使用 az config set defaults.sphere.catalog=<name>配置默认的 Azure Sphere 目录。值来源：az sphere catalog list。

--resource-group -g

Azure 资源组的名称。可以使用 az config set defaults.group=<name>配置默认组。值来源：az group list。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--output-file -of

用于保存支持数据的 .zip 文件的路径和文件名。它必须具有 .zip 扩展名。可以提供相对路径或绝对路径。如果未指定文件名，支持数据将保存在当前工作目录中名为 support_data.zip 的文件中。 (Path).

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az sphere show-sdk-version

显示已安装的 Azure Sphere SDK 版本。

az sphere show-sdk-version

示例