Sdílet prostřednictvím


Instalace Azure CLI ve Windows

Rozhraní příkazového řádku Azure (CLI) je multiplatformní nástroj příkazového řádku, který je možné nainstalovat místně na počítačích s Windows. Pomocí Azure CLI pro Windows se můžete připojit k Azure a spouštět příkazy pro správu prostředků Azure. Azure CLI pro Windows můžete použít také z prohlížeče prostřednictvím Azure Cloud Shellu nebo spustit z kontejneru Dockeru.

V případě Windows se Azure CLI instaluje prostřednictvím MSI nebo balíčku ZIP, který umožňuje přístup k rozhraní příkazového řádku systému Windows (CMD) nebo PowerShellu. Při instalaci pro Subsystém Windows pro Linux (WSL) jsou balíčky k dispozici pro vaši distribuci Linuxu. Na stránce hlavní instalace najdete seznam podporovaných správců balíčků nebo postup ruční instalace ve WSL.

Aktuální verze Azure CLI je 2.63.0. Informace o nejnovější verzi najdete v tématu Poznámky k verzi. Pokud chcete najít nainstalovanou verzi a zjistit, jestli potřebujete aktualizovat, spusťte příkaz az version.

Instalace nebo aktualizace

Distribuovatelné soubory MSI a ZIP se používají k instalaci nebo aktualizaci Azure CLI ve Windows. Před použitím instalačního programu MSI nemusíte odinstalovat aktuální verze, protože MSI aktualizuje jakoukoli existující verzi.

Důležité

Po dokončení instalace budete muset zavřít a znovu otevřít okno aktivního terminálu, aby bylo možné použít Azure CLI.

Nejnovější verze

Stáhněte a nainstalujte nejnovější verzi Azure CLI. Když se instalační program zeptá, jestli může v počítači provádět změny, vyberte pole Ano.

Pokud jste dříve nainstalovali Azure CLI, přepíše se stávající instalace spuštěním 32bitové nebo 64bitové MSI.

Specific version (Konkrétní verze)

Pokud chcete, můžete si stáhnout konkrétní verzi Azure CLI pomocí adresy URL.

Pokud chcete stáhnout instalační program MSI pro konkrétní verzi, změňte segment verze v adrese URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32bitová verze) nebo https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64bitová verze).

Pokud chcete například nainstalovat 32bitovou MSI Azure CLI verze 2.51.0, adresa URL by byla https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. Odpovídající 64bitová instalace by byla https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Dostupné verze Azure CLI najdete v poznámkách k verzi Azure CLI. 64bitová msi je k dispozici ve verzi 2.51.0.

Spuštění Azure CLI

Teď můžete Azure CLI spouštět pomocí příkazu az z příkazového řádku ve Window nebo z PowerShellu.

Povolení dokončování tabulátoru v PowerShellu

Dokončování tabulátoru, označované také jako dokončené rozhraní příkazového řádku Azure, poskytuje dokončování vstupů, které poskytují rady, umožňují zjišťování a urychlují zadávání vstupu. Názvy příkazů, názvy skupin příkazů, parametry a určité hodnoty parametrů lze automaticky vložit do příkazového řádku stisknutím klávesy Tab .

Dokončování tabulátoru je ve výchozím nastavení povolené ve službě Azure Cloud Shell a ve většině linuxových distribucí. Počínaje Azure CLI verze 2.49 můžete povolit dokončování tabulátoru pro Azure CLI v PowerShellu. Postupujte následovně:

  1. Vytvořte nebo upravte profil uložený v proměnné $PROFILE. Nejjednodušší způsob je spustit notepad $PROFILE v PowerShellu. Další informace najdete v tématu Vytvoření profilu a profilů a zásad spouštění.

  2. Do profilu PowerShellu přidejte následující kód:

    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. Pokud chcete zobrazit všechny dostupné možnosti v nabídce, přidejte Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete ho do profilu PowerShellu.

Řešení problému

Tady je několik běžných problémů při instalaci Azure CLI ve Windows. Pokud narazíte na problém, který tady není popsaný, zapište problém na GitHubu.

Proxy server blokuje připojení

