Installera Azure CLI på Windows

CLI (Azure Command-Line Interface) ä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 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 Azure CLI via PowerShell eller kommandotolken Windows (cmd.exe). När du utför en installation för Windows Subsystem for 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.84.0. Information om den senaste versionen finns i versionsanteckningar. Kör az version för att hitta den installerade versionen och se om du behöver uppdatera.

Installera eller uppdatera

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

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

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 PowerShell eller kommandotolken Windows.

Innan du kan köra Azure CLI kommandon måste du logga in på Azure. Om du vill logga in interaktivt använder du az login. Information om autentisering finns i Tilldela i Azure med Azure CLI.

az login

Ett vanligt första steg är att kontrollera din aktiva prenumeration.

az account show

Felsökning av installation

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

PATH-variabeln har inte angetts

Den vanligaste orsaken till det här problemet är att inte starta om det aktiva terminalfönstret 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 konfigurerad. För Windows 11 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 i situationer där datorn kan vara konfigurationshanterad eller kräver avancerad konfiguration.

(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 Work behind a proxy i felsökningsguiden för Azure CLI.

Långsamma svarstider

Se Migrera till 64-bitars Azure CLI

Aktivera flikslut i PowerShell

Tab-slutförande, även kallat "Azure CLI completers", 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 tabkomplettering för Azure CLI i PowerShell. Följ dessa steg:

1. Skapa eller redigera profilen som lagras i variabeln $PROFILE. Det enklaste sättet är att köra notepad $PROFILE i PowerShell. För mer information, se Så här skapar du din profil och Profiler och körningsprinciper.

2. 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
   }
   

3. 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-distributionen 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 ger Azure CLI även en 64-bitars MSI, vilket rekommenderas för bättre prestanda.

Följ dessa steg för att migrera till 64-bitarsversionen av Azure CLI:

1. Kontrollera din aktuella Azure CLI version och installerade tillägg genom att köra az --version.
2. Tillägg kräver ominstallation. Säkerhetskopiera den aktuella tilläggsmappen %userprofile%\.azure\cliextensions genom att byta namn på den om du vill återgå till 32-bitarsversionen. Den här mappen skapas automatiskt när du installerar om ett tillägg.
3. Ladda ned och installera det senaste 64-bitars installationsprogrammet enligt beskrivningen i Installera eller uppdatera. 32-bitars MSI avinstalleras automatiskt.
4. 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 får problem efter migreringen kan du avinstallera 64-bitarsversionen och installera om 32-bitars MSI. Om du har gjort en säkerhetskopia av mappen med 32-bitarstillägg återställer eller byter du namn på din tilläggsmapp efter ändringen.

Avinstallera

Om du bestämmer dig för att avinstallera Azure CLI, är det tråkigt för oss att förlora dig. 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 buggfri och användarvänlig. Om du hittar en bugg skulle vi uppskatta om du file ett GitHub problem.

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

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 på Windows kan du lära dig mer om de olika sätten att logga in på.