Azure CLI installeren in Windows

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

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.

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.

De Azure CLI uitvoeren

U kunt nu Azure CLI uitvoeren met de opdracht az via de Windows-opdrachtprompt of vanuit PowerShell.

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:

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

  2. 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
    }
    
  3. Als u alle beschikbare opties in het menu wilt weergeven, voegt u dit toe Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete aan uw PowerShell-profiel.

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

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/

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:

  1. Controleer uw huidige CLI-versie en geïnstalleerde extensies door uit te voeren az --version.
  2. 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.
  3. Download en installeer het nieuwste 64-bits installatieprogramma, zoals beschreven in Installeren of bijwerken. De 32-bits MSI wordt automatisch verwijderd.
  4. 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.

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 referentiepagina voor opdrachten voor meer az upgrade 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.

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 starten Instellingen > Apps >
Windows 10 Start > Instellingen > System > Apps & Features
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.