Instalace Azure CLI ve Windows

Článek
02/04/2025

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

WinGet (Správce balíčků systému Windows)

K instalaci a správě aktualizací pro Azure CLI použijte WinGet, správce balíčků Microsoftu pro Windows. Winget ve výchozím nastavení nainstaluje 64bitové rozhraní příkazového řádku Azure CLI do 64bitových operačních systémů.

Poznámka:

WinGet je ve výchozím nastavení k dispozici ve Windows 11 a moderních verzích Windows 10. Nemusí se ale instalovat ve starších verzích Windows. Pokyny k instalaci najdete v dokumentaci k sadě winget.

winget install -e --id Microsoft.AzureCLI

Tato -e možnost spočívá v tom, že je nainstalovaný oficiální balíček Azure CLI. Tento příkaz ve výchozím nastavení nainstaluje nejnovější verzi. Pokud chcete zadat verzi, přidejte -v <version> do příkazu požadovanou verzi. Tady je příklad:

winget install -e --id Microsoft.AzureCLI -v 2.66.0

Instalační služba Microsoftu (MSI)

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.

Nejnovější MSI Azure CLI (32bitová verze)

Nejnovější MSI Azure CLI (64bitová verze)

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.

Microsoft Installer (MSI) s Využitím PowerShellu

Pokud chcete nainstalovat Azure CLI pomocí PowerShellu, spusťte PowerShell jako správce a spusťte následující příkaz:

$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

Tím se stáhne a nainstaluje nejnovější 32bitový instalační program Azure CLI pro Windows. Pokud dáváte přednost 64bitové instalaci, změňte adresu URL na https://aka.ms/installazurecliwindowsx64. Pokud už je azure CLI nainstalované, instalační program přepíše stávající verzi.

Pokud chcete nainstalovat konkrétní verzi, nahraďte argument -Uri adresou URL popsanou v další části. Tady je příklad použití 32bitového instalačního programu Azure CLI verze 2.51.0 v PowerShellu:

$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

Specific version (Konkrétní verze)

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

Rozdíly v syntaxi mezi Bashem a PowerShellem

I když je většina dokumentace k Azure CLI napsaná a otestovaná v prostředí Bash, můžete také nainstalovat a spustit Azure CLI pomocí PowerShellu. Mezi Bashem a PowerShellem jsou drobné rozdíly v syntaxi. Pokud se chcete vyhnout chybám skriptování, projděte si tyto články:

Důležité informace o spuštění Azure CLI ve skriptovacím jazyce PowerShellu
Použití uvozovek v parametrech Azure CLI
Porovnání syntaxe Bash, PowerShellu a Cmd.exe v rozdílech syntaxe Azure CLI v Bash, PowerShellu a Cmd

Při spouštění Azure CLI v PowerShellu existují také rozdíly ve zpracování chyb a možnost povolit dokončování tabulátoru. Další informace najdete v těchto článcích:

Balíček ZIP

Důležité

Tento balíček je aktuálně ve verzi Preview.

Balíček ZIP můžete použít k instalaci Azure CLI ve Windows. Tento balíček je užitečný, pokud nemáte oprávnění správce.

Rozbalte balíček do složky a pak pomocí Cmd nebo PowerShellu zavolejte Azure CLI spuštěním <unzipped folder path>\bin\az.cmdpříkazu .

Pokud chcete příkaz spustit az přímo, postupujte podle následujících kroků a přidejte Azure CLI do PATH proměnné prostředí.

Otevřete nabídku Start a vyhledejte environment variables. Klikněte na Edit the system environment variables.
Klikněte na tlačítko Environment Variables....
V poli User varibles for <username> vyberte Path a klikněte na Edit... tlačítko.
Klikněte na New tlačítko a přidejte ho <unzipped folder path>\bin do seznamu.
Restartujte terminál. Teď byste měli být schopni spouštět az příkazy.

Nejnovější verze

Nejnovější zip Azure CLI (64bitová verze)

Specific version (Konkrétní verze)

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

Chcete-li stáhnout balíček ZIP pro konkrétní verzi, změňte segment verze v adrese URL https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.

Pokud chcete například nainstalovat 64bitový zip Azure CLI verze 2.57.0, adresa URL by byla https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

Dostupné verze Azure CLI najdete v poznámkách k verzi Azure CLI. Balíček ZIP je k dispozici ve verzi 2.57.0. K dispozici je pouze 64bitová verze.

Spuštění Azure CLI

Po instalaci zavřete a znovu otevřete všechny aktivní okno terminálu. Spusťte Azure CLI pomocí příkazu az z příkazového řádku Windows nebo PowerShellu. Běžným prvním krokem je kontrola aktivního předplatného.

az account show

Řešení potíží s instalací

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.

Proměnná PATH není nastavená

Nejběžnější příčinou tohoto problému je, že po instalaci se nerestartovat okno aktivního terminálu. Zavřete a znovu otevřete všechny aktivní okno terminálu.

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/

Další informace najdete v tématu Práce za proxy serverem v průvodci odstraňováním potíží s Azure CLI.

Pomalé doby odezvy

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

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ě:

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

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
}

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

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

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:

Zkontrolujte aktuální verzi rozhraní příkazového řádku a nainstalovaná rozšíření spuštěním az --versionpříkazu .
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í.
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.
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ě.

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

Přihlášení pomocí Azure CLI

Sdílet prostřednictvím

Instalace Azure CLI ve Windows

Instalace nebo aktualizace

WinGet (Správce balíčků systému Windows)

Instalační služba Microsoftu (MSI)

Nejnovější verze

Specific version (Konkrétní verze)

Microsoft Installer (MSI) s Využitím PowerShellu

Specific version (Konkrétní verze)

Rozdíly v syntaxi mezi Bashem a PowerShellem

Balíček ZIP

Nejnovější verze

Specific version (Konkrétní verze)

Spuštění Azure CLI

Řešení potíží s instalací

Proměnná PATH není nastavená

Proxy server blokuje připojení

Pomalé doby odezvy

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

Aktualizace Azure CLI

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

Odinstalace produktu

Odebrání dat

Další kroky

Další materiály