Udostępnij za pośrednictwem

Instalowanie interfejsu wiersza polecenia platformy Azure w systemie Windows

  • Artykuł

Interfejs wiersza polecenia platformy Azure to międzyplatformowe narzędzie wiersza polecenia, które można zainstalować lokalnie na komputerach z systemem Windows. Interfejs wiersza polecenia platformy Azure dla systemu Windows umożliwia nawiązywanie połączenia z platformą Azure i wykonywanie poleceń administracyjnych w zasobach platformy Azure. Interfejs wiersza polecenia platformy Azure dla systemu Windows może być również używany z przeglądarki za pośrednictwem usługi Azure Cloud Shell lub uruchamiany z poziomu kontenera platformy Docker.

W przypadku systemu Windows interfejs wiersza polecenia platformy Azure jest instalowany za pośrednictwem pakietu MSI lub ZIP, który zapewnia dostęp do interfejsu wiersza polecenia za pośrednictwem wiersza polecenia systemu Windows (CMD) lub programu PowerShell. Przy instalacji Podsystemu Windows dla systemu Linux (WSL) pakiety są dostępne dla wybranej dystrybucji systemu Linux. Listę obsługiwanych menedżerów pakietów oraz instrukcję ręcznej instalacji w podsystemie WSL można znaleźć na stronie głównej instalacji.

Bieżąca wersja interfejsu wiersza polecenia platformy Azure to 2.70.0. Aby uzyskać informacje o najnowszej wersji, zobacz informacje o wersji. Aby znaleźć zainstalowaną wersję i sprawdzić, czy chcesz ją zaktualizować, uruchom polecenie az version.

Instalowanie lub aktualizowanie

W systemie Windows pakiety instalacyjne MSI i ZIP są używane do instalowania lub aktualizowania Azure CLI. Nie musisz odinstalowywać aktualnych wersji przed użyciem instalatora MSI, ponieważ MSI aktualizuje każdą istniejącą wersję.

Ważne

Po zakończeniu instalacji należy zamknąć i ponownie otworzyć wszystkie aktywne okno terminalu, aby użyć interfejsu wiersza polecenia platformy Azure.

WinGet (Menedżer pakietów systemu Windows)

Użyj WinGet, menedżera pakietów firmy Microsoft dla systemu Windows, aby zainstalować aktualizacje interfejsu wiersza polecenia platformy Azure i zarządzać nimi. Domyślnie, na 64-bitowych systemach operacyjnych, Winget instaluje 64-bitowy Azure CLI.

Uwaga

WinGet jest domyślnie dostępny w systemie Windows 11 i nowoczesnych wersjach systemu Windows 10. Jednak może nie być zainstalowany w starszych wersjach systemu Windows. Zobacz dokumentację winget w celu uzyskania instrukcji instalacji.

winget install --exact --id Microsoft.AzureCLI

Opcja --exact polega na upewnieniu się, że jest zainstalowany oficjalny pakiet interfejsu wiersza polecenia platformy Azure. To polecenie domyślnie instaluje najnowszą wersję. Aby określić wersję, dodaj element --version <version> z żądaną wersją do polecenia . Oto przykład:

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

Instalator Microsoft (MSI)

Najnowsza wersja

Pobierz i zainstaluj najnowszą wersję interfejsu wiersza polecenia platformy Azure. Gdy instalator zapyta, czy może wprowadzić zmiany na komputerze, wybierz pole "Tak".

Najnowszy instalator MSI dla Azure CLI (32-bitowy)

Najnowszy pakiet MSI dla Azure CLI (64-bitowy)

Jeśli wcześniej zainstalowałeś Azure CLI, uruchomienie instalatora MSI w wersji 32-bitowej lub 64-bitowej spowoduje nadpisanie istniejącej instalacji.

Określona wersja

Jeśli wolisz, możesz pobrać określoną wersję interfejsu wiersza polecenia platformy Azure przy użyciu adresu URL.

Aby pobrać instalator MSI dla określonej wersji, zmień segment wersji w adresie URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32-bitowy) lub https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64-bitowy).

