Установка Azure CLI на Windows

Интерфейс Azure Command-Line (CLI) — это кроссплатформенное средство командной строки, которое можно установить локально на Windows компьютерах. Вы можете использовать Azure CLI для подключения к Windows Azure и выполнения административных команд на Azure ресурсах. Azure CLI также можно использовать из браузера через Azure Cloud Shell или запустить из контейнера Docker.

Для Windows Azure CLI устанавливается через MSI или ZIP-пакет, который предоставляет доступ к Azure CLI через PowerShell или командную строку Windows (cmd.exe). При установке Windows Subsystem for Linux (WSL) пакеты доступны для дистрибутива Linux. Список поддерживаемых диспетчеров пакетов и сведения об установке в WSL вручную см. на главной странице установки.

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

Установка или обновление

Дистрибутив MSI и ZIP используются для установки или обновления Azure CLI на Windows. Перед использованием установщика MSI не нужно удалять текущие версии, так как MSI обновляет любую существующую версию.

winget install --exact --id Microsoft.AzureCLI

winget install --exact --id Microsoft.AzureCLI --version 2.67.0

$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi
Start-Process msiexec.exe -Wait -ArgumentList '/I', 'AzureCLI.msi', '/quiet'
Remove-Item .\AzureCLI.msi

$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi
Start-Process msiexec.exe -Wait -ArgumentList '/I', 'AzureCLI.msi', '/quiet'
Remove-Item .\AzureCLI.msi

Запустите Azure CLI

После установки закройте и снова откройте любое активное окно терминала. Запустите Azure CLI с помощью команды az из PowerShell или командной строки Windows.

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

az login

Первым шагом является проверка активной подписки.

az account show

Устранение неполадок установки

Ниже приведены некоторые распространенные проблемы при установке Azure CLI на Windows. Если возникла проблема, не описанная здесь, создайте запрос на GitHub.

Переменная PATH не задана

Наиболее распространенной причиной этой проблемы является не перезапуск активного окна терминала после установки. Закройте и снова откройте любое активное окно терминала.

Прокси-сервер блокирует подключение

Если вы не можете скачать установщик MSI, так как прокси-сервер блокирует подключение, убедитесь, что у вас настроен прокси-сервер. Для Windows 11 эти параметры управляются в области Settings > Network & Internet > Proxy. Обратитесь к системному администратору за необходимыми параметрами или в ситуациях, когда компьютер может управляться конфигурацией или требовать расширенной настройки.

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

Чтобы получить MSI, прокси-сервер должен разрешить подключения HTTPS к следующим адресам:

• https://aka.ms/
• https://azcliprod.blob.core.windows.net/

Для получения дополнительной информации см. раздел Работа с использованием прокси-сервера в руководстве по устранению неполадок Azure CLI.

Время медленного отклика

См. Переход на 64-разрядную Azure CLI

Включение завершения вкладки в PowerShell

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

Завершение вкладки по умолчанию включено в Azure Cloud Shell и в большинстве дистрибутивов Linux. Начиная с Azure CLI версии 2.49 можно включить завершение вкладки для Azure CLI в PowerShell. Выполните следующие действия.

1. Создайте или измените профиль, хранящийся в переменной $PROFILE. Самый простой способ — запустить notepad $PROFILE в PowerShell. Дополнительные сведения см. в разделах How to create your profile (Как создать свой профиль) и Profiles and execution policy (Профили и политика выполнения).

2. Добавьте следующий код в профиль PowerShell:

   Register-ArgumentCompleter -Native -CommandName az -ScriptBlock {
       param($commandName, $wordToComplete, $cursorPosition)
       $completion_file = New-TemporaryFile
       $env:ARGCOMPLETE_USE_TEMPFILES = 1
       $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
       $env:COMP_LINE = $wordToComplete
       $env:COMP_POINT = $cursorPosition
       $env:_ARGCOMPLETE = 1
       $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
       $env:_ARGCOMPLETE_IFS = "`n"
       $env:_ARGCOMPLETE_SHELL = 'powershell'
       az 2>&1 | Out-Null
       Get-Content $completion_file | Sort-Object | ForEach-Object {
           [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
       }
       Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
   }
   

3. Чтобы отобразить все доступные параметры в меню, добавьте Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete в профиль PowerShell.

Обновление Azure CLI

Начиная с версии 2.11.0 Azure CLI предоставляет команду в средстве для обновления до последней версии.

az upgrade

Эта команда также по умолчанию обновляет все установленные расширения. Для получения дополнительных az upgrade параметров см. справочную страницу по командам. Для версий Azure CLI до 2.11.0 обновите, переустановив, как описано в Install Azure CLI.

Если вы используете ZIP-дистрибутив, удалите старую папку установки и извлеките новую версию в то же расположение.

Миграция на 64-разрядную Azure CLI

Начиная с версии 2.51.0, Azure CLI также предоставляет 64-разрядную MSI, которая рекомендуется для повышения производительности.

Выполните следующие действия, чтобы перейти на 64-разрядную версию Azure CLI:

1. Проверьте текущую версию Azure CLI и установленные расширения, выполнив az --version.
2. Для расширений требуется переустановка. Создайте резервную копию текущей папки %userprofile%\.azure\cliextensions расширения, переименовав ее, если вы решили вернуться к 32-разрядной версии. Эта папка создается автоматически при переустановке расширения.
3. Скачайте и установите последний 64-разрядный установщик, как описано в разделе "Установка или обновление". 32-разрядная MSI автоматически деинсталлируется.
4. Установите расширения, выполнив команду az extension add --name <extension> --version <version>. Если вы не хотите переустановить расширения вручную, Azure CLI предложит установить расширение при первом использовании. Дополнительные сведения об установке расширений см. в разделе "Установка расширений".

При возникновении проблем после миграции можно удалить 64-разрядную версию и переустановить 32-разрядную MSI. Если вы сделали резервную копию 32-разрядной папки расширений, восстановите или переименуйте папку расширения после изменения.

Деинсталляция

Если вы решите удалить Azure CLI, мы сожалеем, что вы решили это сделать. Перед удалением воспользуйтесь командой az feedback, чтобы сообщить нам, что можно улучшить или исправить. Наша цель заключается в том, чтобы сделать Azure CLI без ошибок и удобных для пользователей. Если вы нашли ошибку, мы будем признательны, если вы заведете проблему в GitHub.

Вы удалите Azure CLI из списка Windows "Приложения и компоненты". Как удалить:

Когда вы будете на этом экране, введите Azure CLI в строке поиска программы. Программа для удаления указана как Microsoft CLI 2.0 для Azure. Выберите это приложение, а затем нажмите кнопку Uninstall .

Удаление данных

Если вы не планируете переустановить Azure CLI, удалите данные из C:\Users\<username>\.azure\msal_token_cache.bin или C:\Users\<username>\.azure\msal_token_cache.json.

Дальнейшие шаги

Теперь, когда вы установили Azure CLI на Windows, узнайте о различных способах входа.