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

winget install --exact --id Microsoft.AzureCLI

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

$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

$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

Az Azure CLI futtatása

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 a Windows Parancssorból vagy a PowerShellből. Gyakori első lépés az aktív előfizetés ellenőrzése.

az account show

Telepítés hibaelhárítása

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

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

A probléma leggyakoribb oka az, hogy az aktív terminálablak nem lett újraindítva a telepítés után. 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 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.

(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ó: Proxy mögötti munka az Azure CLI hibaelhárítási útmutatójában.

Lassú válaszidők

Lásd: Migrálás 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é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átorkiegészíté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óért lásd: A profil létrehozása és Profilok és 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.

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.

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 eltávolításra kerül.
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.

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. Az eltávolításhoz:

Ezen a képernyőn írja be az Azure CLI-t a program keresősávjába. Az eltávolítandó program Microsoft CLI 2.0 for 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 a 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 az Azure CLI-t a Windows rendszeren, ismerje meg a bejelentkezés különböző módjait.