Na przykład aby zainstalować 32-bitową wersję MSI dla Azure CLI w wersji 2.51.0, użyj adresu URL https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. Odpowiednia 64-bitowa instalacja to https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Dostępne wersje Azure CLI można znaleźć w informacjach o wersjach Azure CLI. 64-bitowy MSI jest dostępny od wersji 2.51.0.

Instalator Microsoft (MSI) za pomocą programu PowerShell

Aby zainstalować interfejs wiersza polecenia platformy Azure przy użyciu programu PowerShell, uruchom program PowerShell jako administrator i uruchom następujące polecenie:

$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

Spowoduje to pobranie i zainstalowanie najnowszego 32-bitowego instalatora interfejsu wiersza polecenia platformy Azure dla systemu Windows. Jeśli wolisz zainstalować 64-bitową wersję, zmień adres URL na https://aka.ms/installazurecliwindowsx64. Jeśli interfejs wiersza polecenia platformy Azure jest już zainstalowany, instalator zastąpi istniejącą wersję.

Aby zainstalować określoną wersję, zastąp argument -Uri adresem URL opisanym w następnej sekcji. Oto przykład użycia 32-bitowego instalatora interfejsu wiersza polecenia platformy Azure w wersji 2.51.0 w programie 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

Określona wersja

Aby pobrać instalator MSI dla określonej wersji, zmień segment wersji w adresie URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32-bitowy) lub https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64-bitowy).

Na przykład aby zainstalować 32-bitową wersję MSI dla Azure CLI w wersji 2.51.0, użyj adresu URL https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. Odpowiednia instalacja 64-bitowa to https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Dostępne wersje interfejsu wiersza polecenia platformy Azure można znaleźć w informacjach o wersji interfejsu wiersza polecenia platformy Azure. 64-bitowy MSI jest dostępny od wersji 2.51.0.

Różnice składniowe między programem Bash i programem PowerShell

Mimo że większość dokumentacji interfejsu wiersza polecenia platformy Azure jest napisana i przetestowana w powłoce Bash, możesz również zainstalować i uruchomić interfejs wiersza polecenia platformy Azure przy użyciu programu PowerShell. Istnieją subtelne różnice składni między powłoką Bash i programem PowerShell. Przejrzyj następujące artykuły, aby uniknąć błędów skryptów:

Podczas uruchamiania Azure CLI w programie PowerShell istnieją różnice w obsłudze błędów, a także możliwość włączenia automatycznego uzupełniania za pomocą tabulatora. Aby uzyskać więcej informacji, zobacz następujące artykuły:

Pakiet ZIP

Ważne

Ten pakiet jest obecnie w wersji zapoznawczej.

Pakiet ZIP umożliwia zainstalowanie interfejsu wiersza polecenia platformy Azure w systemie Windows. Ten pakiet jest przydatny, gdy nie masz uprawnień administracyjnych.

Rozpakuj pakiet do folderu, a następnie użyj polecenia Cmd lub PowerShell, wywołaj interfejs wiersza polecenia platformy Azure, uruchamiając polecenie <unzipped folder path>\bin\az.cmd.

Jeśli chcesz uruchomić polecenie az bezpośrednio, wykonaj poniższe kroki, aby dodać Azure CLI do zmiennej środowiskowej PATH.

  1. Otwórz menu Start i wyszukaj ciąg environment variables. Kliknij Edit the system environment variables.
  2. Kliknij przycisk Environment Variables....
  3. W polu User varibles for <username>, wybierz Path i kliknij przycisk Edit....
  4. New Kliknij przycisk i dodaj element <unzipped folder path>\bin do listy.
  5. Uruchom ponownie terminal. Teraz powinno być możliwe uruchamianie az poleceń.

Najnowsza wersja

Najnowszy plik ZIP interfejsu wiersza polecenia platformy Azure (64-bitowy)

Określona wersja

Jeśli wolisz, możesz pobrać określoną wersję interfejsu wiersza polecenia platformy Azure przy użyciu adresu URL.

Aby pobrać pakiet ZIP dla określonej wersji, zmień segment wersji w adresie URL https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.

