Instalovat Azure CLI na Windows

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

Pro Windows se Azure CLI nainstaluje prostřednictvím MSI nebo balíčku ZIP, který umožňuje přístup k Azure CLI prostřednictvím PowerShellu nebo příkazového řádku Windows (cmd.exe). Při instalaci pro Windows Subsystem for Linux (WSL) jsou balíčky dostupné 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.84.0. Informace o nejnovější verzi najdete v poznámkách 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 slouží k instalaci nebo aktualizaci Azure CLI na 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 je nutné zavřít a znovu otevřít okno aktivního terminálu, abyste mohli použít Azure CLI.

WinGet (Windows Package Manager)

Pomocí WinGet, správce balíčků Microsoftu pro Windows, nainstalujte a spravujte aktualizace pro Azure CLI. Winget ve výchozím nastavení nainstaluje 64bitovou Azure CLI na 64bitové operační systémy.

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 --exact --id Microsoft.AzureCLI

Možnost --exact je zajistit, aby byl nainstalován oficiální balíček Azure CLI. Tento příkaz ve výchozím nastavení nainstaluje nejnovější verzi. Pokud chcete zadat verzi, přidejte --version <version> do příkazu požadovanou verzi. Tady je příklad:

winget install --exact --id Microsoft.AzureCLI --version 2.67.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 z Azure CLI (32bit)

Nejnovější MSI Azure CLI (64-bitové)

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 bude 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 Azure CLI poznámkách k verzi. 64bitová msi je k dispozici ve verzi 2.51.0.

Microsoft Installer (MSI) pomocí PowerShellu

Pokud chcete nainstalovat Azure CLI pomocí PowerShellu, spusťte PowerShell as administrator 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 je Azure CLI již nainstalován, 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 Azure CLI poznámkách k verzi. 64bitová msi je k dispozici ve verzi 2.51.0.

Rozdíly v syntaxi mezi Bashem a PowerShellem

I když je většina Azure CLI dokumentace 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:

Úvahy o spuštění Azure CLI v skriptovacím jazyce PowerShell
Použití uvozovek v parametrech Azure CLI
Porovnejte syntaxi Bash, PowerShellu a Cmd.exe v Naučte se rozdíly v syntaxi Azure CLI v Bash, PowerShellu a Cmd

Při spuštění Azure CLI v PowerShellu existují také rozdíly ve zpracování chyb a možnost povolit dokončování příkazů pomocí klávesy Tab. 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 na 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 příkazu <unzipped folder path>\bin\az.cmd.

Pokud chcete spustit příkaz az přímo, pomocí následujícího postupu přidejte Azure CLI do proměnné prostředí PATH.

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 variables for <username> vyberte Path a klikněte na Edit... tlačítko.
Klikněte na tlačítko New a přidejte <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 pro Azure CLI (64-bitový)

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 Azure CLI poznámkách k verzi. 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 PowerShellu nebo příkazového řádku Windows.

Než budete moct spouštět příkazy Azure CLI, musíte se přihlásit k Azure. Pokud se chcete přihlásit interaktivně, použijte az login. Informace o ověřování najdete v tématu Sign into Azure with Azure CLI.

az login

Běžným prvním krokem je kontrola aktivního předplatného.

az account show

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

Tady jsou některé běžné problémy při instalaci Azure CLI na Windows. Pokud narazíte na problém, který tady není popsaný, nahlaste problém na GitHub.

Proměnná PATH není nastavená

Nejběžnější příčinou tohoto problému není restartování aktivního okna terminálu po instalaci. Zavřete a znovu otevřete všechny aktivní okno terminálu.

Proxy 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 nakonfigurovaný proxy server. Pro Windows 11 se tato nastavení spravují v podokně Settings > Network & Internet > Proxy. 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í Azure CLI z PowerShellu nebo příkazového řádku. V PowerShellu provedete tuto konfiguraci pomocí následujícího příkazu:

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

Pokud chcete získat MSI, musí váš proxy server povolit připojení HTTPS k následujícím adresům:

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

Další informace najdete v tématu Work behind a proxy v průvodci odstraňováním potíží Azure CLI.

Pomalé doby odezvy

Viz Migrace do 64bitového Azure CLI

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

Dokončování tabulátoru, označované také jako "Azure CLI completers", 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é v Azure Cloud Shell a ve většině distribucí Linuxu. Počínaje verzí Azure CLI 2.49, můžete povolit dokončování tabulátoru pro Azure CLI v PowerShellu. Postupujte takto:

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 do svého profilu PowerShell.

Aktualizace Azure CLI

Počínaje verzí 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. Pro Azure CLI verze starší než 2.11.0 aktualizujte tak, že přeinstalujete podle popisu v Instalujte Azure CLI.

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

Migrace na 64bitovou Azure CLI

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

Při migraci na 64bitovou verzi Azure CLI postupujte takto:

Zkontrolujte aktuální verzi Azure CLI a nainstalovaná rozšíření spuštěním příkazu az --version.
Rozšíření vyžadují přeinstalaci. Pokud se rozhodnete vrátit k 32bitové verzi, zálohujte aktuální složku %userprofile%\.azure\cliextensions rozšíření tak, že ji přejmenujete. 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 rozšíření nechcete 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 po migraci dojde k problémům, můžete odinstalovat 64bitovou verzi a přeinstalovat 32bitovou MSI. Pokud jste vytvořili zálohu 32bitové složky rozšíření, obnovte nebo přejmenujte složku rozšíření po změně.

Odinstalace produktu

Pokud se rozhodnete odinstalovat Azure CLI, je nám líto, že jste na cestách. 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 zajistit, aby Azure CLI bez chyb a uživatelsky přívětivý. Pokud jste našli chybu, oceníme ji, pokud souborujete problém s GitHub.

Odinstalujete Azure CLI ze seznamu Windows Aplikace a funkce. Chcete-li odinstalovat:

Platforma	Instrukce
Windows 11	Start > Nastavení > Aplikace > Nainstalované aplikace
Windows 10	Start > Nastavení > Aplikace > Aplikace a funkce
Windows 8 a Windows 7	Spuštění > Control Panel > Programy > 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.

Odstraňte data

Pokud nechcete 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 na Windows, se dozvíte o různých způsobech přihlášení.

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-03-11

Sdílet prostřednictvím

Instalovat Azure CLI na Windows

Instalace nebo aktualizace

WinGet (Windows Package Manager)

Instalační služba Microsoftu (MSI)

Nejnovější verze

Specific version (Konkrétní verze)

Microsoft Installer (MSI) pomocí 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 blokuje připojení

Pomalé doby odezvy

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

Aktualizace Azure CLI

Migrace na 64bitovou Azure CLI

Odinstalace produktu

Odstraňte data

Další kroky

Váš názor

Další materiály