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. Podczas instalacji dla Podsystem Windows dla systemu Linux (WSL) pakiety są dostępne dla 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 Azure CLI to 2.68.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

Plik MSI i plik ZIP są używane do instalowania lub aktualizowania interfejsu wiersza polecenia platformy Azure w systemie Windows. Nie musisz odinstalować bieżących wersji przed użyciem instalatora MSI, ponieważ tożsamość usługi zarządzanej aktualizuje dowolną 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. Aby uzyskać instrukcje dotyczące instalacji, zapoznaj się z dokumentacją zestawu winget.

winget install -e --id Microsoft.AzureCLI

Opcja -e 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 -v <version> z żądaną wersją do polecenia . Oto przykład:

winget install -e --id Microsoft.AzureCLI -v 2.66.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".

Najnowsza tożsamość usługi zarządzanej interfejsu wiersza polecenia platformy Azure (32-bitowa)

Najnowsza wersja msi interfejsu wiersza polecenia platformy Azure (64-bitowa)

Jeśli wcześniej zainstalowano interfejs wiersza polecenia platformy Azure, uruchomienie 32-bitowej lub 64-bitowej tożsamości usługi zarządzanej spowoduje zastąpienie 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ą tożsamość usługi zarządzanej interfejsu wiersza polecenia platformy Azure w wersji 2.51.0, adres URL to 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-bitowa tożsamość usługi zarządzanej jest dostępna w 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ą tożsamość usługi zarządzanej interfejsu wiersza polecenia platformy Azure w wersji 2.51.0, adres URL to 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-bitowa tożsamość usługi zarządzanej jest dostępna w 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 interfejsu wiersza polecenia platformy Azure w programie PowerShell występują również różnice w obsłudze błędów i możliwość włączania uzupełniania kart. 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ć az polecenie bezpośrednio, wykonaj poniższe kroki, aby dodać interfejs wiersza polecenia platformy Azure do PATH zmiennej środowiskowej.

  1. Otwórz menu Start i wyszukaj ciąg environment variables. Kliknij pozycję Edit the system environment variables.
  2. Kliknij przycisk Environment Variables....
  3. User varibles for <username> W polu wybierz Path i kliknij Edit... przycisk.
  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 interfejsu wiersza polecenia platformy Azure 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 interfejsu wiersza polecenia platformy Azure można znaleźć w informacjach o wersji interfejsu wiersza polecenia 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 konfiguracją lub wymagają zaawansowanej konfiguracji.

Ważne

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

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

Aby uzyskać tożsamość usługi zarządzanej, 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 interfejsem wiersza polecenia platformy Azure.

Wolne czasy odpowiedzi

Zobacz Migrowanie do 64-bitowego interfejsu wiersza polecenia platformy Azure

Włączanie uzupełniania kart w programie PowerShell

Uzupełnianie karty, nazywane również "kompletnymi elementami interfejsu wiersza polecenia platformy Azure", zapewnia uzupełnianie danych wejściowych w celu zapewnienia wskazówek, włączania odnajdywania i przyspieszania wprowadzania danych wejściowych. 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 kart jest domyślnie włączone w usłudze Azure Cloud Shell i w większości dystrybucji systemu Linux. Począwszy od interfejsu wiersza polecenia platformy Azure w wersji 2.49, możesz włączyć uzupełnianie kart dla interfejsu wiersza polecenia platformy Azure 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 go 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ę referencyjną 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

Począwszy od wersji 2.51.0, interfejs wiersza polecenia platformy Azure udostępnia również 64-bitową tożsamość usługi zarządzanej, która jest zalecana 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-bitowa tożsamość usługi zarządzanej zostanie automatycznie odinstalowana.
  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ć 64-bitową elementy i ponownie zainstalować 32-bitową tożsamość usługi zarządzanej. Jeśli utworzono kopię zapasową 32-bitowego folderu rozszerzenia, przywróć (zmień nazwę) folderu rozszerzenia po zmianie.

Odinstaluj program

Jeśli zdecydujesz się odinstalować interfejs wiersza polecenia platformy Azure, będzie nam przykro, że nas opuszczasz. 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.

Interfejs wiersza polecenia platformy Azure można odinstalować z listy "Aplikacje i funkcje" systemu Windows. Aby odinstalować:

Platforma Instrukcje
Windows 11 Uruchamianie > aplikacji ustawień > zainstalowanych > aplikacji
Windows 10 Uruchamianie aplikacji i funkcji aplikacji > ustawień >>
Windows 8 i Windows 7 Uruchamianie > programów Panel sterowania >> Odinstalowywanie programu

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

Usuwanie danych

Jeśli nie planujesz ponownej instalacji interfejsu wiersza polecenia platformy Azure, usuń jego dane z programu 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