Instalowanie interfejsu wiersza polecenia platformy Azure w systemie Windows

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 interfejsu wiersza polecenia platformy Azure to 2.58.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.

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".

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.

Uruchamianie interfejsu wiersza polecenia platformy Azure

Interfejs wiersza polecenia platformy Azure można teraz uruchomić za pomocą polecenia az z poziomu wiersza polecenia systemu Windows lub programu PowerShell.

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 klawisz 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.

Rozwiązywanie problemów

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.

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/

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.

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.

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 > zainstalowanych aplikacji > Ustawienia >
Windows 10 Uruchamianie > Ustawienia > aplikacji systemowych > i funkcji
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.