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

Статья
11/21/2024

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.68.0. Сведения о последнем выпуске см. в заметках о выпуске. Чтобы узнать, какая версия установлена и нужно ли ее обновить, выполните команду az version.

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

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

Внимание

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

WinGet (диспетчер пакетов Windows)

Используйте WinGet, диспетчер пакетов Майкрософт для Windows, чтобы установить и управлять обновлениями для Azure CLI. По умолчанию Winget устанавливает 64-разрядную версию Azure CLI в 64-разрядных операционных системах.

Примечание.

WinGet доступна по умолчанию в Windows 11 и современных версиях Windows 10. Более ранние версии Windows не поддерживаются. Инструкции по установке см. в документации winget.

winget install -e --id Microsoft.AzureCLI

-e позволяет убедиться, что установлен официальный пакет Azure CLI. Эта команда устанавливает последнюю версию по умолчанию. Чтобы указать версию, добавьте -v <version> нужную версию в команду. Ниже приведен пример:

winget install -e --id Microsoft.AzureCLI -v 2.66.0

Установщик Майкрософт (MSI)

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

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

Последняя версия MSI Azure CLI (32-разрядная версия)

Последняя версия MSI Azure CLI (64-разрядная версия)

Если вы ранее установили 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.

Установщик Майкрософт (MSI) с PowerShell

Чтобы установить Azure CLI с помощью PowerShell, запустите PowerShell от имени администратора и выполните следующую команду:

$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

Будет скачан и установлен последний 32-разрядный установщик Azure CLI для Windows. Если вы предпочитаете 64-разрядную установку, измените URL-адрес https://aka.ms/installazurecliwindowsx64на . Если Azure CLI уже установлен, установщик перезаписывает существующую версию.

Чтобы установить определенную версию, замените аргумент -Uri URL-адресом, описанным в следующем разделе. Ниже приведен пример использования 32-разрядного установщика Azure CLI версии 2.51.0 в PowerShell:

$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. 64-разрядная MSI доступна в версии 2.51.0.

Различия синтаксиса между Bash и PowerShell

Хотя большая часть документации по Azure CLI написана и протестирована в оболочке Bash, вы также можете установить и запустить Azure CLI с помощью PowerShell. Между Bash и PowerShell существуют тонкие различия синтаксиса. Ознакомьтесь со следующими статьями, чтобы избежать ошибок сценариев:

Рекомендации по запуску Azure CLI на языке сценариев PowerShell
Использование кавычки в параметрах Azure CLI
Сравнение синтаксиса Bash, PowerShell и Cmd.exe в Azure CLI с различиями синтаксиса Bash, PowerShell и Cmd

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

ZIP-пакет

Внимание

Этот пакет в настоящее время находится в предварительной версии.

Zip-пакет можно использовать для установки Azure CLI в Windows. Этот пакет полезен, если у вас нет прав администратора.

Распакуйте пакет в папку, а затем с помощью Cmd или PowerShell вызовите Azure CLI, выполнив команду <unzipped folder path>\bin\az.cmd.

Если вы хотите выполнить az команду напрямую, выполните приведенные ниже действия, чтобы добавить Azure CLI в PATH переменную среды.

Откройте меню "Пуск" и найдите environment variables. Нажмите кнопку Edit the system environment variables.
Нажмите кнопку Environment Variables....
User varibles for <username> В поле выберите Path и нажмите кнопкуEdit....
New Нажмите кнопку и добавьте <unzipped folder path>\bin его в список.
Перезапустите терминал. Теперь вы сможете выполнять az команды.

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

Последний ZIP-файл Azure CLI (64-разрядная версия)

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

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

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

Например, чтобы установить 64-разрядный ZIP-файл Azure CLI версии 2.57.0, будет url-адрес https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

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

Запуск Azure CLI

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

az account show

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

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

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

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

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

Если вы не можете скачать установщик 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/

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

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

См. статью "Миграция в 64-разрядную версию Azure CLI"

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

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

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

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

Добавьте следующий код в профиль 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
}

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

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

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

az upgrade

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

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

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

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

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

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

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

Удаление

Нам будет очень жаль, если вы решите удалить 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, узнайте о различных способах входа.

Вход с помощью Azure CLI

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

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

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

WinGet (диспетчер пакетов Windows)

Установщик Майкрософт (MSI)

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

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

Установщик Майкрософт (MSI) с PowerShell

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

Различия синтаксиса между Bash и PowerShell

ZIP-пакет

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

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

Запуск Azure CLI

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

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

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

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

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

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

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

Удаление

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

Next Steps

Дополнительные ресурсы