Обзор расширения 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 Sphere, необходимо войти с помощью Azure CLI .

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

Совет

После входа вы увидите список подписок, связанных с вашей учетной записью 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 CLI

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

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

Команды Описание
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 CLI, предоставляя значения по умолчанию для таких параметров, как --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, none, tsvtable, , yaml, . yamlc По умолчанию: json.
--query Строка запроса JMESPath. Дополнительные сведения и примеры см http://jmespath.org/ . в этой статье.
--subscription : имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
--verbose Повышение детализации ведения журнала. Используется --debug для полных журналов отладки.