Общие сведения об Azure Sphere CLI

  • Статья

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

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

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

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

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

  • В 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 CLI имейте в виду, как оболочка использует кавычки и экранирует символы. Если вы поддерживаете скрипты, используемые в разных оболочках, необходимо понять, чем они отличаются.

Например:

Команды, зависящие от облака

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

  • ca-certificate
  • группа устройств
  • get-support-data
  • Изображения
  • Входа
  • Выход
  • Продукта
  • register-user
  • Роль
  • show-user
  • Арендатор

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

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

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

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

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

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