Обзор расширения Azure Sphere для Azure CLI

Средство командной строки для управления подключенными устройствами Azure Sphere и облачными развертываниями распространяется как расширение Azure CLI.

Установка Azure CLI и расширения Azure Sphere

Чтобы получить расширение Azure Sphere для Azure CLI, выполните следующие действия.

1. Установите Azure CLI , если вы еще не сделали этого.

2. Чтобы добавить расширение Azure Sphere, выполните следующую команду:

   az extension add --name azure-sphere
   

Чтобы войти в подписку Azure, необходимо войти в подписку Azure, которую вы хотите использовать для управления устройствами Azure Sphere.

После установки расширения его расположение находится под значением переменной $AZURE_EXTENSION_DIR оболочки. Если эта переменная не задана, в Linux и macOS по умолчанию устанавливается значение $HOME/.azure/cliextensions, а в Windows — %USERPROFILE%\.azure\cliextensions.

Совет

После входа вы увидите список подписок, связанных с вашей учетной записью Azure. Убедитесь, что вы выбрали подписку с необходимыми разрешениями, используя az account set команду для расширения Azure Sphere для правильной работы. См. дополнительные сведения о выборе нужной подписки при использовании нескольких подписок Azure.

Управление расширением Azure Sphere

Чтобы просмотреть установленные версии расширений Azure CLI, используйте команду:

az version

Чтобы обновить расширение Azure Sphere до последней версии, используйте следующую команду:

az extension update --name azure-sphere

Чтобы удалить расширение Azure Sphere, используйте следующую команду:

az extension remove --name azure-sphere

Общие команды Интерфейса командной строки Azure Sphere

Команды Azure Sphere можно использовать, введя az sphere из командной строки Windows или PowerShell. В Linux можно использовать любой интерфейс командной строки (CLI). В CLI доступна функция заполнения нажатием клавиши TAB для команд в оболочке Bash.

В этой таблице перечислены некоторые распространенные команды Azure Sphere и ссылки на их справочную документацию.

Команда	Description
az sphere catalog	Управление каталогом.
az sphere ca-certificate	Управление сертификатами в каталоге.
az sphere deployment	Управление развертываниями в каталоге.
az sphere device	Управление устройствами Azure Sphere.
az sphere device-group	Управление группами устройств в каталоге.
az sphere image	Управление изображениями в каталоге.
az sphere product	Управление продуктами в каталоге.
az sphere get-support-data	Сбор диагностических данных о конфигурациях системы, облака и устройства.

Azure CLI позволяет настроить параметры конфигурации, упрощающие использование команд Интерфейса командной строки Azure Sphere, предоставляя значения по умолчанию для параметров, таких как --resource-group, --subscriptionили --catalog.

Команды, зависящие от устройства

Эта команда работает с локально подключенным устройством Azure Sphere. При попытке выполнить эту команду без подключенного устройства возвращается сообщение об ошибке. Дополнительные сведения о командах устройств см . в az sphere device

• az sphere device claim
• az sphere device recover
• az sphere device restart
• az sphere device show-attached
• az sphere device show-os-version
• az sphere device app show-memory-status
• az sphere device app show-quota
• az sphere device app show-status
• az sphere device app start
• az sphere device app stop
• az sphere device capability show-attached
• az sphere device capability update
• az sphere device certificate add
• az sphere device certificate delete
• az sphere device certificate list
• az sphere device certificate show
• az sphere device certificate show-quota
• az sphere device image list-installed
• az sphere image-package show
• az sphere device manufacturing-state show
• az sphere device manufacturing-state update
• az sphere device network proxy apply
• az sphere device network proxy delete
• az sphere device network proxy show
• az sphere device network disable
• az sphere device network enable
• az sphere device network list-firewall-rules
• az sphere device network list-interfaces
• az sphere device network show-diagnostics
• az sphere device network show-status
• az sphere device network update-interface
• az sphere device sideload delete
• az sphere device sideload deploy
• az sphere device wifi add
• az sphere device wifi disable
• az sphere device wifi enable
• az sphere device wifi forget
• az sphere device wifi list
• az sphere device wifi reload-config
• az sphere device wifi scan
• az sphere device wifi show
• az sphere device wifi show-status

Глобально доступные аргументы

Для расширения Azure Sphere доступны следующие глобальные параметры:

Параметр	Описание
--debug	Повышение уровня детализации журнала для включения всех журналов отладки.
--help -h	Отображает сообщение справки.
--only-show-errors	Отображаются только ошибки, подавление предупреждений.
--output -o	Формат вывода. Допустимые значения: json, jsonc, tablenone, tsv, yaml; yamlc По умолчанию: json.
--query	Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
--subscription	: имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
--verbose	Повышение уровня детализации журнала. Используйте параметр--debug, чтобы включить полные журналы отладки.