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


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

Приветствуем в интерфейсе командной строки 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.

  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 организованы как группы команд. Каждая группа представляет область службы 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 to Z, который перечисляет все группы команд в алфавитном порядке.

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

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

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

Интерфейс командной строки имеет полное завершение вкладки для команд в среде 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 CLI записываются для оболочки Bash. Большинство одностроковых примеров будут выполняться на любой платформе. Более длинные примеры, включающие продолжение строк (\), назначение переменных или кавычки , необходимо изменить для работы в других оболочках, включая PowerShell. Дополнительные сведения о различиях синтаксиса между средами см. в разделе "Сведения о синтаксисе" между Bash, PowerShell и Cmd.

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

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

az feedback

См. также