Приступая к работе с Azure CLI

Приветствуем в интерфейсе командной строки Azure (Azure CLI)! В этой статье собрана информация об интерфейсе командной строки и выполнении стандартных задач.

Примечание.

В скриптах и на сайте документации Майкрософт примеры Azure CLI написаны для оболочки bash. Однострочные примеры можно запускать на любой платформе. Более длинные примеры, включающие символы продолжения строки (\) или присвоение значения переменной, нужно изменить для использования в других оболочках, включая PowerShell.

Установка или запуск в Azure Cloud Shell

Самый простой способ изучить, как использовать Azure CLI — запустить это средство в среде Azure Cloud Shell с помощью браузера. Дополнительные сведения о Cloud Shell см. в кратком руководстве по Bash в Azure Cloud Shell.

Сведения об установке CLI см. в разделе Установка Azure CLI 2.0.

Установив CLI впервые, проверьте правильность установки и версии, выполнив команду az --version.

Примечание.

Если вы используете классическую модель развертывания Azure, установите классический интерфейс командной строки Azure.

Как войти в Azure CLI

Прежде чем использовать команды Azure CLI при локальной установке, необходимо войти с помощью команды az login.

  1. Выполните команду az login.

    az login
    

    Если Azure CLI может открыть браузер по умолчанию, он инициирует поток кода авторизации и открывает браузер по умолчанию для загрузки страницы входа Azure.

    В противном случае он инициирует поток кода устройства и указывает, на что вы откроете страницу браузера.https://aka.ms/devicelogin Затем введите код, отображаемый в терминале.

    Если веб-браузер недоступен или его не удается открыть, вы можете использовать поток кода устройства с применением az login --use-device-code.

  2. Выполните вход в браузере с помощью учетных данных.

После входа в систему появится список подписок, связанных с учетной записью Azure. В сведениях о подписке с isDefault: true указана текущая активная подписка, отображаемая после входа. Чтобы выбрать другую подписку, укажите идентификатор подписки с помощью команды az account set. См. дополнительные сведения о выборе нужной подписки при использовании нескольких подписок Azure.

Вы также можете войти в автономном режиме, как описано в руководстве по входу с помощью Azure CLI.

Выполнение команд Azure CLI

В таблице приведены некоторые распространенные команды CLI и ссылки на справочную документацию.

Тип ресурса Группа команд Azure CLI
Группа ресурсов az group
Виртуальные машины az vm
Учетные записи хранения az storage account
Хранилище ключей az keyvault
Веб-приложения az webapp
Базы данных SQL az sql server
Cosmos DB az cosmosdb

Поиск команд

Команды Azure CLI организованы в виде группкоманд. Каждая группа представляет службу Azure, с которой работают эти команды.

Чтобы найти команды, используйте команду az find. Например, чтобы найти команды, содержащие secret, используйте следующую команду:

az find secret

Аргумент --help позволяет получить полный список команд и подгрупп в группе. Например, вот как можно найти команды CLI для работы с группами безопасности сети (NSG):

az network nsg --help

В CLI доступна функция заполнения нажатием клавиши TAB для команд в оболочке Bash.

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

Для каждой команды есть ряд аргументов.

  • --help выводит справочные сведения CLI о командах и их аргументах, а также перечисляет доступные подгруппы и команды.
  • --output изменяет формат выходных данных. Доступные выходные форматы: json, jsonc (выделенные цветом данные JSON), tsv (значения с разделением знаками табуляции), table (понятные таблицы ASCII) и yaml. По умолчанию CLI выводит формат json. См. дополнительные сведения о форматах выходных данных для Azure CLI.
  • --query использует язык запросов JMESPath для фильтрации результатов, возвращенных от служб Azure. См. дополнительные сведения о создании запросов к результатам выполнения команд в Azure CLI и работе с JMESPath.
  • --verbose выводит сведения о ресурсах, созданных в Azure во время выполнения операции, а также другую полезную информацию.
  • --debug выводит дополнительные сведения об операциях CLI, выполняемых для отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке.

Интерактивный режим

CLI можно использовать в интерактивном режиме для автоматического отображения справочных сведений и упрощения выбора подкоманд. Перейти в интерактивный режим можно с помощью команды az interactive.

az interactive

См. дополнительные сведения об интерактивном режиме Azure CLI.

Также доступно расширение для Visual Studio Code, которое предлагает интерактивный интерфейс с функциями автозавершения и отображения документации при наведении курсора.

Дополнительные сведения о CLI, представляемые в кратких и подробных руководствах

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

Существуют также краткие руководства по другим популярным службам.

Отправить отзыв

Мы рады вашим отзывам о CLI, которые помогают нам улучшать наш продукт и устранять ошибки. Вы можете опубликовать описание проблемы на GitHub или использовать встроенные функции CLI, чтобы оставить отзыв с помощью команды az feedback.

az feedback

См. также