Начало работы с Azure CLI

Статья
2024-09-19

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

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

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

Когда вы будете готовы установить Azure CLI, ознакомьтесь с инструкциями по установке контейнера Windows, Linux, macOS и Docker. Если вы используете классическую модель развертывания Azure, установите классический интерфейс командной строки Azure.

Проверьте версию, выполнив команду az --version. Azure Cloud Shell всегда имеет последнюю версию предварительно установленного интерфейса командной строки Azure.

az version

Вход в Azure CLI

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

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

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

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

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

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

Поиск команд

Команды Azure CLI организованы как группы команд. Каждая группа представляет область службы Azure. Существует два варианта поиска групп команд:

Используйте команду az find. Например, чтобы найти команды, содержащие vm, используйте следующую команду:
```
az find vm
```
--help Используйте аргумент, чтобы получить полный список подгрупп в эталонной группе. В этом примере возвращаются все подгруппы для виртуальных машин:
```
az vm --help
```
Ниже приведен пример выходных данных со строками, опущенными для краткости:
```
Subgroups:
  application            : Manage applications for VM.
  availability-set       : Group resources into availability sets.
  boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
  ...
```
Ниже приведен еще один пример, который находит команды Azure CLI для группировки виртуальных машин в наборы доступности, подгруппы от az vm:
```
az vm availability-set --help
```
Также используется --help для получения списков параметров и примеров команд для эталонной команды.
```
az vm create --help
```
Ниже приведен пример выходных данных со строками, опущенными для краткости:
```
Arguments
    --name  [Required] : Name of the virtual machine.
    ...
Authentication Arguments
    --admin-password   : Password for the VM if authentication type is 'Password'.
    --admin-username   : Username for the VM...
    ...
Managed Service Identity Arguments
    ...
Examples
    Create a VM from a custom managed image.
      az vm create -g MyResourceGroup -n MyVm --image MyImage
    ...
```
Используйте справочный указатель от A до Z, который перечисляет все группы команд в алфавитном порядке.

Поиск опубликованных примеров и статей

Если вы предпочитаете изучать синтаксис Azure CLI, просматривая проверенные примеры, существует два индекса содержимого статьи:

Индекс примеров от A до Z. Индекс примеров содержит список примеров Azure CLI, отсортированных по темам, ссылочной группе и репозиторию GitHub.

Индекс статьи A до Z. find Используйте сочетания клавиш, например Ctrl + F, чтобы быстро перейти к справочной группе команд, в которой вы заинтересованы. Например, индекс статьи выглядит примерно так:az vm

Ссылка на подгруппу	Статья Azure CLI с справочными сведениями об использовании
az vm	Форматы выходных данных для команд Azure CLI
	Использование переменных в командах Azure CLI
	Получение сведений о виртуальной машине с помощью запросов
	{Дополнительные статьи, перечисленные здесь.}
az vm aem	Новая версия расширения виртуальной машины Azure для решений SAP
	Стандартная версия расширения виртуальной машины Azure для решений SAP
az vm application	{...}

Использование завершения вкладки

Интерфейс командной строки имеет полное завершение вкладки для команд в среде Bash. Чтобы включить завершение вкладки в среде PowerShell, см . раздел "Включить завершение вкладки" в PowerShell.

Помните о аргументах, доступных глобально

Существует несколько аргументов, доступных для большинства команд.

--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, в отправляемый отчет об ошибке. Его можно использовать, например, для идентификации REST API, выполняемой командой, вызываемой под ней, и ответа, полученного от службы.
--subscription — это имя или идентификатор подписки. Дополнительные сведения о настройке подписки по умолчанию см. в статье "Управление подписками Azure" с помощью Azure CLI.
--only-show-errors подавляет предупреждения в выходных данных команды и отображает только ошибки.

Использование интерактивного режима

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

az interactive

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

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

Изучите основы Azure CLI с помощью быстрых и полных руководств.

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

Найдите и измените подписку по умолчанию.
Создайте ресурс Azure, содержащий случайный идентификатор в имени.
Задайте переменные среды.
Узнайте о различиях синтаксиса между Bash, PowerShell и Cmd.
Отладка ссылочных команд Azure CLI.
Получение свойств из локального JSON-файла.. В этом примере показано, как получить значения конфигурации для разработки, этапа и рабочей среды.
Удаление нескольких ресурсов с помощью скрипта.

Примечание.

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

Оставить отзыв

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

az feedback