Installera Azure CLI på Windows

Artikel
02/04/2025

Azures kommandoradsgränssnitt (CLI) är ett plattformsoberoende kommandoradsverktyg som kan installeras lokalt på Windows-datorer. Du kan använda Azure CLI för Windows för att ansluta till Azure och köra administrativa kommandon på Azure-resurser. Azure CLI för Windows kan också användas från en webbläsare via Azure Cloud Shell eller köras inifrån en Docker-container.

För Windows installeras Azure CLI via en MSI eller ett ZIP-paket, vilket ger dig åtkomst till CLI via Windows-kommandotolken (CMD) eller PowerShell. När du utför en installation för Windows-undersystem för Linux (WSL) är paket tillgängliga för Din Linux-distribution. På den primära installationssidan finns en lista med pakethanterare som stöds eller instruktioner om hur du installerar manuellt under WSL.

Den aktuella versionen av Azure CLI är 2.68.0. Information om den senaste versionen finns i viktig information. Kör az version för att hitta den installerade versionen och se om du behöver uppdatera.

Installera eller uppdatera

MSI och ZIP-distributionsbara används för att installera eller uppdatera Azure CLI i Windows. Du behöver inte avinstallera aktuella versioner innan du använder MSI-installationsprogrammet eftersom MSI uppdaterar någon befintlig version.

Viktigt!

När installationen är klar måste du stänga och öppna alla aktiva terminalfönster igen för att använda Azure CLI.

WinGet (Windows Package Manager)

Använd WinGet, Microsofts pakethanterare för Windows, för att installera och hantera uppdateringar för Azure CLI. Som standard installerar Winget 64-bitars Azure CLI på 64-bitars operativsystem.

Kommentar

WinGet är tillgängligt som standard i Windows 11 och moderna versioner av Windows 10. Den kanske dock inte installeras i äldre versioner av Windows. Se winget-dokumentationen för installationsinstruktioner.

winget install -e --id Microsoft.AzureCLI

Alternativet -e är att se till att det officiella Azure CLI-paketet är installerat. Det här kommandot installerar den senaste versionen som standard. Om du vill ange en version lägger du till en -v <version> med önskad version i kommandot . Här är ett exempel:

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

Microsoft Installer (MSI)

Senaste versionen

Ladda ned och installera den senaste versionen av Azure CLI. När installationsprogrammet frågar om det kan göra ändringar på datorn väljer du rutan "Ja".

Senaste MSI för Azure CLI (32-bitars)

Senaste MSI för Azure CLI (64-bitars)

Om du tidigare har installerat Azure CLI skriver 32-bitars eller 64-bitars MSI över en befintlig installation.

Specifik version

Om du vill kan du ladda ned en specifik version av Azure CLI med hjälp av en URL.

Om du vill ladda ned MSI-installationsprogrammet för en viss version ändrar du versionssegmentet i URL ( https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi 32-bitars) eller https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64-bitars).

Om du till exempel vill installera 32-bitars MSI för Azure CLI version 2.51.0 blir https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msidin URL . Motsvarande 64-bitars installation skulle vara https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Tillgängliga Azure CLI-versioner finns i Viktig information om Azure CLI. 64-bitars MSI är tillgängligt från version 2.51.0.

Microsoft Installer (MSI) med PowerShell

Om du vill installera Azure CLI med PowerShell startar du PowerShell som administratör och kör följande kommando:

$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

Detta laddar ned och installerar det senaste 32-bitars installationsprogrammet för Azure CLI för Windows. Om du föredrar en 64-bitars installation ändrar du URL till https://aka.ms/installazurecliwindowsx64. Om Azure CLI redan är installerat skriver installationsprogrammet över den befintliga versionen.

Om du vill installera en specifik version ersätter du argumentet -Uri med url:en som beskrivs i nästa avsnitt. Här är ett exempel på hur du använder 32-bitarsinstallationsprogrammet för Azure CLI version 2.51.0 i 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

Specifik version

Tillgängliga Azure CLI-versioner finns i Viktig information om Azure CLI. 64-bitars MSI är tillgängligt från version 2.51.0.

Syntaxskillnader mellan Bash och PowerShell

