Azure CLI installeren in Windows

Artikel
08/19/2024

De Azure-opdrachtregelinterface (CLI) is een platformoverschrijdend opdrachtregelprogramma dat lokaal kan worden geïnstalleerd op Windows-computers. U kunt de Azure CLI voor Windows gebruiken om verbinding te maken met Azure en beheeropdrachten uit te voeren op Azure-resources. De Azure CLI voor Windows kan ook vanuit een browser worden gebruikt via de Azure Cloud Shell of vanuit een Docker-container worden uitgevoerd.

Voor Windows wordt de Azure CLI geïnstalleerd via een MSI- of ZIP-pakket, waarmee u toegang hebt tot de CLI via de Windows-opdrachtprompt (CMD) of PowerShell. Wanneer u een installatie uitvoert voor Windows-subsysteem voor Linux (WSL), zijn pakketten beschikbaar voor uw Linux-distributie. Zie de hoofdinstallatiepagina voor de lijst met ondersteunde pakketmanagers of om te zien hoe u handmatig installeert onder WSL.

De huidige versie van de Azure CLI is 2.68.0. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release. Als u de geïnstalleerde versie wilt zoeken en wilt zien of u wilt bijwerken, voert u az version uit.

Installeren of bijwerken

De MSI en ZIP die kunnen worden gedistribueerd, worden gebruikt voor het installeren of bijwerken van de Azure CLI in Windows. U hoeft de huidige versies niet te verwijderen voordat u het MSI-installatieprogramma gebruikt, omdat de MSI een bestaande versie bijwerken.

Belangrijk

Nadat de installatie is voltooid, moet u een actief terminalvenster sluiten en opnieuw openen om de Azure CLI te kunnen gebruiken.

WinGet (Windows Package Manager)

Gebruik WinGet, Pakketbeheer van Microsoft voor Windows, om updates voor Azure CLI te installeren en te beheren. Winget installeert standaard de 64-bits Azure CLI op 64-bits besturingssystemen.

Notitie

WinGet is standaard beschikbaar in Windows 11 en moderne versies van Windows 10. Het is echter mogelijk niet geïnstalleerd in oudere versies van Windows. Zie de winget-documentatie voor installatie-instructies.

winget install -e --id Microsoft.AzureCLI

U -e kunt ervoor zorgen dat het officiële Azure CLI-pakket is geïnstalleerd. Met deze opdracht wordt standaard de nieuwste versie geïnstalleerd. Als u een versie wilt opgeven, voegt u een -v <version> met de gewenste versie toe aan de opdracht. Hier volgt een voorbeeld:

winget install -e --id Microsoft.AzureCLI -v 2.66.0

Microsoft Installer (MSI)

Nieuwste versie

Download en installeer de nieuwste versie van de Azure CLI. Wanneer het installatieprogramma vraagt of het wijzigingen aan uw computer kan aanbrengen, selecteert u het vak Ja.

Nieuwste MSI van de Azure CLI (32-bits)

Nieuwste MSI van de Azure CLI (64-bits)

Als u de Azure CLI eerder hebt geïnstalleerd, overschrijft het uitvoeren van de 32-bits of 64-bits MSI een bestaande installatie.

Specifieke versie

Als u wilt, kunt u een specifieke versie van de Azure CLI downloaden met behulp van een URL.

Als u het MSI-installatieprogramma voor een specifieke versie wilt downloaden, wijzigt u het versiesegment in de URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32-bits) of https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64-bits).

Als u bijvoorbeeld de 32-bits MSI van Azure CLI versie 2.51.0 wilt installeren, zou uw URL zijn https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. De bijbehorende 64-bits installatie zou zijn https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Beschikbare Azure CLI-versies vindt u in de releaseopmerkingen van Azure CLI. De 64-bits MSI is beschikbaar via versie 2.51.0.

Microsoft Installer (MSI) met PowerShell

Als u de Azure CLI wilt installeren met behulp van PowerShell, start u PowerShell als beheerder en voert u de volgende opdracht uit:

$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

Hiermee wordt het nieuwste 32-bits installatieprogramma van de Azure CLI voor Windows gedownload en geïnstalleerd. Als u de voorkeur geeft aan een 64-bits installatie, wijzigt u de URL in https://aka.ms/installazurecliwindowsx64. Als de Azure CLI al is geïnstalleerd, overschrijft het installatieprogramma de bestaande versie.

Als u een specifieke versie wilt installeren, vervangt u het argument -Uri door de URL die in de volgende sectie wordt beschreven. Hier volgt een voorbeeld van het 32-bits installatieprogramma van Azure CLI versie 2.51.0 in PowerShell:

$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

Specifieke versie

Beschikbare Azure CLI-versies vindt u in de releaseopmerkingen van Azure CLI. De 64-bits MSI is beschikbaar via versie 2.51.0.

Syntaxisverschillen tussen Bash en PowerShell

