Az Azure CLI telepítése Windows

A Azure Command-Line interface (CLI) egy platformfüggetlen parancssori eszköz, amely helyileg telepíthető Windows számítógépekre. A Azure CLI használatával Windows csatlakozhat Azure, és felügyeleti parancsokat hajthat végre Azure erőforrásokon. A Azure CLI böngészőből is használható a Azure Cloud Shell keresztül, vagy futtatható egy Docker-tárolón belülről.

A Windows esetében az Azure CLI MSI vagy ZIP csomag által telepíthető, amely hozzáférést biztosít az Azure CLI-hez a PowerShell vagy a Windows parancssor használatával (cmd.exe). A Windows Subsystem for Linux (WSL) telepítésekor a csomagok elérhetők a Linux-disztribúcióhoz. A támogatott csomagkezelők listájáért vagy a WSL-en történő manuális telepítésért tekintse meg a fő telepítési oldalt.

A Azure CLI jelenlegi verziója 2.84.0. A legújabb kiadással kapcsolatos információkért lásd a kibocsátási megjegyzéseket. A telepített verzió megkereséséhez és annak megtekintéséhez, hogy frissítenie kell-e, futtassa az az verziót.

Telepítés vagy frissítés

Az MSI és a ZIP csomagot az Azure CLI telepítéséhez vagy frissítéséhez használják Windows rendszeren. Az MSI-telepítő használata előtt nem kell eltávolítania az aktuális verziókat, mert az MSI frissíti a meglévő verziókat.

Fontos

A telepítés befejezése után be kell zárnia és újra kell nyitnia az aktív terminálablakot az Azure CLI használatához.

WinGet (Windows Package Manager)

A WinGet, a Microsoft Windows Csomagkezelője segítségével telepítheti és kezelheti a Azure CLI frissítéseit. A Winget alapértelmezés szerint 64 bites operációs rendszereken telepíti a 64 bites Azure CLI.

Megjegyzés:

A WinGet alapértelmezés szerint Windows 11 és a Windows 10 modern verzióiban érhető el. Előfordulhat azonban, hogy nem telepíthető a Windows régebbi verzióiban. A telepítési utasításokért tekintse meg a winget dokumentációját .

winget install --exact --id Microsoft.AzureCLI

A --exact lehetőség a hivatalos Azure CLI csomag telepítésének biztosítása. Ez a parancs alapértelmezés szerint telepíti a legújabb verziót. Verzió megadásához adjon hozzá egy --version <version> kívánt verziót a parancshoz. Íme egy példa:

winget install --exact --id Microsoft.AzureCLI --version 2.67.0

Microsoft Installer (MSI)

Legutóbbi verzió

Töltse le és telepítse a Azure CLI legújabb kiadását. Amikor a telepítő megkérdezi, hogy képes-e módosítani a számítógépet, válassza az "Igen" jelölőnégyzetet.

A legújabb MSI az Azure CLI-hez (32 bites verzió)

Az Azure CLI legújabb MSI-je (64 bites)

Ha korábban telepítette a Azure CLI, a 32 bites vagy a 64 bites MSI futtatása felülírja a meglévő telepítést.

Adott verzió

Ha szeretné, egy URL-cím használatával letöltheti a Azure CLI egy adott verzióját.

Ha le szeretné tölteni az MSI-telepítőt egy adott verzióhoz, módosítsa a verziószegmenst AZ URL-címben https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32 bites) vagy https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 bites).

Ha például telepíteni szeretné Azure CLI 2.51.0 32 bites MSI-t, az URL-címe https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. A megfelelő 64 bites telepítés a következő lenne https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi: .

Az elérhető Azure CLI verziók a Azure CLI kibocsátási megjegyzéseiben találhatók. A 64 bites MSI a 2.51.0-s verziótól érhető el.

Microsoft Installer (MSI) a PowerShell használatával

Az Azure CLI telepítéséhez PowerShell használatával indítsa el a PowerShellt rendszergazdaként, és futtassa a következő parancsot:

$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

Ez letölti és telepíti a Windows Azure CLI legújabb 32 bites telepítőját. Ha 64 bites telepítést szeretne, módosítsa az URL-címet a https://aka.ms/installazurecliwindowsx64gombra. Ha a Azure CLI már telepítve van, a telepítő felülírja a meglévő verziót.

Egy adott verzió telepítéséhez cserélje le a -Uri argumentumot a következő szakaszban ismertetett URL-címre. Íme egy példa a Azure CLI 2.51.0 PowerShell-verzió 32 bites telepítőjének használatára:

$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

Adott verzió

Az elérhető Azure CLI verziók a Azure CLI kibocsátási megjegyzéseiben találhatók. A 64 bites MSI a 2.51.0-s verziótól érhető el.

Szintaxisbeli különbségek a Bash és a PowerShell között

Bár a legtöbb Azure CLI dokumentáció Bash környezetben van megírva és tesztelve, az Azure CLI-t PowerShell használatával is telepítheti és futtathatja. A Bash és a PowerShell között apró szintaktikai különbségek vannak. A szkriptelési hibák elkerülése érdekében tekintse át ezeket a cikkeket:

Szempontok az Azure CLI futtatására PowerShell szkriptnyelvben
Idézőjelek használata Azure CLI paraméterekben
Hasonlítsa össze a Bash, PowerShell és a Cmd.exe szintaxisát az Azure CLI szintaxisának különbségei a Bash, PowerShell és Cmd között

A Azure CLI PowerShellben való futtatásakor hibakezelési különbségek és a lapkizárás engedélyezése is előfordulhat. További információt az alábbi cikkekben talál:

Az Azure CLI hibakezelése a PowerShellben
A lapkitöltés engedélyezése az Azure CLI számára a PowerShellben

ZIP-csomag

Fontos

Ez a csomag jelenleg előzetes verzióban érhető el.

A ZIP-csomag használatával telepítheti a Azure CLI Windows. Ez a csomag akkor hasznos, ha nincs rendszergazdai jogosultsága.

Bontsa ki a csomagot egy mappába, majd a Cmd vagy a PowerShell használatával hívja meg a Azure CLI a <unzipped folder path>\bin\az.cmd futtatásával.

Ha közvetlenül szeretné futtatni a az parancsot, az alábbi lépéseket követve adja hozzá a Azure CLI a PATH környezeti változóhoz.

Nyissa meg a Start menüt, és keressen rá environment variables. Kattintson a Edit the system environment variables parancsra.
Kattintson a Environment Variables... gombra.
User variables for <username> A mezőben jelölje ki Path és kattintson a Edit... gombra.
Kattintson a New gombra, és adja hozzá a <unzipped folder path>\bin listához.
Indítsa újra a terminált. Most már képesnek kell lennie parancsok futtatására az .

Legutóbbi verzió

Az Azure CLI (64 bites) legújabb ZIP-je

Adott verzió

Ha szeretné, egy URL-cím használatával letöltheti a Azure CLI egy adott verzióját.

Ha le szeretné tölteni a ZIP-csomagot egy adott verzióhoz, módosítsa a verziószegmenst az URL-címben https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.

Ha például a 2.57.0-s verziójú Azure CLI 64 bites ZIP-fájlját szeretné telepíteni, az URL-cím https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

Az elérhető Azure CLI verziók a Azure CLI kibocsátási megjegyzéseiben találhatók. A ZIP-csomag a 2.57.0-s verziótól érhető el. Csak 64 bites verzió érhető el.

Futtassa a Azure CLI

A telepítés után zárja be és nyissa meg újra az aktív terminálablakot. Futtassa az Azure CLI-t a az paranccsal akár a PowerShellből, akár a Windows parancssorból.

Mielőtt végrehajthat Azure CLI parancsokat, be kell jelentkeznie Azure. Interaktív bejelentkezéshez használja a az login. A hitelesítéssel kapcsolatos információkért lásd: Sign into Azure with Azure CLI.

az login

Gyakori első lépés az aktív előfizetés ellenőrzése.

az account show

Hibaelhárítás a telepítésnél

Íme néhány gyakori probléma a Azure CLI Windows való telepítésekor. Ha az itt nem tárgyalt problémát tapasztal, jelentsen egy problémát a GitHubon.

A PATH változó nincs beállítva

A probléma leggyakoribb oka az, hogy a telepítés után nem indítja újra az aktív terminálablakot. Zárja be és nyissa meg újra az aktív terminálablakokat.

Egy proxy blokkolja a kapcsolatot

Ha nem tudja letölteni az MSI-telepítőt, mert a proxy blokkolja a kapcsolatot, győződjön meg arról, hogy konfigurálta a proxyt. A Windows 11 ezek a beállítások a Settings > Network & Internet > Proxy panelen kezelhetők. Forduljon a rendszergazdához a szükséges beállításokért, vagy olyan helyzetekért, amikor a gép konfigurációval kezelhető, vagy speciális beállításokat igényel.

Fontos

Ezekre a beállításokra azért is szükség van, hogy Azure szolgáltatásokat lehessen elérni a Azure CLI a PowerShellből vagy a parancssorból. A PowerShellben a következő paranccsal hajthatja végre ezt a konfigurációt:

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

Az MSI beszerzéséhez a proxynak engedélyeznie kell a HTTPS-kapcsolatokat a következő címekre:

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

További információkért tekintse meg a Munkavégzés proxy mögött részt az Azure CLI hibaelhárítási útmutatójában.

Lassú válaszidők

Lásd: "Migrálás a 64 bites Azure CLI-re"

Lapkiegészítés engedélyezése a PowerShellben

A tabulátorkiegészítés, más néven "Azure CLI kiegészítők", a bemeneti adatok kiegészítését biztosítják, hogy tippeket adjanak, megkönnyítsék a felfedezést és felgyorsítsák az adatok bevitelét. A tabulátorbillentyűvel automatikusan beszúrhatók a parancssorba a parancsnevek, a parancscsoportok nevei, a paraméterek és bizonyos paraméterértékek.

Alapértelmezés szerint a tabulátorkiegészítés engedélyezve van az Azure Cloud Shellben és a legtöbb Linux-disztribúcióban. Azure CLI 2.49-es verziójától kezdve engedélyezheti a lapkizárást a Azure CLI a PowerShellben. Kövesse az alábbi lépéseket:

Hozza létre vagy szerkessze a változóban $PROFILEtárolt profilt. A legegyszerűbb módszer a PowerShellben való futtatás notepad $PROFILE . További információért lásd: A profil létrehozása és Profilok és végrehajtási szabályzat.

Adja hozzá a következő kódot a PowerShell-profilhoz:

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
}

A menüben elérhető összes lehetőség megjelenítéséhez adja hozzá Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete a PowerShell-profiljához.

A Azure CLI frissítése

A 2.11.0 verziótól kezdve a Azure CLI egy eszközön belüli parancsot biztosít a legújabb verzióra való frissítéshez.

az upgrade

Ez a parancs alapértelmezés szerint az összes telepített bővítményt is frissíti. További az upgrade lehetőségekért tekintse meg a parancs referenciaoldalát. A 2.11.0 előtti Azure CLI verziók esetében a frissítéshez telepítse újra, ahogyan az a Az Azure CLI telepítése című részben le van írva.

Ha a ZIP-disztribúciót használja, távolítsa el a régi telepítési mappát, és bontsa ki az új verziót ugyanarra a helyre.

Migrálás a 64 bites Azure CLI-re

A 2.51.0-tól kezdődően a Azure CLI 64 bites MSI-t is biztosít, amely a jobb teljesítmény érdekében ajánlott.

A Azure CLI 64 bites verziójára való migráláshoz kövesse az alábbi lépéseket:

Ellenőrizze az aktuális Azure CLI verziót és a telepített bővítményeket a az --version futtatásával.
A bővítmények újratelepítést igényelnek. Ha úgy dönt, hogy visszaállítja a 32 bites verziót, készítsen biztonsági másolatot az aktuális bővítmény mappájáról %userprofile%\.azure\cliextensions úgy, hogy átnevezi azt. Ez a mappa automatikusan létrejön egy bővítmény újratelepítésekor.
Töltse le és telepítse a legújabb 64 bites telepítőt a Telepítés vagy frissítés szakaszban leírtak szerint. A rendszer automatikusan eltávolítja a 32 bites MSI-t.
Bővítmények telepítése a futtatással az extension add --name <extension> --version <version>. Ha nem szeretné manuálisan újratelepíteni a bővítményeket, a Azure CLI kéri, hogy először telepítsen egy bővítményt. A bővítmények telepítésével kapcsolatos további információkért lásd : Bővítmények telepítése.

Ha a migrálás után problémákat tapasztal, eltávolíthatja a 64 bites verziót, és újratelepítheti a 32 bites MSI-t. Ha biztonsági másolatot készített a 32 bites bővítménymappáról, a módosítás után állítsa vissza vagy nevezze át a bővítménymappát.

Program eltávolítása

Ha úgy dönt, hogy eltávolítja az Azure CLI-t, sajnáljuk, hogy búcsút mondunk. Az eltávolítás előtt az az feedback paranccsal ossza meg velünk, hogy mit tehetnénk jobbá, és mit kell kijavítanunk. Célunk, hogy a Azure CLI hibamentes és felhasználóbarát legyen. Ha hibát talált, kérjük, jelentsen egy GitHub hibát.

Távolítsa el a Azure CLI az Windows "Alkalmazások és szolgáltatások" listából. Az eltávolításhoz:

Plattform	Utasítások
Windows 11	Kezdőlap > Beállítások > Alkalmazások > Telepített alkalmazások
Windows 10	Start > Settings > Apps > Alkalmazások és funkciók
Windows 8 és Windows 7	Start > Control Panel > Programok > Program eltávolítása

Ezen a képernyőn Azure CLI írja be a program keresősávjába. Az eltávolítandó program Microsoft CLI 2.0 Azure néven szerepel. Jelölje ki ezt az alkalmazást, majd kattintson a Uninstall gombra.

Adatok eltávolítása

Ha nem tervezi újratelepíteni az Azure CLI-t, távolítsa el az adatokat az C:\Users\<username>\.azure\msal_token_cache.bin vagy C:\Users\<username>\.azure\msal_token_cache.json.

Következő lépések

Most, hogy telepítette a Azure CLI Windows, megismerkedhet a bejelentkezés különböző módjaival.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-03-12

Megosztás a következőn keresztül:

Az Azure CLI telepítése Windows

Telepítés vagy frissítés

WinGet (Windows Package Manager)

Microsoft Installer (MSI)

Legutóbbi verzió

Adott verzió

Microsoft Installer (MSI) a PowerShell használatával

Adott verzió

Szintaxisbeli különbségek a Bash és a PowerShell között

ZIP-csomag

Legutóbbi verzió

Adott verzió

Futtassa a Azure CLI

Hibaelhárítás a telepítésnél

A PATH változó nincs beállítva

Egy proxy blokkolja a kapcsolatot

Lassú válaszidők

Lapkiegészítés engedélyezése a PowerShellben

A Azure CLI frissítése

Migrálás a 64 bites Azure CLI-re

Program eltávolítása

Adatok eltávolítása

Következő lépések

Visszajelzés

További források