Även om de flesta Azure CLI-dokumentationer är skrivna och testade i ett Bash-gränssnitt kan du även installera och köra Azure CLI med hjälp av PowerShell. Det finns subtila syntaxskillnader mellan Bash och PowerShell. Granska de här artiklarna för att undvika skriptfel:

Överväganden för att köra Azure CLI på ett PowerShell-skriptspråk
Använda citattecken i Azure CLI-parametrar
Jämför syntaxen för Bash, PowerShell och Cmd.exe i Learn Azure CLI-syntaxskillnader i Bash, PowerShell och Cmd

När du kör Azure CLI i PowerShell finns det även felhanteringsskillnader och möjligheten att aktivera flikslutsättning. Mer information finns i de här artiklarna:

ZIP-paket

Viktigt!

Det här paketet är för närvarande i förhandsversion.

Du kan använda ZIP-paketet för att installera Azure CLI i Windows. Det här paketet är användbart när du inte har administratörsbehörighet.

Packa upp paketet till en mapp och anropa sedan Azure CLI med hjälp av Cmd eller PowerShell genom att köra <unzipped folder path>\bin\az.cmd.

Om du vill köra az kommandot direkt följer du stegen nedan för att lägga till Azure CLI i miljövariabeln PATH .

Öppna Start-menyn och sök environment variablesefter . Klicka på Edit the system environment variables.
Klicka på knappen Environment Variables....
I rutan User varibles for <username> väljer du Path och klickar på Edit... knappen.
Klicka på New knappen och lägg till i <unzipped folder path>\bin listan.
Starta om terminalen. Nu bör du kunna köra az kommandon.

Senaste versionen

Senaste ZIP för Azure CLI (64-bitars)

Specifik version

Om du vill kan du ladda ned en specifik version av Azure CLI med hjälp av en URL.

Om du vill ladda ned ZIP-paketet för en viss version ändrar du versionssegmentet i URL:en https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.

Om du till exempel vill installera 64-bitars ZIP för Azure CLI version 2.57.0 blir https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zipdin URL .

Tillgängliga Azure CLI-versioner finns i Viktig information om Azure CLI. ZIP-paketet är tillgängligt från version 2.57.0. Endast 64-bitars är tillgängligt.

Kör Azure CLI

Stäng och öppna alla aktiva terminalfönster igen efter installationen. Kör Azure CLI med kommandot az från antingen Windows-kommandotolken eller PowerShell. Ett vanligt första steg är att kontrollera din aktiva prenumeration.

az account show

Felsöka installation

Här följer några vanliga problem när du installerar Azure CLI i Windows. Om du upplever ett problem som inte beskrivs här kan du skapa ett problem på GitHub.

PATH-variabeln har inte angetts

Den vanligaste orsaken till det här problemet är att det aktiva terminalfönstret inte har startats om efter installationen. Stäng och öppna alla aktiva terminalfönster igen.

Proxy blockerar anslutning

Om du inte kan ladda ned MSI-installationsprogrammet eftersom proxyn blockerar anslutningen kontrollerar du att proxyn är korrekt konfigurerad. För Windows 10 hanteras de här inställningarna i fönstret Settings > Network & Internet > Proxy . Kontakta systemadministratören för de inställningar som krävs, eller för situationer där datorn kan vara konfigurationshanterad eller kräver avancerad konfiguration.

Viktigt!

De här inställningarna krävs också för att kunna komma åt Azure-tjänster med CLI, både från PowerShell eller kommandotolken. I PowerShell gör du detta med följande kommando:

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

För att hämta MSI måste proxyn tillåta HTTPS-anslutningar till följande adresser:

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

Mer information finns i Arbeta bakom en proxy i felsökningsguiden för Azure CLI.

Långsamma svarstider

Se Migrera till 64-bitars Azure CLI

Aktivera flikens slutförande i PowerShell

Tabbavslut, även kallat "Azure CLI-slutförare", ger slutförande av indata för att ge tips, aktivera identifiering och påskynda inmatning. Kommandonamn, kommandogruppsnamn, parametrar och vissa parametervärden kan automatiskt infogas i kommandoraden genom att trycka på tabbtangenten.

Tabbavslut är aktiverat som standard i Azure Cloud Shell och i de flesta Linux-distributioner. Från och med Azure CLI version 2.49 kan du aktivera tabbar för Azure CLI i PowerShell. Följ de här stegen:

