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

az sphere

注意

此参考是 Azure CLI(版本 2.45.0 或更高版本)的 azure-sphere 扩展的一部分。 该扩展将在首次运行 az sphere 命令时自动安装。 详细了解扩展。

管理 Azure Sphere 资源。

命令

名称 说明 类型 Status
az sphere ca-certificate

管理资源组和目录中的证书。

扩展 GA
az sphere ca-certificate download

下载目录的证书。

扩展 GA
az sphere ca-certificate download-chain

将目录的证书链下载为 PKCS#7 “.p7b” 文件。

扩展 GA
az sphere ca-certificate download-proof

下载目录的所有权证明证书,以便与提供的代码一起使用。

扩展 GA
az sphere ca-certificate list

列出资源组和目录中的所有证书。

扩展 GA
az sphere catalog

管理目录。

扩展 GA
az sphere catalog create

创建目录。

扩展 GA
az sphere catalog delete

删除目录。

扩展 GA
az sphere catalog download-error-report

列出或下载所选目录的可用错误报告。

扩展 GA
az sphere catalog list

列出资源组或订阅中的可用目录。

扩展 GA
az sphere catalog show

显示目录的详细信息。

扩展 GA
az sphere deployment

管理资源组和目录中的部署。

扩展 GA
az sphere deployment create

创建部署。

扩展 GA
az sphere deployment list

列出所有部署。

扩展 GA
az sphere deployment show

显示部署的详细信息。

扩展 GA
az sphere device

管理 Azure Sphere 设备。

扩展 GA
az sphere device-group

管理资源组和目录中的设备组。

扩展 GA
az sphere device-group create

创建设备组。

扩展 GA
az sphere device-group create-defaults

创建面向产品的默认设备组。

扩展 GA
az sphere device-group delete

删除指定的设备组。

扩展 GA
az sphere device-group list

列出目录中的所有设备组。

扩展 GA
az sphere device-group show

显示设备组的详细信息。

扩展 GA
az sphere device-group update

更新设备组的详细信息。

扩展 GA
az sphere device app

管理连接设备上的应用程序。

扩展 GA
az sphere device app show-memory-stats

显示附加设备上的应用程序的内存统计信息。

扩展 GA
az sphere device app show-quota

显示附加设备上的应用程序的存储配额和使用情况。

扩展 GA
az sphere device app show-status

显示附加设备上的应用程序的状态。

扩展 GA
az sphere device app start

在附加设备上启动应用程序。

扩展 GA
az sphere device app stop

停止附加设备上的应用程序。

扩展 GA
az sphere device assign

将设备分配到资源组和目录中的设备组。

扩展 GA
az sphere device capability

管理设备功能配置。

扩展 GA
az sphere device capability apply

暂时在附加设备上应用功能会话。

扩展 GA
az sphere device capability download

从 Azure Sphere 安全服务下载设备功能文件。

扩展 GA
az sphere device capability show-attached

显示附加设备的当前设备功能配置。

扩展 GA
az sphere device capability update

更新附加设备的设备功能配置。

扩展 GA
az sphere device certificate

管理附加设备上的证书。

扩展 GA
az sphere device certificate add

在附加设备的证书存储中添加证书。

扩展 GA
az sphere device certificate delete

删除附加设备的证书存储中的证书。

扩展 GA
az sphere device certificate list

列出附加设备的证书存储中的证书。

扩展 GA
az sphere device certificate show

在附加设备的证书存储中显示证书的详细信息。

扩展 GA
az sphere device certificate show-quota

显示附加设备的证书存储中的可用可用空间。

扩展 GA
az sphere device claim

在资源组和目录中声明设备。

扩展 GA
az sphere device enable-cloud-test

通过在附加设备上禁用开发和调试,并将设备分配到支持云中的应用程序更新的设备组,启用设备以测试云加载。 默认情况下,这是设备的产品的 Field Test 设备组,但可以指定其他设备组。 不在制造方案中使用:有关详细信息,请参阅 https://aka.ms/AzureSphereManufacturing

扩展 GA
az sphere device enable-development

通过在附加设备上启用旁加载和调试,并将其分配给禁用云中的应用程序更新的设备组,启用设备进行开发。 默认情况下,这是设备的产品的开发设备组,但可以指定其他设备组。 不在制造方案中使用:有关详细信息,请参阅 https://aka.ms/AzureSphereManufacturing

扩展 GA
az sphere device image

管理目录中的映像和附加设备。

扩展 GA
az sphere device image list-installed

列出附加设备上安装的映像。 默认情况下,仅列出应用程序。

扩展 GA
az sphere device image list-targeted

列出目录中的图像。 默认情况下,仅列出更新设备时将安装的映像。

扩展 GA
az sphere device list

列出目录、产品或设备组中的所有设备。

扩展 GA
az sphere device list-attached

列出所有附加设备。

扩展 GA
az sphere device manufacturing-state

管理附加设备的生产状态。

扩展 GA
az sphere device manufacturing-state show

显示附加设备的制造状态。

扩展 GA
az sphere device manufacturing-state update

更新附加设备的制造状态。 警告:制造状态更改是永久的和不可逆的。

扩展 GA
az sphere device network

