Installera Azure CLI på Windows

  • Artikel

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

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.

Kör Azure CLI

Du kan nu köra Azure CLI med kommandot az från antingen kommandotolken i Windows eller PowerShell.

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:

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

  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.

Felsökning

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.

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/

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:

  1. Kontrollera din aktuella CLI-version och installerade tillägg genom att köra az --version.
  2. 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.
  3. Ladda ned och installera den senaste 64-bitarsinstallationen 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 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.

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.

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 Starta > Inställningar > appar > installerade appar
Windows 10 Starta > Inställningar > systemappar > 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