Kom igång med Azure CLI
Välkommen till Azures kommandoradsgränssnitt (CLI)! Den här artikeln introducerar CLI och hjälper dig att utföra vanliga uppgifter.
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.
az version
Innan du använder azure CLI-kommandon med en lokal installation måste du logga in med az login.
Kör kommandot
az login
.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.
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.
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: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:az vm --help
Här är exempelutdata med rader som utelämnas för korthet:
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
:az vm availability-set --help
Använd
--help
även för att hämta parameterlistor och kommandoexempel för ett referenskommando.az vm create --help
Här är exempelutdata med rader som utelämnas för korthet:
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.
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:
Exempel index A till Z. Exempelindexet innehåller en lista över Azure CLI-exempel sorterade efter ämnesområde, referensgrupp och GitHub-lagringsplats.
Artikelindex A till Z. Använd kortkommandona
find
, till exempelCtrl + F
, för att snabbt komma till den referenskommandogrupp som du är intresserad av. Artikelindexet ser till exempel ut ungefär så här föraz vm
:Referensundergrupp Azure CLI-artikel som visar referensanvändning az vm Utdataformat för Azure CLI-kommandon Använda variabler i Azure CLI-kommandon Hämta VM-information med frågor {Fler artiklar visas här.} az vm aem Ny version av Azure VM-tillägget för SAP-lösningar Standardversion av Azure VM-tillägg för SAP-lösningar az vm application {...}
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.
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 ärjson
,jsonc
(färglagd JSON),tsv
(Tab-Separated Values),table
(humanläsbara ASCII-tabeller) ochyaml
. Som standard matar CLI utjson
. 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.
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.
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.
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:
- Hitta och ändra din standardprenumeration.
- Skapa en Azure-resurs som innehåller ett slumpmässigt ID i namnet.
- Ange miljövariabler.
- Lär dig syntaxskillnader mellan Bash, PowerShell och Cmd.
- Felsöka Azure CLI-referenskommandon.
- Hämta egenskaper från en lokal JSON-fil.. Det här exemplet visar hur du hämtar konfigurationsvärden för utveckling, fas och produktion.
- Ta bort flera resurser med hjälp av ett skript.
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).
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 .
az feedback
Feedback om Azure CLI
Azure CLI är ett öppen källkod projekt. Välj en länk för att ge feedback: