Прочитать на английском

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

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

  • Статья
Выбор метода установки

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

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

Текущая версия Azure CLI 2.70.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.

PowerShell 
winget install --exact --id Microsoft.AzureCLI

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

PowerShell 
winget install --exact --id Microsoft.AzureCLI --version 2.67.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 от имени администратора и выполните следующую команду:

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:

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

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

Чтобы скачать установщик 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.

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

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

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

ZIP-пакет

Важно!

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

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

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

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

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

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

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

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

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

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

Например, чтобы установить Azure CLI версии 2.57.0 в 64-разрядном формате ZIP-файла, ваш 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. Первым шагом является проверка активной подписки.

Azure CLI 
az account show

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

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

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

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

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

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

Важно!

Эти параметры также требуются для доступа к службам Azure с помощью CLI, PowerShell или командной строки. В 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. Выполните следующие действия:

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

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

    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 предоставляет команду в средстве для обновления до последней версии.

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-разрядной версии:

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

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

Платформа Инструкции
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.

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

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

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