你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az sphere device
注意
此参考是 Azure CLI(版本 2.45.0 或更高版本)的 azure-sphere 扩展的一部分。 该扩展将在首次运行 az sphere device 命令时自动安装。 详细了解扩展。
管理 Azure Sphere 设备。
命令
az sphere device assign
将设备分配到资源组和目录中的设备组。
az sphere device assign --catalog
--resource-group
--target-device-group
--target-product
[--device]
示例
使用资源组、目录名称、目标产品名称、目标设备组名称和设备 ID 分配设备。
az sphere device assign --resource-group MyResourceGroup --catalog MyCatalog --target-product MyProduct --target-device-group MyCurrentDeviceGroup --device <DeviceIdValue>
必需参数
要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>
。 值来源:az sphere catalog list。
Azure 资源组的名称。 可以使用 az config set defaults.group=<name>
配置默认组。 值来源:az group list。
目标设备组的名称。
目标产品的名称。
可选参数
要针对此命令的设备。 当未附加任何设备或多台设备时,必须这样做才能消除要面向的设备。 如果附加了设备,则可以提供设备 ID、IP 地址或本地连接 ID。 否则,必须仅提供设备 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device claim
在资源组和目录中声明设备。
az sphere device claim --catalog
--resource-group
[--device]
[--device-group]
[--product]
示例
使用资源组、目录名称和设备 ID 声明设备。
az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
使用资源组、目录名称、产品名称、设备组名称和设备 ID 声明设备。
az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>
必需参数
要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>
。 值来源:az sphere catalog list。
Azure 资源组的名称。 可以使用 az config set defaults.group=<name>
配置默认组。 值来源:az group list。
可选参数
要针对此命令的设备。 当未附加任何设备或多台设备时,必须这样做才能消除要面向的设备。 如果附加了设备,则可以提供设备 ID、IP 地址或本地连接 ID。 否则,必须仅提供设备 ID。
用于声明设备的设备组名称。
用于声明设备的产品名称。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device enable-cloud-test
通过在附加设备上禁用开发和调试,并将设备分配到支持云中的应用程序更新的设备组,启用设备以测试云加载。 默认情况下,这是设备的产品的 Field Test 设备组,但可以指定其他设备组。 不在制造方案中使用:有关详细信息,请参阅 https://aka.ms/AzureSphereManufacturing 。
az sphere device enable-cloud-test --catalog
--resource-group
[--device]
[--device-group]
[--product]
示例
启用设备以使用资源组、目录名称、设备 ID 和默认的“字段测试”设备组测试云。
az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
启用设备以使用资源组、目录名称、产品名称、设备组名称和设备 ID 测试云。
az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>
必需参数
要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>
。 值来源:az sphere catalog list。
Azure 资源组的名称。 可以使用 az config set defaults.group=<name>
配置默认组。 值来源:az group list。
可选参数
在附加多个设备时运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。
将向其分配设备的设备组名称。 默认情况下,这是产品的“现场测试”设备组。
目标产品名称。 除非还指定了设备组,否则设备将分配到所选产品的默认“现场测试”设备组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device enable-development
通过在附加设备上启用旁加载和调试,并将其分配给禁用云中的应用程序更新的设备组,启用设备进行开发。 默认情况下,这是设备的产品的开发设备组,但可以指定其他设备组。 不在制造方案中使用:有关详细信息,请参阅 https://aka.ms/AzureSphereManufacturing 。
az sphere device enable-development --catalog
--resource-group
[--device]
[--device-group]
[--enable-rt-core-debugging]
[--product]
示例
通过使用资源组、目录名称、设备 ID 和默认的“开发”设备组启用旁加载和调试来启用设备进行开发。
az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
使用资源组、目录名称、产品名称、设备组名称和设备 ID 启用旁加载和调试来启用设备进行开发。
az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>
必需参数
要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>
。 值来源:az sphere catalog list。
Azure 资源组的名称。 可以使用 az config set defaults.group=<name>
配置默认组。 值来源:az group list。
可选参数
在附加多个设备时运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。
将向其分配设备的设备组名称。 默认情况下,这是产品的“开发”设备组。
安装调试在实时核心上运行的应用程序所需的驱动程序。 需要管理员权限。
目标产品名称。 除非还指定了设备组,否则设备将分配到所选产品的默认“开发”设备组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device list
列出目录、产品或设备组中的所有设备。
az sphere device list --catalog
--resource-group
[--device-group]
[--product]
示例
列出资源组和目录中的所有设备。
az sphere device list --resource-group MyResourceGroup --catalog MyCatalog
列出资源组、目录和产品中的所有设备。
az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct
列出资源组、目录、产品和设备组中的所有设备。
az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup
必需参数
要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>
。 值来源:az sphere catalog list。
Azure 资源组的名称。 可以使用 az config set defaults.group=<name>
配置默认组。 值来源:az group list。
可选参数
设备组名称。
产品名称。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device list-attached
列出所有附加设备。
az sphere device list-attached
示例
列出所有附加设备。
az sphere device list-attached
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device recover
使用恢复模式将新固件加载到附加设备上。
az sphere device recover [--capability]
[--device]
[--images]
示例
恢复附加设备。
az sphere device recover
恢复具有特定功能和映像的附加设备。
az sphere device recover --capability myCapability.cap --images myImagesFolder
可选参数
在恢复期间应用于设备的设备功能映像的文件名。 (路径)。
在附加多个设备时运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。
包含要写入到设备的映像包的文件夹。 如果未指定,则会下载和使用最新的 OS 映像。 (路径)。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device rescan-attached
显示附加设备的数量。
az sphere device rescan-attached
示例
显示附加设备的数量。
az sphere device rescan-attached
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device restart
重启附加设备。
az sphere device restart [--device]
示例
重启附加设备。
az sphere device restart
重启指定的设备。
az sphere device restart --device <DeviceIdValue>
可选参数
在附加多个设备时运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device show
显示资源组和目录中现有设备的详细信息。
az sphere device show --catalog
--resource-group
[--device]
示例
使用资源组、目录名称和设备 ID 显示设备的详细信息。
az sphere device show --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
必需参数
要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>
。 值来源:az sphere catalog list。
Azure 资源组的名称。 可以使用 az config set defaults.group=<name>
配置默认组。 值来源:az group list。
可选参数
要针对此命令的设备。 当未附加任何设备或多台设备时,必须这样做才能消除要面向的设备。 如果附加了设备,则可以提供设备 ID、IP 地址或本地连接 ID。 否则,必须仅提供设备 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device show-attached
显示附加设备的详细信息。
az sphere device show-attached [--device]
示例
显示附加设备的详细信息。
az sphere device show-attached
显示指定设备的详细信息。
az sphere device show-attached --device <DeviceIdValue>
可选参数
在附加多个设备时运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device show-count
显示目录、产品或设备组中的设备数。
az sphere device show-count --catalog
--resource-group
[--device-group]
[--product]
示例
显示资源组和目录中的设备数。
az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog
显示资源组、目录和产品中的设备数。
az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct
显示资源组、目录、产品和设备组中的设备数。
az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup
必需参数
要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>
。 值来源:az sphere catalog list。
Azure 资源组的名称。 可以使用 az config set defaults.group=<name>
配置默认组。 值来源:az group list。
可选参数
设备组名称。
产品名称。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device show-deployment-status
显示设备上的操作系统的部署状态。
az sphere device show-deployment-status --catalog
--resource-group
[--device]
示例
使用资源组、目录名称和设备 ID 显示操作系统的部署状态。
az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
必需参数
要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>
。 值来源:az sphere catalog list。
Azure 资源组的名称。 可以使用 az config set defaults.group=<name>
配置默认组。 值来源:az group list。
可选参数
在附加多个设备时运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device show-os-version
显示附加设备上的操作系统版本。
az sphere device show-os-version [--device]
示例
显示附加设备上的操作系统版本。
az sphere device show-os-version
显示指定设备上的操作系统版本。
az sphere device show-os-version --device <DeviceIdValue>
可选参数
在附加多个设备时运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sphere device unassign
从资源组和目录中的设备组取消分配设备。
az sphere device unassign --catalog
--resource-group
[--device]
示例
使用资源组、目录名称和设备 ID 取消分配设备。
az sphere device unassign --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
必需参数
要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>
。 值来源:az sphere catalog list。
Azure 资源组的名称。 可以使用 az config set defaults.group=<name>
配置默认组。 值来源:az group list。
可选参数
要针对此命令的设备。 当未附加任何设备或多台设备时,必须这样做才能消除要面向的设备。 如果附加了设备,则可以提供设备 ID、IP 地址或本地连接 ID。 否则,必须仅提供设备 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。