Hoewel de meeste Azure CLI-documentatie is geschreven en getest in een Bash-shell, kunt u de Azure CLI ook installeren en uitvoeren met behulp van PowerShell. Er zijn subtiele syntaxisverschillen tussen Bash en PowerShell. Raadpleeg deze artikelen om scriptfouten te voorkomen:

Overwegingen voor het uitvoeren van de Azure CLI in een PowerShell-scripttaal
Aanhalingstekens gebruiken in Azure CLI-parameters
Vergelijkingssyntaxis van Bash, PowerShell en Cmd.exe in Learn Azure CLI-syntaxisverschillen in Bash, PowerShell en Cmd

Bij het uitvoeren van de Azure CLI in PowerShell zijn er ook verschillen in foutafhandeling en de mogelijkheid om tabvoltooiing in te schakelen. Zie deze artikelen voor meer informatie:

ZIP-pakket

Belangrijk

Dit pakket is momenteel beschikbaar als preview-versie.

U kunt het ZIP-pakket gebruiken om de Azure CLI in Windows te installeren. Dit pakket is handig wanneer u geen beheerdersbevoegdheden hebt.

Pak het pakket uit naar een map en roep vervolgens met Behulp van Cmd of PowerShell de Azure CLI aan door uit te voeren <unzipped folder path>\bin\az.cmd.

Als u de az opdracht rechtstreeks wilt uitvoeren, volgt u de onderstaande stappen om de Azure CLI toe te voegen aan uw PATH omgevingsvariabele.

Open het startmenu en zoek naar environment variables. Klik op Edit the system environment variables.
Klik op de knop Environment Variables....
Selecteer User varibles for <username> en klik op de knop in het PathEdit... vak.
Klik op de New knop en voeg de <unzipped folder path>\bin knop toe aan de lijst.
Start de terminal opnieuw op. U moet nu opdrachten kunnen uitvoeren az .

Nieuwste versie

Nieuwste ZIP van de Azure CLI (64-bits)

Specifieke versie

Als u wilt, kunt u een specifieke versie van de Azure CLI downloaden met behulp van een URL.

Als u het ZIP-pakket voor een specifieke versie wilt downloaden, wijzigt u het versiesegment in de URL https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.

Als u bijvoorbeeld de 64-bits ZIP van Azure CLI versie 2.57.0 wilt installeren, zou uw URL zijn https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

Beschikbare Azure CLI-versies vindt u in de releaseopmerkingen van Azure CLI. Het ZIP-pakket is beschikbaar vanaf versie 2.57.0. Er is slechts 64-bits beschikbaar.

De Azure CLI uitvoeren

Sluit na de installatie een actief terminalvenster en open het opnieuw. Voer de Azure CLI uit met de opdracht az vanaf de Windows-opdrachtprompt of PowerShell. Een veelvoorkomende eerste stap is het controleren van uw actieve abonnement.

az account show

Problemen met de installatie oplossen

Hier volgen enkele veelvoorkomende problemen bij het installeren van de Azure CLI in Windows. Als u een probleem ondervindt dat hier niet wordt behandeld, kunt u een probleem indienen op GitHub.

PATH-variabele niet ingesteld

De meest voorkomende oorzaak van dit probleem is dat het actieve terminalvenster niet opnieuw is opgestart na de installatie. Sluit een actief terminalvenster en open het opnieuw.

Proxy blokkeert verbinding

Als u het MSI-installatieprogramma niet kunt downloaden omdat uw proxy de verbinding blokkeert, controleert u of uw proxy juist is geconfigureerd. Voor Windows 10 worden deze instellingen beheerd in het Settings > Network & Internet > Proxy deelvenster. Neem contact op met de systeembeheerder voor de vereiste instellingen of voor situaties waarin uw computer mogelijk wordt geconfigureerd of waarvoor geavanceerde instellingen zijn vereist.

Belangrijk

Deze instellingen moeten ook toegang hebben tot Azure-services met de CLI, vanuit Zowel PowerShell als de opdrachtprompt. In PowerShell doet u dit met de volgende opdracht:

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

Als u de MSI wilt ophalen, moet uw proxy HTTPS-verbindingen met de volgende adressen toestaan:

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

Zie Werken achter een proxy in de handleiding voor het oplossen van problemen met Azure CLI voor meer informatie.

Trage reactietijden

Zie Migreren naar 64-bits Azure CLI

Tabvoltooiing inschakelen in PowerShell

Tabvoltooiing, ook wel 'Azure CLI completers' genoemd, biedt voltooiing op invoer om hints te bieden, detectie in te schakelen en invoerinvoer te versnellen. Opdrachtnamen, opdrachtgroepnamen, parameters en bepaalde parameterwaarden kunnen automatisch worden ingevoegd in de opdrachtregel door op de Tab-toets te drukken.

Tabvoltooiing is standaard ingeschakeld in Azure Cloud Shell en in de meeste Linux-distributies. Vanaf Azure CLI versie 2.49 kunt u tabvoltooiing inschakelen voor de Azure CLI in PowerShell. Volg vervolgens deze stappen:

Maak of bewerk het profiel dat is opgeslagen in de variabele $PROFILE. De eenvoudigste manier is om te worden uitgevoerd notepad $PROFILE in PowerShell. Zie Hoe u uw profiel- en profielbeleid en uitvoeringsbeleid maakt voor meer informatie.

Voeg de volgende code toe aan uw PowerShell-profiel:

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
}

Als u alle beschikbare opties in het menu wilt weergeven, voegt u dit toe Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete aan uw PowerShell-profiel.

De Azure CLI bijwerken

Vanaf versie 2.11.0 biedt de Azure CLI een opdracht in het hulpprogramma om bij te werken naar de nieuwste versie.

az upgrade

Met deze opdracht worden ook alle geïnstalleerde extensies standaard bijgewerkt. Zie de referentiepaginaaz upgradevoor meer opties. Update voor Azure CLI-versies vóór 2.11.0 door opnieuw te installeren, zoals beschreven in De Azure CLI installeren.

Als u ZIP-distributie gebruikt, verwijdert u de oude installatiemap en extraheert u de nieuwe versie naar dezelfde locatie.

Migreren naar 64-bits Azure CLI

Vanaf 2.51.0 biedt Azure CLI ook een 64-bits MSI die wordt aanbevolen voor betere prestaties.

Volg deze stappen om te migreren naar Azure CLI 64-bits:

Controleer uw huidige CLI-versie en geïnstalleerde extensies door uit te voeren az --version.
Extensies moeten opnieuw worden geïnstalleerd. Het is raadzaam om een back-up van de huidige extensiemap %userprofile%\.azure\cliextensions uit te voeren door de naam ervan te wijzigen als u ervoor kiest om terug te keren naar 32-bits. Deze map wordt automatisch gemaakt wanneer u een extensie opnieuw installeert.
Download en installeer het nieuwste 64-bits installatieprogramma, zoals beschreven in Installeren of bijwerken. De 32-bits MSI wordt automatisch verwijderd.
Installeer extensies door uit te voeren az extension add --name <extension> --version <version>. Als u extensies niet handmatig opnieuw wilt installeren, wordt u door de Azure CLI gevraagd om een extensie te installeren bij eerste gebruik. Zie Extensies installeren voor meer informatie over het installeren van extensies.

Als u na de migratie problemen ondervindt, kunt u de 64-bits versie verwijderen en de 32-bits MSI opnieuw installeren. Als u een back-up van de 32-bits extensiemap hebt gemaakt, herstelt u de extensiemap (hernoemen) na de wijziging.

Verwijderen

We zouden het jammer vinden als u besluit om Azure CLI te verwijderen. Voordat u de CLI verwijdert, gebruikt u de az feedback-opdracht om ons te laten weten wat er kan worden verbeterd of opgelost. Ons doel is om Azure CLI zo gebruiksvriendelijk mogelijk te maken en vrij te houden van bugs. Als u een bug vindt, zouden we het waarderen als u dat meldt op GitHub.

U verwijdert de Azure CLI uit de lijst Met Windows-apps en -onderdelen. Ga als volgende te werk om te verwijderen:

Platform	Instructies
Windows 11	Geïnstalleerde > apps voor > instellingen > starten
Windows 10	Apps > en functies voor instellingen > starten >
Windows 8 en Windows 7	Een > programma starten Configuratiescherm > Programma's > verwijderen

Wanneer u op dit scherm bent, typt u Azure CLI in de zoekbalk van het programma. Het programma dat moet worden verwijderd, wordt vermeld als Microsoft CLI 2.0 voor Azure. Selecteer deze toepassing en selecteer vervolgens de Uninstall knop.

Gegevens verwijderen

Als u azure CLI niet opnieuw wilt installeren, verwijdert u de gegevens uit C:\Users\<username>\.azure\msal_token_cache.bin of C:\Users\<username>\.azure\msal_token_cache.json.

Volgende stappen

Nu u de Azure CLI in Windows hebt geïnstalleerd, vindt u meer informatie over de verschillende manieren om u aan te melden.

Aanmelden met Azure CLI

Delen via

Azure CLI installeren in Windows

Installeren of bijwerken

WinGet (Windows Package Manager)

Microsoft Installer (MSI)

Nieuwste versie

Specifieke versie

Microsoft Installer (MSI) met PowerShell

Specifieke versie

Syntaxisverschillen tussen Bash en PowerShell

ZIP-pakket

Nieuwste versie

Specifieke versie

De Azure CLI uitvoeren

Problemen met de installatie oplossen

PATH-variabele niet ingesteld

Proxy blokkeert verbinding

Trage reactietijden

Tabvoltooiing inschakelen in PowerShell

De Azure CLI bijwerken

Migreren naar 64-bits Azure CLI

Verwijderen

Gegevens verwijderen

Volgende stappen

Aanvullende resources