Подготовка среды к Azure CLI

На этом шаге руководства вы выполните первые Azure CLI команды. Это включает поиск и настройку активной подписки и настройки значений по умолчанию. Вы также узнаете, как создавать группы ресурсов, содержащие случайный идентификатор, чтобы всегда гарантировать уникальное имя ресурса.

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

Чтобы выполнить этот шаг руководства, вам нужны contributor или более высокие права доступа для вашей подписки.

Установка Azure CLI

Начните с выбора среды.

Используйте среду Bash в Azure Cloud Shell, нажав кнопку Open Cloud Shell в правом верхнем углу каждого блока кода Azure CLI.
Если вы предпочитаете запускать локально команды справки Azure CLI, установите Azure CLI.

Текущая версия Azure CLI — 2.85.0. Сведения о последнем выпуске см. в заметках о выпуске. Чтобы узнать, какая версия установлена и нужно ли ее обновить, выполните команду az version.

Существует несколько вариантов authentication при работе с Azure CLI. Метод аутентификации Azure CLI по умолчанию использует веб-браузер и маркер доступа для входа в систему.

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

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

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

Поиск и изменение активной подписки

После входа в Azure CLI всегда проверьте текущую подписку. Если вы не работаете в предпочитаемой подписке, измените подписку с помощью az account set. Ниже приведен пример кода для использования:

# see your current/default subscription
az account show

# find the list of subscriptions available to you
az account list --output table

# change your current/default subscription
az account set --subscription <mySubscriptionName>

# you can also set your subscription using a subscription ID
az account set --subscription <00000000-0000-0000-0000-000000000000>

Выходные данные консоли для az account show команды:

{
  "environmentName": "AzureCloud",
  "homeTenantId": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "isDefault": true,
  "managedByTenants": [],
  "name": "Your storage account name",
  "state": "Enabled",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "user": {
    "name": "yourName@contoso.com",
    "type": "user"
  }
}

Сведения о группах ресурсов

Группа ресурсов — это контейнер для Azure ресурсов. Чтобы создать группу ресурсов, вам потребуются contributor разрешения или более высокие разрешения в подписке.

Создайте группу ресурсов

В подписке имя группы ресурсов должно быть уникальным. Сначала проверьте, доступно ли нужное имя с помощью команды az group. Выходное значение false означает, что имя доступно.
```
az group exists --name <myUniqueRGname>
```
Получите список поддерживаемых регионов для подписки с помощью команды az account list-locations . Для списка доступных регионов Azure см. раздел Выбор подходящего региона Azure.
```
az account list-locations --query "[].{Region:name}" --output table
```
Пришло время создать группу ресурсов. Используйте команду az group create.
```
az group create --location <myLocation> --name <myUniqueRGname>
```

Создание группы ресурсов, содержащей случайный идентификатор

При тестировании рекомендуется создать группу ресурсов, содержащую случайный идентификатор в его имени. Добавление случайного идентификатора в имя группы ресурсов позволяет повторно тестировать код, не ожидая удаления предыдущей группы ресурсов с тем же именем из Azure.

Синтаксис переменных Bash и PowerShell отличаются. Скопируйте правильный скрипт для вашей среды.

Bash
PowerShell

let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

$randomIdentifier = (New-Guid).ToString().Substring(0,8)
$location="eastus"
$resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Выходные данные консоли Bash и PowerShell:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/msdocs-tutorial-rg-000000000",
  "location": "eastus",
  "managedBy": null,
  "name": "msdocs-tutorial-rg-000000000",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Настройка переменных среды

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

Задайте группу ресурсов по умолчанию.
```
az config set defaults.group=<msdocs-tutorial-rg-0000000>
```
Задайте сразу несколько переменных среды.

Многие параметры Azure CLI принимают несколько значений, разделенных пробелом. Значения конфигурации являются типичным примером. В следующем примере задаются параметры .location и .group по умолчанию, которые используются параметрами --location и --resource-group каждой команды Azure CLI.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Задайте выходные данные по умолчанию.

При выборе работы в Azure Cloud Shell или локальной установке Azure CLI выходные данные по умолчанию автоматически задаются для json. Однако этот параметр является одним из наиболее важных настройек по умолчанию, которые необходимо понимать и устанавливать. Выходные данные определяют, что отображается в консоли и что записано в файл журнала. Всегда используйте выходные данные none при создании ресурсов, возвращающих ключи, пароли и секреты.
```
az config set core.output=none
```
В этом руководстве мы не работаем с секретами. Установите значение по умолчанию на json, чтобы вы могли видеть возвращаемые выходные данные каждой справочной команды в этом руководстве.
```
az config set core.output=json
```

Узнайте, как использовать az init.

В Azure CLI есть справочная команда, которая описывает настройку среды. Введите az init в консоль и нажмите ВВОД. Следуйте предоставленным запросам.

az init

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

Your current config settings:

  Output format: JSON 
  [core.output = json]

  Standard error stream (stderr): All events 
  [core.only_show_errors = false]

  Error output: Show recommendations 
  [core.error_recommendation = on]

  Syntax highlighting: On 
  [core.no_color = false]

  Progress Bar: On 
  [core.disable_progress_bar = false]


Select an option by typing its number

  [1] Optimize for interaction
      These settings improve the output legibility and optimize for human interaction

  [2] Optimize for automation
      These settings optimize for machine efficiency

  [3] Customize settings
      A walk-through to customize common configurations

  [4] Exit (default)
      Return to the command prompt

? Your selection:

Поиск и чтение файла конфигурации.

Если вы работаете по принципу "доверяй, но проверяй", вы хотите знать, где хранятся файлы конфигурации и что в них содержится. Файл конфигурации расположен здесь: $AZURE_CONFIG_DIR/config. Значение по умолчанию AZURE_CONFIG_DIR равно $HOME/.azure в Linux и macOS, а %USERPROFILE%\.azure на Windows. Найдите файл конфигурации и просмотрите его содержимое.

Узнать больше деталей

Хотите подробнее об одном из тем, описанных на этом шаге руководства? Чтобы узнать больше, воспользуйтесь ссылками в этой таблице.

Тема	Подробнее
Окружающая среда	Выберите подходящее средство командной строки Azure
Параметры входа	Sign in with Azure CLI
Условия	Azure CLI терминология и уровни поддержки
Подписки	Управляйте подписками с помощью Azure CLI
Группы ресурсов	Управляйте группами ресурсов с помощью Azure CLI
Конфигурации	Configure Azure CLI
роли Azure	Роли Azure, роли Microsoft Entra и роли классической подписки администратора

Следующий шаг

Теперь, когда вы узнали, как настроить среду, перейдите к следующему шагу, чтобы понять различия сценариев между Bash, PowerShell и Cmd.exe.

Узнайте различия в синтаксисе Azure CLI в Bash, PowerShell и Cmd

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

Были ли сведения на этой странице полезными?

Last updated on 2026-03-03