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


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

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.

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.

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.