Läs på engelska

Dela via

Kom igång med Azure CLI

  • Artikel

Välkommen till Azures kommandoradsgränssnitt (CLI)! Den här artikeln introducerar CLI och hjälper dig att utföra vanliga uppgifter.

Installera eller köra i Azure Cloud Shell

Det enklaste sättet att lära sig hur du använder Azure CLI är att köra en Bash-miljö i Azure Cloud Shell via webbläsaren. Mer information om Cloud Shell finns i Snabbstart för Bash i Azure Cloud Shell.

När du är redo att installera Azure CLI kan du läsa installationsanvisningarna för Windows, Linux, macOS och Docker-containern. Om du använder den klassiska distributionsmodellen installerar du klassiska Azure CLI.

Kontrollera din version genom att köra az --version. Azure Cloud Shell har alltid den senaste versionen av Azure CLI förinstallerad.

Azure CLI 
az version

Logga in på Azure CLI

Innan du använder azure CLI-kommandon med en lokal installation måste du logga in med az login.

  1. Kör kommandot az login.

    Azure CLI 
    az login

    Om Azure CLI kan öppna standardwebbläsaren initierar den auktoriseringskodflödet och öppnar standardwebbläsaren för att läsa in en Azure-inloggningssida.

    Annars initieras enhetskodflödet och du uppmanas att öppna en webbläsarsida på https://aka.ms/devicelogin. Ange sedan koden som visas i terminalen.

    Om ingen webbläsare är tillgänglig eller om webbläsaren inte kan öppnas kan du tvinga enhetskodflödet med az login --use-device-code.

  2. Logga in med dina autentiseringsuppgifter för kontot i webbläsaren.

När du har loggat in får du en lista över prenumerationer som är associerade med ditt Azure-konto. Prenumerationsinformationen med isDefault: true är den prenumeration som är aktiverad när du har loggat in. Om du vill välja en annan prenumeration använder du kommandot az account set med prenumerations-ID:t för det önskade kontot. Mer information om val av prenumeration finns i Hantera Azure-prenumerationer.

Det finns några olika sätt att logga in som inte är interaktiva. Läs mer i Logga in med Azure CLI.

Hitta kommandon

Azure CLI-kommandon ordnas som kommandogrupper. Varje grupp representerar ett område i en Azure-tjänst. Det finns två alternativ för att hitta kommandogrupper:

  • Använd kommandot az find. Om du till exempel vill söka efter kommandonamn som innehåller vm kan du använda följande kommando:

    Azure CLI 
    az find vm

  • --help Använd argumentet för att hämta en fullständig lista över undergrupper i en referensgrupp. Det här exemplet returnerar alla undergrupper för virtuella datorer:

    Azure CLI 
    az vm --help

    Här är exempelutdata med rader som utelämnas för korthet:

    Output 
    Subgroups:
  application            : Manage applications for VM.
  availability-set       : Group resources into availability sets.
  boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
  ...

    Här är ett annat exempel som hittar Azure CLI-kommandona för att gruppera virtuella datorer i tillgänglighetsuppsättningar, en undergrupp av az vm:

    Azure CLI 
    az vm availability-set --help

    Använd --help även för att hämta parameterlistor och kommandoexempel för ett referenskommando.

    Azure CLI 
    az vm create --help

    Här är exempelutdata med rader som utelämnas för korthet:

    Output 
    Arguments
    --name  [Required] : Name of the virtual machine.
    ...
Authentication Arguments
    --admin-password   : Password for the VM if authentication type is 'Password'.
    --admin-username   : Username for the VM...
    ...
Managed Service Identity Arguments
    ...
Examples
    Create a VM from a custom managed image.
      az vm create -g MyResourceGroup -n MyVm --image MyImage
    ...

  • Använd referensindexet A till Z som visar alla kommandogrupper alfabetiskt.

Hitta publicerade exempel och artiklar

Om du föredrar att lära dig Azure CLI-syntax genom att se testade publicerade exempel finns det två index för artikelinnehåll:

Använda tabbavslut

CLI har fullständig flik för kommandon i en Bash-miljö. Information om hur du aktiverar flikslut i en PowerShell-miljö finns i Aktivera flikslut i PowerShell.

Var medveten om argument som är globalt tillgängliga

Det finns några argument som är tillgängliga för de flesta kommandon.

  • --help skriver ut CLI-referensinformation om kommandon och deras argument samt visar en lista över tillgängliga undergrupper och kommandon.

  • --output ändrar utdataformat. De tillgängliga utdataformaten är json, jsonc (färglagd JSON), tsv (Tab-Separated Values), table (humanläsbara ASCII-tabeller) och yaml. Som standard matar CLI ut json. Om du vill lära dig mer om andra utdataformat kan du läsa informationen i Utdataformat för Azure CLI.

  • --query använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure-tjänster. Mer information om frågor finns i Köra frågor mot kommandoresultat med Azure CLI och JMESPath-självstudien.

  • --verbose skriver ut information om resurser som skapats i Azure när en åtgärd utförs och annan användbar information.

  • --debug skriver ut mer information om CLI-åtgärder som kan användas för felsökning. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. Det kan till exempel användas för att identifiera rest-API:et som kommandot som körs anropar under, och svaret som tas emot från tjänsten.

  • --subscription är namnet eller ID:t för en prenumeration. Mer information om hur du ställer in din standardprenumeration finns i Hantera Azure-prenumerationer med Azure CLI.

  • --only-show-errors undertrycker varningar i kommandoutdata och visar endast fel.

Använda interaktivt läge

CLI erbjuder ett interaktivt läge som automatiskt visar hjälpinformation och gör det lättare att välja underkommandon. Du aktiverar det interaktiva läget med kommandot az interactive.

Azure CLI 
az interactive

Mer information om interaktivt läge finns i Kör Azure CLI i interaktivt läge.

Det finns även ett plugin-program för Visual Studio Code som ger en interaktiv upplevelse med automatisk komplettering och dokumentation som du kan hovra över.

Lär dig grunderna i Azure CLI med snabbstarter och självstudier

Om du vill lära dig hur du använder Azure CLI kan du prova vår introduktionsguide som lär dig följande kunskaper när du arbetar med Azure Storage:

Anteckning

I skript och på Microsofts dokumentationswebbplats skrivs Azure CLI-exempel för Bash-gränssnittet. De flesta enradsexempel körs på valfri plattform. Längre exempel som omfattar radfortsättningar (\), variabeltilldelning eller citattecken måste ändras för att fungera i andra gränssnitt, inklusive PowerShell. Mer information om syntaxskillnader mellan miljöer finns i Learn syntax differences between Bash, PowerShell, and Cmd (Lär dig syntaxskillnader mellan Bash, PowerShell och Cmd).

Lämna feedback

Vi uppskattar din feedback om CLI som hjälper oss att göra förbättringar och korrigera buggar. Du kan skapa ett problem på GitHub eller använda de inbyggda funktionerna i CLI för att lämna allmän feedback med kommandot az feedback .

Azure CLI 
az feedback

Se även