az sphere device

管理 Azure Sphere 设备。

操作	描述
az sphere device rescan-attached	显示附加设备的数量。
az sphere device list-attached	列出所有附加的设备。
az sphere device show-attached	显示附加设备的详细信息。
az sphere device list	列出目录、产品或设备组中的所有设备。
az sphere device show-count	显示目录、产品或设备组中的设备数。
az sphere device show	显示资源组和目录中现有设备的详细信息。
az sphere device assign	将设备分配到资源组和目录中的设备组。
az sphere device unassign	从资源组和目录中的设备组中取消分配设备。
az sphere device restart	重启附加的设备。
az sphere device claim	在资源组和目录中声明设备。
az sphere device recover	使用恢复模式将新固件加载到连接的设备上。
az sphere device show-os-version	显示附加设备上的操作系统版本。
az sphere device show-deployment-status	显示设备上操作系统的部署状态。
az sphere device enable-development	“通过在附加设备上启用旁加载和调试，并将其分配给禁用云中的应用程序更新的设备组，来启用设备进行开发。 默认情况下，这是设备产品的开发设备组，但可以指定其他设备组。 不适用于制造方案
az sphere device enable-cloud-test	“启用设备以测试云加载，方法是在附加设备上禁用开发和调试，并将其分配给从云启用应用程序更新的设备组。 默认情况下，这是设备产品的现场测试设备组，但可以指定其他设备组。 不适用于制造方案

命令

az sphere device rescan-attached

显示附加设备的数量。

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

例子

显示附加设备的数量。

az sphere device rescan-attached

az sphere device list-attached

列出所有附加的设备。

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

例子

列出所有附加的设备。

az sphere device list-attached

az sphere device show-attached

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

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list

例子

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

az sphere device show-attached

显示指定设备的详细信息。

az sphere device show-attached --device <DeviceIdValue>

az sphere device list

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

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--product -p	产品名称。 值来自： az sphere product list
--device-group -dg	要显示的设备组。 值来自： az sphere device

例子

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

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

az sphere device show-count

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

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--product -p	产品名称。 值来自： az sphere product list
--device-group -dg	要显示的设备组。 值来自： az sphere device

例子

显示资源组和目录中的设备数。

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

az sphere device show

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

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list

例子

使用资源组、目录名称和设备 ID 显示设备的详细信息。

az sphere device show --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device assign

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

必需参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list
--target-product	目标产品的名称。 值来自： az sphere product list
--target-device-group	目标设备组的名称。 值来自： az sphere device
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

例子

使用资源组、目录名称、目标产品名称、目标设备组名称和设备 ID 分配设备。

az sphere device assign --resource-group MyResourceGroup --catalog MyCatalog --target-product MyProduct --target-device-group MyCurrentDeviceGroup --device <DeviceIdValue>

az sphere device unassign

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

必需参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

例子

使用资源组、目录名称和设备 ID 取消分配设备。

az sphere device unassign --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device restart

重启附加的设备。

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list

例子

重启附加的设备。

az sphere device restart

重启指定的设备。

az sphere device restart --device <DeviceIdValue>

az sphere device claim

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

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list
--product -p	产品名称。 值来自： az sphere product list
--device-group -dg	要显示的设备组。 值来自： az sphere device

例子

使用资源组、目录名称和设备 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>

az sphere device recover

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

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list
--能力	恢复期间要应用于设备的设备功能映像的文件名。 (路径) 。
--图像	包含要写入设备的映像包的文件夹。 如果未指定，则会下载并使用最新的 OS 映像。 (路径) 。

例子

恢复连接的设备。

az sphere device recover

恢复具有特定功能和映像的附加设备。

az sphere device recover --capability myCapability.cap --images myImagesFolder

az sphere device show-os-version

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

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list

例子

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

az sphere device show-os-version

显示指定设备上的操作系统版本。

az sphere device show-os-version --device <DeviceIdValue>

az sphere device show-deployment-status

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

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list

例子

使用资源组、目录名称和设备 ID 显示操作系统的部署状态。

az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device enable-development

“通过在附加设备上启用旁加载和调试，并将其分配给禁用云中的应用程序更新的设备组，来启用设备进行开发。 默认情况下，这是设备产品的开发设备组，但可以指定其他设备组。 不适用于制造方案

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list
--enable-rt-core-debugging -r	安装调试在实时核心上运行的应用程序所需的驱动程序。 需要管理员权限。
--product -p	产品名称。 值来自： az sphere product list
--device-group -dg	要显示的设备组。 值来自： az sphere device

例子

通过使用资源组、目录名称、设备 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>

az sphere device enable-cloud-test

“启用设备以测试云加载，方法是在附加设备上禁用开发和调试，并将其分配给从云启用应用程序更新的设备组。 默认情况下，这是设备产品的现场测试设备组，但可以指定其他设备组。 不适用于制造方案

必需参数

参数	描述
--catalog -c	要在其中执行此操作的 Azure Sphere 目录。 指定 Azure Sphere 目录名称。 可以使用 配置默认的 Azure Sphere 目录 az config set defaults.sphere.catalog=<name>。 中的值： az sphere catalog list。
--resource-group -r	Azure 资源组的名称。 可以使用 配置默认组 az config set defaults.group=<name>。 中的值： az group list。

可选参数

参数	描述
--device -d	附加多个设备时要运行命令的设备。 指定附加设备的 ID、IP 地址或本地连接 ID。 中的值： az sphere device list
--product -p	产品名称。 值来自： az sphere product list
--device-group -dg	要显示的设备组。 值来自： az sphere device

例子

使用资源组、目录名称、设备 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>