Pokud instalační program MSI nemůžete stáhnout, protože váš proxy server blokuje připojení, ujistěte se, že máte správně nakonfigurovaný proxy server. Pro Windows 10 se tato nastavení spravují v Settings > Network & Internet > Proxy podokně. Požádejte správce systému o požadovaná nastavení nebo o situace, kdy může být váš počítač spravovaný konfigurací nebo vyžaduje pokročilé nastavení.

Důležité

Tato nastavení jsou také nutná pro přístup ke službám Azure pomocí rozhraní příkazového řádku z PowerShellu nebo příkazového řádku. V PowerShellu to uděláte pomocí následujícího příkazu:

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

Aby bylo možné získat MSI, musí váš proxy server povolit připojení HTTPS na následující adresy:

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

Migrace na 64bitové rozhraní příkazového řádku Azure

Od verze 2.51.0 poskytuje Azure CLI také 64bitovou MSI, která se doporučuje pro lepší výkon.

Pokud chcete migrovat na 64bitovou verzi Azure CLI, postupujte takto:

  1. Zkontrolujte aktuální verzi rozhraní příkazového řádku a nainstalovaná rozšíření spuštěním az --versionpříkazu .
  2. Rozšíření bude potřeba přeinstalovat. Doporučujeme provést zálohu aktuální složky %userprofile%\.azure\cliextensions rozšíření tak, že ji přejmenujete, pokud se rozhodnete vrátit zpět na 32bitovou verzi. Tato složka se vytvoří automaticky při přeinstalaci rozšíření.
  3. Stáhněte a nainstalujte nejnovější 64bitový instalační program, jak je popsáno v části Instalace nebo aktualizace. 32bitová msi se automaticky odinstaluje.
  4. Nainstalujte rozšíření spuštěním az extension add --name <extension> --version <version>příkazu . Pokud nechcete rozšíření přeinstalovat ručně, Azure CLI vás vyzve k instalaci rozšíření při prvním použití. Další informace o instalaci rozšíření naleznete v tématu Postup instalace rozšíření.

Pokud máte po migraci problémy, můžete 64bitovou verzi odinstalovat a znovu nainstalovat 32bitovou MSI. Pokud jste vytvořili zálohu 32bitové složky rozšíření, obnovte (přejmenujte) složku rozšíření po změně.

Aktualizace Azure CLI

Od verze 2.11.0 poskytuje Azure CLI příkaz v nástroji pro aktualizaci na nejnovější verzi.

az upgrade

Tento příkaz také ve výchozím nastavení aktualizuje všechna nainstalovaná rozšíření. Další az upgrade možnosti najdete na stránce s referenčními informacemi k příkazům. V případě verzí Azure CLI starších než 2.11.0 proveďte aktualizaci opětovnou instalací, jak je popsáno v části Instalace Azure CLI.

Pokud používáte distribuci ZIP, odstraňte starou instalační složku a extrahujte novou verzi do stejného umístění.

Odinstalace produktu

Pokud se rozhodnete odinstalovat Azure CLI, bude nám líto, že odcházíte. Před odinstalací použijte příkaz az feedback a dejte nám vědět, co můžeme zlepšit nebo opravit. Naším cílem je, aby rozhraní příkazového řádku Azure bylo bezchybné a uživatelsky přívětivé. Pokud jste narazili na chybu, uvítáme, když založíte problém na GitHubu.

Azure CLI odinstalujete ze seznamu "Aplikace a funkce" pro Windows. Odinstalace:

Platforma Pokyny
Windows 11 Spuštění > nainstalovaných aplikací > nastavení >
Windows 10 Spustit > aplikace a funkce aplikací > pro nastavení >
Windows 8 a Windows 7 Spuštění > programu Ovládací panely > > Odinstalace programu

Jakmile na této obrazovce zadáte Azure CLI do panelu hledání programu. Program k odinstalaci je uvedený jako Microsoft CLI 2.0 pro Azure. Vyberte tuto aplikaci a pak vyberte Uninstall tlačítko.

Odebrání dat

Pokud nemáte v úmyslu přeinstalovat Azure CLI, odeberte jeho data z C:\Users\<username>\.azure\msal_token_cache.bin nebo C:\Users\<username>\.azure\msal_token_cache.json.

Další kroky

Teď, když jste nainstalovali Azure CLI ve Windows, se dozvíte o různých způsobech přihlášení.