Na przykład, aby zainstalować 64-bitowy plik ZIP Azure CLI w wersji 2.57.0, adres URL to https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

Dostępne wersje Azure CLI można znaleźć w notatkach o wydaniach platformy Azure. Pakiet ZIP jest dostępny w wersji 2.57.0. Dostępna jest tylko wersja 64-bitowa.

Uruchamianie interfejsu wiersza polecenia platformy Azure

Po zakończeniu instalacji zamknij i otwórz ponownie wszystkie aktywne okno terminalu. Uruchom interfejs wiersza polecenia platformy Azure przy użyciu polecenia az z wiersza polecenia systemu Windows lub programu PowerShell. Typowym pierwszym krokiem jest sprawdzenie aktywnej subskrypcji.

az account show

Rozwiązywanie problemów z instalacją

Poniżej przedstawiono niektóre typowe problemy występujące podczas instalowania interfejsu wiersza polecenia platformy Azure w systemie Windows. Jeśli wystąpi problem, który nie został opisany w tym miejscu, zgłoś problem w usłudze GitHub.

Zmienna PATH nie jest ustawiona

Najczęstszą przyczyną tego problemu jest to, że aktywne okno terminalu nie zostało ponownie uruchomione po instalacji. Zamknij i otwórz ponownie wszystkie aktywne okno terminalu.

Serwer proxy blokuje połączenie

Jeśli nie możesz pobrać instalatora MSI, ponieważ serwer proxy blokuje połączenie, upewnij się, że masz prawidłowo skonfigurowany serwer proxy. W przypadku systemu Windows 10 te ustawienia są zarządzane w okienku Settings > Network & Internet > Proxy . Skontaktuj się z administratorem systemu, aby uzyskać wymagane ustawienia lub w sytuacjach, w których maszyna może być zarządzana poprzez konfigurację lub wymaga zaawansowanej konfiguracji.

Ważne

Te ustawienia są również wymagane, aby mieć dostęp do usług Azure za pomocą CLI, zarówno z PowerShella, jak i wiersza polecenia Windows. W programie PowerShell wykonaj następujące polecenie:

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

Aby pobrać MSI, serwer proxy musi zezwolić na połączenia HTTPS z następującymi adresami:

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

Aby uzyskać więcej informacji, zobacz Praca za serwerem proxy w przewodniku rozwiązywania problemów z Azure CLI.

Powolne czasy odpowiedzi

Zobacz Migrowanie do 64-bitowego interfejsu wiersza polecenia platformy Azure

Włączanie uzupełniania Tab w programie PowerShell

Autouzupełnianie za pomocą klawisza Tab, znane również jako "kompletery Azure CLI", zapewnia uzupełnianie danych wejściowych, by dostarczać podpowiedzi, ułatwiać odkrywanie funkcji i przyspieszać wprowadzanie danych. Nazwy poleceń, nazwy grup poleceń, parametry i niektóre wartości parametrów można automatycznie wstawić do wiersza polecenia, naciskając Tab .

Uzupełnianie poleceń za pomocą klawisza Tab jest domyślnie włączone w usłudze Azure Cloud Shell i w większości dystrybucji systemu Linux. Począwszy od wersji 2.49 Azure CLI, możesz włączyć uzupełnianie poleceń dla Azure CLI w programie PowerShell. Wykonaj te kroki:

  1. Utwórz lub edytuj profil przechowywany w zmiennej $PROFILE. Najprostszym sposobem jest uruchomienie notepad $PROFILE w programie PowerShell. Aby uzyskać więcej informacji, zobacz Jak utworzyć profil i Profile i Zasady Wykonywania.

  2. Dodaj następujący kod do profilu programu 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. Aby wyświetlić wszystkie dostępne opcje w menu, dodaj Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete do profilu programu PowerShell.

Aktualizowanie interfejsu wiersza polecenia platformy Azure

Począwszy od wersji 2.11.0, interfejs wiersza polecenia platformy Azure udostępnia polecenie w narzędziu umożliwiające aktualizację do najnowszej wersji.

az upgrade

