Интерактивный режим Azure Sphere CLI (предварительная версия)

Azure Sphere CLI поддерживает интерактивный режим, предоставляющий интерактивную среду для выполнения команд Azure Sphere CLI, которая идеально подходит для новых пользователей, изучающих возможности, структуры команд и форматы вывода интерфейса командной строки. Интерактивный режим можно запустить с помощью команды azsphere interactive в интерфейсе командной строки с помощью PowerShell, командной строки Windows или оболочки Bash. Командная строка изменится на azsphere>> , чтобы указать, что вы теперь выполняете команды в интерактивной оболочке.

Важно

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

Настроить

В интерактивном режиме при необходимости отображаются описания команд, описания параметров и примеры команд.

Параметр	Описание
F1	Включает или отключает описания и примеры.
F2	Включает или отключает отображение параметров по умолчанию.
F3	Переключает отображение некоторых ключевых жестов.
[CTRL+D]	Выход из интерактивного режима.

Настройка область

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

Например, при установке область как %%device certificate:

azsphere>> %%device certificate
defaulting: device
defaulting: certificate
azsphere device certificate>>

Чтобы удалить область введите, $ %% .. а для удаления всех областей введите , %%.

Примеры

В интерактивном режиме приведены примеры для некоторых команд в контекстном контексте при вводе команд. Если команда содержит слишком много примеров, чтобы поместиться в окне терминала, вы можете просмотреть все примеры, прокрутив область примеров с помощью клавиш CTRL+Y и CTRL+N для "вверх" и "вниз" соответственно.

Интерактивный режим предоставляет несколько способов создания и выполнения команды. Пример номера указан в области примеров. Вы можете выбрать конкретный объект для просмотра в области примеров. Например:

Автозавершение

В интерактивном режиме отображается результат введенной команды. Он предоставляет раскрывающийся список автозаполнения, автоматически кэшированные предложения и динамическую документацию, включая примеры использования каждой команды. Для параметров поддерживается --application-updateзавершение значения параметра , --debug-mode, --device, --device-group, --enable-rt-core-debugging--force, , --full--manual-start, --os-feed--none, , --product, --role--state, , --style, , --targeted-scan--type--temporary--tenantи .--user

Часто используемые команды

Интерактивный режим отслеживает ранее типизированные команды и наиболее часто используемые команды. Команда отображается при вводе начальных символов в интерфейсе командной строки.

Код выхода

Параметр $ позволяет просмотреть код выхода последней выполненной команды, чтобы убедиться, что она выполнена правильно. Например:

azsphere>> $
Success: 0

Команды вне интерактивного режима

Интерактивный режим Azure Sphere CLI позволяет пользователю выполнять команды за пределами Azure Sphere CLI без выхода из интерактивного режима с помощью #[command] интерфейса командной строки. Например:

azsphere>> #git --version
git version 2.28.0.windows.1

Команда Query Previous

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

azsphere>> azsphere product list
 ------------------------------------ ------------------------------------ --------------- --------------------
 Id                                   TenantId                             Name            Description
 ==============================================================================================================
 a2cd64be-adc2-4bfd-8f34-7d8c90293893 143adbc9-1bf0-4be2-84a2-084a331d81cb MyFridgeProduct None
 ------------------------------------ ------------------------------------ --------------- --------------------
 e5fe65f7-0df5-481e-9f4c-44b1a00d2d60 143adbc9-1bf0-4be2-84a2-084a331d81cb CoffeeMaker     None
 ------------------------------------ ------------------------------------ --------------- --------------------

Выходные данные запроса jmespath:

azsphere>> ??"[].{Productname:name}"
[
  {
    "Productname": "MyFridgeProduct"
  },
  {
    "Productname": "CoffeeMaker"
  }
]