Skapa eller redigera profilen som lagras i variabeln $PROFILE. Det enklaste sättet är att köra notepad $PROFILE i PowerShell. Mer information finns i Så här skapar du din profil och profil och körningsprincip.

Lägg till följande kod i din PowerShell-profil:

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
}

Om du vill visa alla tillgängliga alternativ på menyn lägger du till Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete i din PowerShell-profil.

Uppdatera Azure CLI

Från och med version 2.11.0 tillhandahåller Azure CLI ett kommando i verktyget för att uppdatera till den senaste versionen.

az upgrade

Detta kommando uppdaterar även alla installerade tillägg som standard. Fler az upgrade alternativ finns på kommandoreferenssidan. För Azure CLI-versioner före 2.11.0 uppdaterar du genom att installera om enligt beskrivningen i Installera Azure CLI.

Om du använder ZIP-distribution tar du bort den gamla installationsmappen och extraherar den nya versionen till samma plats.

Migrera till 64-bitars Azure CLI

Från och med 2.51.0 tillhandahåller Azure CLI även 64-bitars MSI som rekommenderas för bättre prestanda.

Följ de här stegen för att migrera till Azure CLI 64-bitars:

Kontrollera din aktuella CLI-version och installerade tillägg genom att köra az --version.
Tillägg måste installeras om. Vi rekommenderar att du säkerhetskopierar den aktuella tilläggsmappen %userprofile%\.azure\cliextensions genom att byta namn på den om du väljer att återgå till 32-bitars. Den här mappen skapas automatiskt när du installerar om ett tillägg.
Ladda ned och installera den senaste 64-bitarsinstallationen enligt beskrivningen i Installera eller uppdatera. 32-bitars MSI avinstalleras automatiskt.
Installera tillägg genom att köra az extension add --name <extension> --version <version>. Om du inte vill installera om tillägg manuellt uppmanar Azure CLI dig att installera ett tillägg vid första användningen. Mer information om hur du installerar tillägg finns i Installera tillägg.

Om du har problem efter migreringen kan du avinstallera 64-bitars och installera om 32-bitars MSI. Om du har gjort en säkerhetskopia av 32-bitars-tilläggsmappen återställer du (byter namn på) din tilläggsmapp efter ändringen.

Avinstallera

Vi tycker att det är tråkigt om du väljer att avinstallera Azure CLI. Innan du avinstallerar använder du kommandot az feedback för att berätta för oss vad som kan förbättras eller åtgärdas. Vårt mål är att göra Azure CLI så felfritt och användarvänligt som möjligt. Om du har hittat en bugg vill vi gärna att du öppnar ett GitHub-supportärende.

Du avinstallerar Azure CLI från listan Appar och funktioner i Windows. Så här avinstallerar du:

Plattform	Instruktioner
Windows 11	Startinställningar >> Appar > installerade appar
Windows 10	Startinställningar >> Appar > Appar och funktioner
Windows 8 och Windows 7	Starta > Kontrollpanelen > program > Avinstallera ett program

På den här skärmen skriver du Azure CLI i programsökningsfältet. Programmet som ska avinstalleras visas som Microsoft CLI 2.0 för Azure. Välj det här programmet och välj Uninstall sedan knappen.

Ta bort data

Om du inte planerar att installera om Azure CLI tar du bort dess data från C:\Users\<username>\.azure\msal_token_cache.bin eller C:\Users\<username>\.azure\msal_token_cache.json.

Nästa steg

Nu när du har installerat Azure CLI i Windows kan du lära dig mer om de olika sätten att logga in på.

Logga in med Azure CLI

Dela via

Installera Azure CLI på Windows

Installera eller uppdatera

WinGet (Windows Package Manager)

Microsoft Installer (MSI)

Senaste versionen

Specifik version

Microsoft Installer (MSI) med PowerShell

Specifik version

Syntaxskillnader mellan Bash och PowerShell

ZIP-paket

Senaste versionen

Specifik version

Kör Azure CLI

Felsöka installation

PATH-variabeln har inte angetts

Proxy blockerar anslutning

Långsamma svarstider

Aktivera flikens slutförande i PowerShell

Uppdatera Azure CLI

Migrera till 64-bitars Azure CLI

Avinstallera

Ta bort data

Nästa steg

Ytterligare resurser