Поделиться через

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

  • Статья

Внимание

Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).

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

Доступны следующие команды:

Примечание.

Команда register-user теперь устарела.

Интерфейс командной строки Azure Sphere и классический интерфейс командной строки Azure Sphere

Интерфейс командной строки Azure Sphere устанавливается вместе с существующим интерфейсом командной строки в Windows и Linux, поэтому у вас есть доступ к обоим интерфейсам. Классический интерфейс командной строки Azure Sphere продолжает работать так же, как и всегда.

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

  • В Windows используйте PowerShell или стандартную командную строку Windows.
  • В Linux используйте любую командную оболочку. Укажите команду azsphere, если вы задали Azure Sphere CLI в качестве значения по умолчанию во время установки пакета SDK или команду azsphere_v2 , если вы задали классический интерфейс командной строки Azure Sphere в качестве значения по умолчанию.

Дополнительные сведения о функциях и командах, поддерживаемых Azure Sphere CLI, см . в Azure Sphere CLI.

Внимание

  • В Windows ярлык командной строки классической командной строки разработчика Azure Sphere можно использовать только с классическим интерфейсом командной строки Azure Sphere.

Формат командной строки

Командная строка azsphere имеет следующий формат:

azsphere [command] [subcommand] operation [parameters]

В общем, команда и подкоманда являются существительными, а операция — это глагол, таким образом, их комбинация идентифицируется как действие, так и объект действия. Большинство команд и операций имеют как полное имя, так и аббревиатуру. Например, команда устройства сокращена d.

Большинство параметров имеют как полное имя, так и аббревиатуру. В командной строке введите полное имя с двумя дефисами и аббревиатуру с одним дефисом. Например, следующие две команды эквивалентны:

azsphere device wifi add --ssid MyNetwork --psk mynetworkkey

azsphere device wifi add -s MyNetwork -p mynetworkkey

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

azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2

Кавычки и escape-символы

При работе с командами Интерфейса командной строки Azure Sphere помните о том, как оболочка использует кавычки и экранирует символы. Если вы намерены поддерживать скрипты, выполняемые в разных оболочках, необходимо хорошо понимать различия между ними.

Например:

Зависимые от облака команды

Для выполнения следующих команд azsphere требуется подключение к облаку и вход в службу безопасности Azure Sphere:

  • ca-certificate
  • device-group
  • get-support-data
  • Изображение
  • Вход
  • Выход
  • продукт
  • роль
  • show-user
  • tenant

Кроме того, для выполнения следующих команд azsphere device также требуется подключение к облаку:

Команда azsphere device Комментарии
capability; Требуется служба безопасности Azure Sphere для скачивания возможностей устройства
claim
enable-cloud-test
enable-development
Изображение
список
recover Требуется подключение к Интернету. Входить в службу безопасности Azure Sphere не требуется.
show
show-count
show-deployment-status
show-os-version Требуется подключение к Интернету. Входить в службу безопасности Azure Sphere не требуется.
обновить

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

Для устройств в производственном состоянии DeviceComplete требуется использовать следующие команды azsphere deviceComplete:

Операция Description
Приложение Управление приложениями на подключенном устройстве.
capability; Управление конфигурациями возможностей устройств. Требуется для обновления возможностей.
сертификат Управление хранилищем сертификатов на устройстве.
Изображение Управление образами устройств.
производственное состояние Управление состоянием производства подключенных устройств. Требуется для обновления состояния производства.
restart Перезагрузка подключенного устройства.
show-deployment-status Отображение состояния развертывания операционной системы и приложений на подключенном устройстве.
show-os-version Отображение версии операционной системы на подключенном устройстве.
загрузка неопубликованных данных Развертывание приложений и управление ими на подключенном устройстве. Требуется для развертывания и удаления неопубликованных данных.
wifi Управление конфигурациями Wi-Fi для подключенного устройства.

Если вы пытаетесь выполнить эти команды без возможности, вы получите сообщение об ошибке, указывающее, что вы будете запускать azsphere device enable-development или использовать azsphere device capability для скачивания и выбора файла возможностей для устройства.