Instalowanie interfejsu wiersza polecenia platformy Azure w systemie Windows

Interfejs azure Command-Line (CLI) 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 poziomu przeglądarki za pośrednictwem usługi Azure Cloud Shell lub z poziomu kontenera platformy Docker.

W przypadku systemu Windows interfejs wiersza polecenia platformy Azure jest instalowany za pośrednictwem tożsamości usługi zarządzanej, która zapewnia dostęp do interfejsu wiersza polecenia za pośrednictwem wiersza polecenia systemu Windows (CMD) lub programu PowerShell. W przypadku instalowania w podsystemie Windows dla systemu Linux (WSL) dostępne są pakiety dla Twojej 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.40.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

Dystrybucja msi służy do instalowania lub aktualizowania interfejsu wiersza polecenia platformy Azure w systemie Windows. Nie musisz odinstalować bieżących wersji przed użyciem instalatora MSI, ponieważ instalator MSI zaktualizuje dowolną istniejącą wersję.

Uwaga

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 w Instalatorze zostanie wyświetlona prośba o możliwość dokonania zmian w komputerze, kliknij pole „Tak“.

Określona wersja

Aby pobrać instalatora MSI dla określonej wersji, zmień segment wersji w adresie URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi i pobierz go. Dostępne wersje można znaleźć w temacie Informacje o wersji interfejsu wiersza polecenia platformy Azure.

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

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ł tutaj omówiony, 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 serwer proxy jest prawidłowo skonfigurowany. W przypadku Windows 10 te ustawienia są zarządzane w okienkuSettings > 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 można to zrobić za pomocą następującego polecenia:

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

Aby uzyskać tożsamość usługi zarządzanej, serwer proxy musi zezwalać na połączenia HTTPS z następującymi adresami:

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

Dezinstalacja

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 10 Uruchamianie > 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 kliknij przycisk .

Usuwanie danych

Jeśli nie planujesz ponownej instalacji interfejsu wiersza polecenia platformy Azure, usuń jego dane z lub C:\Users\<username>\.azure\msal_token_cache.binC:\Users\<username>\.azure\msal_token_cache.json.

Następne kroki

Po zainstalowaniu interfejsu wiersza polecenia platformy Azure w systemie Windows zapoznaj się z jej funkcjami i typowymi poleceniami.