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 "Включите устройство для тестирования облачной загрузки, отключив разработку и отладку на подключенном устройстве и назначив его группе устройств, которая включает обновления приложений из облака. По умолчанию это будет группа устройств Field 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 Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: 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 Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: az sphere device list

Примеры

Отображение сведений об устройстве с помощью группы ресурсов, имени каталога и идентификатора устройства.

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

az sphere device assign

Назначьте устройство группе устройств в группе ресурсов и каталоге.

Обязательные параметры

Параметр Описание
--device -d Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: 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.

Примеры

Назначьте устройство, используя группу ресурсов, имя каталога, имя целевого продукта, имя целевой группы устройств и идентификатор устройства.

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

az sphere device unassign

Отмена назначения устройства из группы устройств в группе ресурсов и каталоге.

Обязательные параметры

Параметр Описание
--device -d Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: 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.

Примеры

Отмена назначения устройства с помощью группы ресурсов, имени каталога и идентификатора устройства.

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 Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: 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 Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: az sphere device list
--product -p Название продукта. Значения из: az sphere product list
--device-group -dg Отображаемая группа устройств. Значения из: az sphere device

Примеры

Запросить устройство, используя группу ресурсов, имя каталога и идентификатор устройства.

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

Запросить устройство, используя группу ресурсов, имя каталога, название продукта, имя группы устройств и идентификатор устройства.

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 Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: az sphere device list
--Возможность Имя файла образа возможности устройства, применяемого к устройству во время восстановления. (Путь).
--Изображения Папка, содержащая пакеты образов для записи на устройство. Если не указано, то последние образы ОС загружаются и используются. (Путь).

Примеры

Восстановление подключенного устройства.

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 Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: 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 Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: az sphere device list

Примеры

Отображение состояния развертывания операционной системы с помощью группы ресурсов, имени каталога и идентификатора устройства.

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 Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: az sphere device list
--enable-rt-core-debugging -r Установите драйверы, необходимые для отладки приложений, работающих в ядре реального времени. Требуются разрешения администратора.
--product -p Название продукта. Значения из: az sphere product list
--device-group -dg Отображаемая группа устройств. Значения из: az sphere device

Примеры

Включите устройство для разработки, включив загрузку неопубликованных приложений и отладку с помощью группы ресурсов, имени каталога, идентификатора устройства и группы устройств разработки по умолчанию.

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

Включите устройство для разработки, включив загрузку неопубликованных приложений и отладку с помощью группы ресурсов, имени каталога, имени продукта, имени группы устройств и идентификатора устройства.

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device enable-cloud-test

"Включите устройство для тестирования облачной загрузки, отключив разработку и отладку на подключенном устройстве и назначив его группе устройств, которая включает обновления приложений из облака. По умолчанию это будет группа устройств Field 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 Устройство, на которое выполняется команда при подключении нескольких устройств. Укажите идентификатор, IP-адрес или идентификатор локального подключения подключенного устройства. Значения из: az sphere device list
--product -p Название продукта. Значения из: az sphere product list
--device-group -dg Отображаемая группа устройств. Значения из: az sphere device

Примеры

Включите устройство для тестирования облака с помощью группы ресурсов, имени каталога, идентификатора устройства и группы устройств field Test по умолчанию.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

Включите устройство для тестирования облака с помощью группы ресурсов, имени каталога, имени продукта, имени группы устройств и идентификатора устройства.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>