提供有关附加设备上的网络接口状态的信息。

扩展 GA
az sphere device network disable

禁用附加设备上的网络接口。

扩展 GA
az sphere device network enable

在附加设备上启用网络接口。

扩展 GA
az sphere device network list-firewall-rules

列出附加设备的防火墙规则。

扩展 GA
az sphere device network list-interfaces

列出附加设备的网络接口。

扩展 GA
az sphere device network proxy

管理用于网络连接的代理地址。

扩展 GA
az sphere device network proxy apply

在附加设备上配置网络代理。

扩展 GA
az sphere device network proxy delete

删除附加设备上的代理连接。

扩展 GA
az sphere device network proxy disable

禁用附加设备上的网络代理。

扩展 GA
az sphere device network proxy enable

在附加设备上启用网络代理。

扩展 GA
az sphere device network proxy show

在附加设备上显示代理连接。

扩展 GA
az sphere device network show-diagnostics

显示附加设备上的一个或多个 Wi-Fi 网络的诊断。

扩展 GA
az sphere device network show-status

显示附加设备的网络状态。

扩展 GA
az sphere device network update-interface

更新附加设备的网络接口配置。

扩展 GA
az sphere device recover

使用恢复模式将新固件加载到附加设备上。

扩展 GA
az sphere device rescan-attached

显示附加设备的数量。

扩展 GA
az sphere device restart

重启附加设备。

扩展 GA
az sphere device show

显示资源组和目录中现有设备的详细信息。

扩展 GA
az sphere device show-attached

显示附加设备的详细信息。

扩展 GA
az sphere device show-count

显示目录、产品或设备组中的设备数。

扩展 GA
az sphere device show-deployment-status

显示设备上的操作系统的部署状态。

扩展 GA
az sphere device show-os-version

显示附加设备上的操作系统版本。

扩展 GA
az sphere device sideload

部署和管理附加设备上的应用程序。

扩展 GA
az sphere device sideload delete

从附加设备中删除应用程序。

扩展 GA
az sphere device sideload deploy

将应用程序部署到附加设备。

扩展 GA
az sphere device sideload set-deployment-timeout

设置部署超时(以秒为单位)。

扩展 GA
az sphere device sideload show-deployment-timeout

显示部署超时(以秒为单位)。

扩展 GA
az sphere device unassign

从资源组和目录中的设备组取消分配设备。

扩展 GA
az sphere device wifi

管附加设备的 Wi-Fi 配置。

扩展 GA
az sphere device wifi add

在附加设备上添加 Wi-Fi 网络。

扩展 GA
az sphere device wifi disable

禁用附加设备上的 Wi-Fi 连接。

扩展 GA
az sphere device wifi enable

在附加设备上启用 Wi-Fi 网络。

扩展 GA
az sphere device wifi forget

忘记附加设备上的 Wi-Fi 网络。

扩展 GA
az sphere device wifi list

列出附加设备的当前 Wi-Fi 配置。

扩展 GA
az sphere device wifi reload-config

重新加载附加设备上的 Wi-Fi 网络配置。 添加或删除证书(azsphere 设备证书)后,请使用此命令确保 EAP-TLS 网络使用证书存储的最新内容。

扩展 GA
az sphere device wifi scan

扫描对附加设备可见的可用 Wi-Fi 网络。

扩展 GA
az sphere device wifi show

显示附加设备上的 Wi-Fi 网络的详细信息。

扩展 GA
az sphere device wifi show-status

显示附加设备上的无线接口的状态。

扩展 GA
az sphere get-support-data

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

扩展 GA
az sphere hardware-definition

管理硬件定义。

扩展 GA
az sphere hardware-definition generate-header

生成与硬件定义对应的 C 头文件,并将其放置在相对于输入 JSON 的文件夹“inc/hw”中。

扩展 GA
az sphere hardware-definition test-header

测试“inc/hw”文件夹中的 C 头文件是否与输入 JSON 有关。

扩展 GA
az sphere image

管理资源组和目录中的映像。

扩展 GA
az sphere image-package

管理映像包。

扩展 GA
az sphere image-package show

显示给定映像包的详细信息。

扩展 GA
az sphere image add

从本地计算机将映像添加到目录。

扩展 GA
az sphere image list

列出资源组和目录中的所有映像。

扩展 GA
az sphere image show

显示目录中现有图像的详细信息。

扩展 GA
az sphere product

管理资源组和目录中的产品。

扩展 GA
az sphere product create

在资源组和目录中创建新产品。

扩展 GA
az sphere product delete

删除指定的产品。

扩展 GA
az sphere product list

列出资源组和目录中的所有产品。

扩展 GA
az sphere product show

在资源组和目录中显示产品的详细信息。

扩展 GA
az sphere product update

更新资源组和目录中的产品详细信息。

扩展 GA
az sphere show-sdk-version

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

扩展 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 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 值来源:az sphere catalog list。

--resource-group -g

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

可选参数

--output-file -of

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

全局参数
--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

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

--subscription

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

--verbose

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

az sphere show-sdk-version

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

az sphere show-sdk-version

示例

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

az sphere show-sdk-version
全局参数
--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

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

--subscription

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

--verbose

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