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

Добро пожаловать в Azure CLI!Welcome to the Azure CLI! CLI — это средство, предназначенное для быстрой и эффективной работы со службами Azure с возможностью автоматизации.The CLI is a tool designed to get you working quickly and efficiently with Azure services, with an emphasis on automation. В этой статье рассматриваются возможности CLI и приводятся ссылки на связанные ресурсы.This article introduces features of the CLI and links out to resources that help you be productive.

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

Самый простой способ приступить к работе с Azure CLI —запустить CLI в среде Azure Cloud Shell через браузер.The easiest way to get started with the Azure CLI is by running it in an Azure Cloud Shell environment through your browser. Дополнительные сведения о Cloud Shell см. в кратком руководстве по Bash в Azure Cloud Shell.To learn about Cloud Shell, see Quickstart for Bash in Azure Cloud Shell.

Сведения об установке CLI см. в разделе Установка Azure CLI 2.0.When you're ready to install the CLI, see the installation instructions.

Установив CLI впервые, проверьте правильность установки и версии, выполнив команду az --version.After installing the CLI for the first time, check that it's installed and you've got the correct version by running az --version.

ВходSign in

Прежде чем использовать команды CLI при локальной установке, необходимо войти с помощью команды az login.Before using any CLI commands with a local install, you need to sign in with az login.

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

    az login
    

    Если CLI сможет запустить браузер по умолчанию, он откроет в браузере страницу входа.If the CLI can open your default browser, it will do so and load a sign-in page.

    В противном случае вам потребуется открыть страницу браузера и выполнить инструкции в командной строке, чтобы ввести код авторизации после перехода по адресу https://aka.ms/devicelogin в браузере.Otherwise, you need to open a browser page and follow the instructions on the command line to enter an authorization code after navigating to https://aka.ms/devicelogin in your browser.

  2. Выполните вход в браузере с помощью учетных данных.Sign in with your account credentials in the browser.

После входа в систему появится список подписок, связанных с учетной записью Azure.After logging in, you see a list of subscriptions associated with your Azure account. В сведениях о подписке с isDefault: true указана текущая активная подписка, отображаемая после входа.The subscription information with isDefault: true is the currently activated subscription after logging in. Чтобы выбрать другую подписку, укажите идентификатор подписки с помощью команды az account set.To select another subscription, use the az account set command with the subscription ID to switch to. См. дополнительные сведения о выборе нужной подписки при использовании нескольких подписок Azure.For more information about subscription selection, see Use multiple Azure subscriptions.

Вы также можете войти в автономном режиме, как описано в руководстве по входу с помощью Azure CLI.There are ways to sign in non-interactively, which are covered in detail in Sign in with Azure CLI.

Стандартные командыCommon commands

В таблице приведены некоторые распространенные команды CLI и ссылки на справочную документацию.This table lists some common commands used in the CLI and links to their reference documentation.

Тип ресурсаResource type Группа команд Azure CLIAzure CLI command group
Группа ресурсовResource group az groupaz group
Виртуальные машиныVirtual machines az vmaz vm
Учетные записи храненияStorage accounts az storage accountaz storage account
хранилище ключей;Key Vault az keyvaultaz keyvault
Веб-приложенияWeb applications az webappaz webapp
Базы данных SQLSQL databases az sql serveraz sql server
Cosmos DBCosmosDB az cosmosdbaz cosmosdb

Поиск командFinding commands

Команды CLI организованы в виде групп команд.Commands in the CLI are organized as commands of groups. Каждая группа представляет службу Azure, с которой работают эти команды.Each group represents an Azure service, and commands operate on that service.

Чтобы найти команды, используйте команду az find.To search for commands, use az find. Например, чтобы найти команды, содержащие secret, используйте следующую команду:For example, to search for command names containing secret, use the following command:

az find secret

Аргумент --help позволяет получить полный список команд и подгрупп в группе.Use the --help argument to get a complete list of commands and subgroups of a group. Например, вот как можно найти команды CLI для работы с группами безопасности сети (NSG):For example, to find the CLI commands for working with Network Security Groups (NSGs):

az network nsg --help

В CLI доступна функция заполнения нажатием клавиши TAB для команд в оболочке Bash.The CLI has full tab completion for commands under the bash shell.

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

Для каждой команды есть ряд аргументов.There are some arguments that are available for every command.

  • --help выводит справочные сведения CLI о командах и их аргументах, а также перечисляет доступные подгруппы и команды.--help prints CLI reference information about commands and their arguments and lists available subgroups and commands.
  • --output изменяет формат выходных данных.--output changes the output format. Доступные выходные форматы: json, jsonc (выделенные цветом данные JSON), tsv (значения с разделением знаками табуляции), table (понятные таблицы ASCII) и yaml.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. По умолчанию CLI выводит формат json.By default the CLI outputs json. См. дополнительные сведения о форматах выходных данных для Azure CLI.To learn more about the available output formats, see Output formats for Azure CLI.
  • --query использует язык запросов JMESPath для фильтрации результатов, возвращенных от служб Azure.--query uses the JMESPath query language to filter the output returned from Azure services. См. дополнительные сведения о создании запросов к результатам выполнения команд в Azure CLI и работе с JMESPath.To learn more about queries, see Query command results with Azure CLI and the JMESPath tutorial.
  • --verbose выводит сведения о ресурсах, созданных в Azure во время выполнения операции, а также другую полезную информацию.--verbose prints information about resources created in Azure during an operation, and other useful information.
  • --debug выводит дополнительные сведения об операциях CLI, выполняемых для отладки.--debug prints even more information about CLI operations, used for debugging purposes. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.

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

CLI можно использовать в интерактивном режиме для автоматического отображения справочных сведений и упрощения выбора подкоманд.The CLI offers an interactive mode that automatically displays help information and makes it easier to select subcommands. Перейти в интерактивный режим можно с помощью команды az interactive.You enter interactive mode with the az interactive command.

az interactive

См. дополнительные сведения об интерактивном режиме Azure CLI.For more information on interactive mode, see Azure CLI Interactive Mode.

Также доступно расширение для Visual Studio Code, которое предлагает интерактивный интерфейс с функциями автозавершения и отображения документации при наведении курсора.There's also a Visual Studio Code plugin that offers an interactive experience, including autocomplete and mouse-over documentation.

Дополнительные сведения о CLI, представляемые в кратких и подробных руководствахLearn CLI basics with quickstarts and tutorials

Чтобы приступить к работе с Azure CLI, ознакомьтесь с подробным руководством по настройке виртуальных машин и использовании функций CLI для выполнения запросов к ресурсам Azure.To get you started with the Azure CLI, try an in-depth tutorial for setting up virtual machines and using the power of the CLI to query Azure resources.

Также доступны краткие руководства по работе с другими популярными службами.There are also quickstarts for other popular services.

Обратная связьGive feedback

Мы рады вашим отзывам о CLI, которые помогают нам улучшать наш продукт и устранять ошибки.We welcome your feedback for the CLI to help us make improvements and resolve bugs. Вы можете опубликовать описание проблемы на GitHub или использовать встроенные функции CLI, чтобы оставить отзыв с помощью команды az feedback.You can file an issue on GitHub or use the built-in features of the CLI to leave general feedback with the az feedback command.

az feedback