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

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

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

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

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

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

Внимание

После завершения установки необходимо закрыть и повторно открыть любое активное окно терминала для использования Azure CLI.

Последняя версия

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

Если вы ранее установили Azure CLI, 32-разрядная или 64-разрядная MSI перезаписывает существующую установку.

Конкретная версия

Если вы предпочитаете, вы можете скачать определенную версию Azure CLI с помощью URL-адреса.

Чтобы скачать установщик MSI для определенной версии, измените сегмент версии в URL-адресе https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32-разрядная версия) или https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64-разрядная версия).

Например, чтобы установить 32-разрядную MSI azure CLI версии 2.51.0, url-адрес будет.https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi Соответствующая 64-разрядная установка будет https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Доступные версии Azure CLI можно найти в заметках о выпуске Azure CLI. 64-разрядная MSI доступна в версии 2.51.0.

Запуск Azure CLI

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

Включение завершения вкладок в 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 в Windows. Если у вас возникла проблема, не описанная здесь, сообщите об этом на сайте GitHub.

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

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

Внимание

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

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

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

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

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

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

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

  1. Проверьте текущую версию ИНТЕРФЕЙСА командной строки и установленные расширения, выполнив команду 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

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

az upgrade

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

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

Удаление

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

Удалите Azure CLI из списка "Приложения и возможности" в Windows. Для удаления сделайте следующее:

Платформа Instructions
Windows 11 Запуск > установленных > приложений > параметров
Windows 10 Запуск > параметров > приложений > и функций
Windows 8 и Windows 7 Пуск > Панель управления > Программы > Удалить программу

На этом экране введите 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.

Next Steps

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