To polecenie aktualizuje również domyślnie wszystkie zainstalowane rozszerzenia. Aby uzyskać więcej az upgrade opcji, zobacz stronę dokumentacji poleceń. W przypadku wersji interfejsu wiersza polecenia platformy Azure wcześniejszych niż 2.11.0 zaktualizuj ją ponownie, ponownie instalując ją zgodnie z opisem w temacie Instalowanie interfejsu wiersza polecenia platformy Azure.

Jeśli używasz dystrybucji ZIP, usuń stary folder instalacyjny i wyodrębnij nową wersję do tej samej lokalizacji.

Migrowanie do 64-bitowego interfejsu wiersza polecenia platformy Azure

Od wersji 2.51.0, Azure CLI udostępnia również 64-bitowy instalator MSI, który jest zalecany w celu uzyskania lepszej wydajności.

Wykonaj następujące kroki, aby przeprowadzić migrację do 64-bitowego interfejsu wiersza polecenia platformy Azure:

  1. Sprawdź bieżącą wersję interfejsu wiersza polecenia i zainstalowane rozszerzenia, uruchamiając polecenie az --version.
  2. Należy ponownie zainstalować rozszerzenia. Zaleca się wykonanie kopii zapasowej bieżącego folderu %userprofile%\.azure\cliextensions rozszerzenia przez zmianę jego nazwy w przypadku powrotu do 32-bitowego. Ten folder jest tworzony automatycznie podczas ponownej instalacji rozszerzenia.
  3. Pobierz i zainstaluj najnowszy 64-bitowy instalator zgodnie z opisem w temacie Instalowanie lub aktualizowanie. 32-bitowy pakiet MSI zostanie automatycznie odinstalowany.
  4. Zainstaluj rozszerzenia, uruchamiając polecenie az extension add --name <extension> --version <version>. Jeśli nie chcesz ręcznie ponownie instalować rozszerzeń, interfejs wiersza polecenia platformy Azure wyświetli monit o zainstalowanie rozszerzenia podczas pierwszego użycia. Aby uzyskać więcej informacji na temat instalowania rozszerzeń, zobacz How to install extensions (Jak zainstalować rozszerzenia).

Jeśli masz problemy po migracji, możesz odinstalować wersję 64-bitową i ponownie zainstalować wersję 32-bitową MSI. Jeśli utworzono kopię zapasową 32-bitowego folderu rozszerzenia, przywróć (zmień nazwę) folderu rozszerzenia po zmianie.

Odinstaluj program

Jeśli zdecydujesz się odinstalować Azure CLI, przykro nam, że odchodzisz. Przed odinstalowaniem użyj polecenia az feedback, aby poinformować nas, co można ulepszyć lub naprawić. Naszym celem jest zapewnienie, że interfejs wiersza polecenia platformy Azure będzie bezbłędny i przyjazny dla użytkownika. Jeśli znajdziesz usterkę, będziemy wdzięczni za zgłoszenie problemu w usłudze GitHub.

Możesz odinstalować interfejs wiersza polecenia platformy Azure z listy "Aplikacje i funkcje" w systemie Windows. Aby odinstalować:

Platforma Instrukcje
Windows 11 Rozpocznij > Ustawienia > Aplikacje > Zainstalowane aplikacje
Windows 10 Menu Start > Ustawienia > Aplikacje > Aplikacje i funkcje
Windows 8 i Windows 7 Uruchamianie > programów Panel sterowania >> Odinstalowywanie programu

Na tym ekranie wpisz Azure CLI na pasku wyszukiwania programu. Program do odinstalowania jest wymieniony jako interfejs wiersza polecenia firmy Microsoft 2.0 dla platformy Azure. Wybierz tę aplikację, a następnie wybierz przycisk Uninstall.

Usuwanie danych

Jeśli nie planujesz ponownej instalacji Azure CLI, usuń jego dane z C:\Users\<username>\.azure\msal_token_cache.bin lub C:\Users\<username>\.azure\msal_token_cache.json.

Następne kroki

Po zainstalowaniu interfejsu wiersza polecenia platformy Azure w systemie Windows dowiedz się więcej o różnych sposobach logowania.

Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure