Az Azure CLI telepítése Windows rendszeren

Az Azure Parancssori felület (CLI) egy platformfüggetlen parancssori eszköz, amely helyileg telepíthető Windows rendszerű számítógépekre. A WindowsHoz készült Azure CLI használatával csatlakozhat az Azure-hoz, és felügyeleti parancsokat hajthat végre az Azure-erőforrásokon. A WindowsHoz készült Azure CLI böngészőből is használható az Azure Cloud Shellen keresztül, vagy futtatható egy Docker-tárolón belülről.

Windows esetén az Azure CLI egy MSI-n vagy ZIP-csomagon keresztül van telepítve, amely hozzáférést biztosít a parancssorhoz a Windows parancssorán (CMD) vagy a PowerShellen keresztül. A Linuxos Windows-alrendszer (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.

Az Azure CLI jelenlegi verziója a 2.59.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 terjeszthető az Azure CLI windowsos telepítéséhez vagy frissítéséhez. 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 meg kell nyitnia minden aktív terminálablakot az Azure CLI használatához.

Microsoft Installer (MSI)

Legutóbbi verzió

Töltse le és telepítse az 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.

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

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

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

Adott verzió

Ha szeretné, egy URL-cím használatával letöltheti az 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).

Az Azure CLI 2.51.0-s verziójának 32 bites MSI-jének telepítéséhez például az URL-címe leszhttps://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 az 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-lel

PowerShell

Az Azure CLI PowerShell-lel való telepítéséhez 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 WindowsHoz készült Azure CLI legújabb 32 bites telepítőt. Ha 64 bites telepítést szeretne, módosítsa az URL-címet a https://aka.ms/installazurecliwindowsx64gombra. Ha az 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 az argumentumot az -Uri adott verzióban leírt URL-címre. Íme egy példa az Azure CLI 2.51.0-s verziójának 32 bites telepítőjének a PowerShellben való 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ó

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

Az Azure CLI 2.51.0-s verziójának 32 bites MSI-jének telepítéséhez például az URL-címe leszhttps://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 az Azure CLI kibocsátási megjegyzéseiben találhatók. A 64 bites MSI a 2.51.0-s verziótól érhető el.

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

Bár a legtöbb Azure CLI-dokumentáció egy Bash-rendszerhéjban van megírva és tesztelve, az Azure CLI-t a 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:

• A PowerShell-lel kapcsolatos problémák idézete
• Idézőjelek használata az Azure CLI-paraméterekben
• A CMD, a PowerShell és a Bash szintaxisának összehasonlítása a Lekérdezés parancs kimenetében a JMESPath használatával

Ha az Azure CLI-t a PowerShellben futtatja, 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
• Lapkiegészítés engedélyezése a PowerShellben

Windows-csomagkezelő

Winget

A Microsoft Windows-csomagkezelőjével is wingettelepítheti és kezelheti az Azure CLI frissítéseit.

Feljegyzés

A winget alapértelmezés szerint a 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 -e --id Microsoft.AzureCLI

A -e lehetőség az, hogy a hivatalos Azure CLI-csomag telepítve legyen. Ez a parancs alapértelmezés szerint telepíti a legújabb verziót. Verzió megadásához adjon hozzá egy -v <version> kívánt verziót a parancshoz.

ZIP-csomag

Fontos

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

A ZIP-csomag használatával telepítheti az Azure CLI-t Windows rendszeren. 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 az Azure CLI-t a futtatással <unzipped folder path>\bin\az.cmd.

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

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

Legutóbbi verzió

Az Azure CLI legújabb ZIP-fájlja (64 bites)

Adott verzió

Ha szeretné, egy URL-cím használatával letöltheti az 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.

Az Azure CLI 2.57.0-s verziójának 64 bites ZIP-fájljának telepítéséhez például az URL-címe lesz https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

Az Elérhető Azure CLI-verziók az 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.

Az Azure CLI futtatása

Most már futtathatja az Azure CLI-t a(z) az paranccsal a Windows parancssorból vagy a PowerShellből.

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

A tabulátorkiegészítés, más néven "Azure CLI-kiegészítések" a bemenetek kiegészítését biztosítják, hogy tippeket adjanak, lehetővé tegyék a felderítést és felgyorsíthassák a bemeneti bevitelt. A tabulátorbillentyűvel automatikusan beszúrhatók a parancssorba a parancsnevek, a parancscsoportok nevei, a paraméterek és bizonyos paraméterértékek.

A tabulátorkizárás alapértelmezés szerint engedélyezve van az Azure Cloud Shellben és a legtöbb Linux-disztribúcióban. Az Azure CLI 2.49-es verziójától kezdve engedélyezheti az Azure CLI lapkiegészítését a PowerShellben. Tegye a következők egyikét:

1. 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ó: A profil és a profilok létrehozása és a végrehajtási szabályzat.

2. 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
   }
   

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

Hibaelhárítás

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

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 a proxy megfelelően van konfigurálva. Windows 10 esetén 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 szükség van ahhoz is, hogy az Azure-szolgáltatásokat a parancssori felülettel is elérhesse a PowerShellből vagy a parancssorból. A PowerShellben ezt a következő paranccsal teheti meg:

(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/

Migrálás 64 bites Azure CLI-re

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

Kövesse az alábbi lépéseket az Azure CLI 64 bites migrálásához:

1. A parancssori felület aktuális verziójának és a telepített bővítményeknek a futtatásával az --versionellenőrizheti.
2. A bővítményeket újra kell telepíteni. Javasoljuk, hogy készítsen biztonsági másolatot az aktuális bővítménymappáról %userprofile%\.azure\cliextensions úgy, hogy átnevezi, ha vissza szeretne térni 32 bitesre. Ez a mappa automatikusan létrejön egy bővítmény újratelepítésekor.
3. 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 32 bites MSI automatikusan törlődik.
4. 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, az Azure CLI kérni fogja, 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 elemet, é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 (nevezze át) a bővítménymappát.

Az Azure CLI frissítése

A 2.11.0-s verziótól kezdve az 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-s verzió előtti Azure CLI-verziók esetében frissítsen újra az Azure CLI telepítésében leírtak szerint.

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

Eltávolítás

Ha az Azure CLI eltávolítását választotta, sajnáljuk, hogy felhagy a használatával. 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. Az a célunk, hogy az Azure CLI hibamentes és felhasználóbarát legyen. Ha hibát tapasztal, kérjük, jelentse be a GitHubon.

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

Platform	Utasítások
Windows 11	Gépház > Telepített alkalmazások > indítása >
Windows 10	Gépház > System > Apps > funkcióinak indítása >
Windows 8 és Windows 7	Program eltávolítása Vezérlőpult > programok > indítása >

Ezen a képernyőn írja be az Azure CLI-t a program keresősávjába. Az eltávolítandó program az Azure-hoz készült Microsoft CLI 2.0-s verzióként 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 a vagy a C:\Users\<username>\.azure\msal_token_cache.binC:\Users\<username>\.azure\msal_token_cache.json.

Következő lépések

Most, hogy telepítette az Azure CLI-t a Windows rendszeren, ismerje meg a bejelentkezés különböző módjait.

Bejelentkezés az Azure CLI-vel