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.
Istnieją cztery sposoby instalowania interfejsu wiersza polecenia platformy Azure w systemie Windows:
- Instalator Microsoft (MSI)
- Instalator Microsoft (MSI) w programie PowerShell
- Menedżer pakietów systemu Windows
- Pakiet ZIP
Bieżąca wersja interfejsu wiersza polecenia platformy Azure to 2.66.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.
- Instalator Microsoft (MSI)
- Instalator Microsoft (MSI) za pomocą programu PowerShell
- Menedżer pakietów systemu Windows
- Pakiet ZIP
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.
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:
Utwórz lub edytuj profil przechowywany w zmiennej
$PROFILE
. Najprostszym sposobem jest uruchomienienotepad $PROFILE
w programie PowerShell. Aby uzyskać więcej informacji, zobacz Jak utworzyć profil i profile i zasady wykonywania.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 }
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:
- Sprawdź bieżącą wersję interfejsu wiersza polecenia i zainstalowane rozszerzenia, uruchamiając polecenie
az --version
. - 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. - 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.
- 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.