Aan de slag met de Azure CLI

Welkom bij de Azure Command-Line Interface (CLI)! In dit artikel maakt u kennis met de CLI en kunt u algemene taken uitvoeren.

Notitie

In scripts en op de documentatiesite van Microsoft staan Azure CLI-voorbeelden geschreven voor de bash-shell. Voorbeelden van één regel kunnen op elk platform worden uitgevoerd. Langere voorbeelden, die bijvoorbeeld regelvoortzettingen (\) of variabele toewijzingen bevatten, moeten worden bewerkt om in een andere shell, waaronder PowerShell, te kunnen werken.

Installeren of uitvoeren in Azure Cloud Shell

De eenvoudigste manier om te leren hoe u de Azure CLI gebruikt, is door deze in een Azure Cloud Shell in uw browser uit te Azure Cloud Shell. Zie Quickstart Cloud Shell Bash in Azure Cloud Shell voor meer informatie over Azure Cloud Shell.

Wanneer u klaar bent om de CLI installeren, leest u de installatie-instructies.

Nadat u de CLI voor het eerst hebt geïnstalleerd, controleert u of deze is geïnstalleerd en of u de juiste versie hebt door uit te az --version gaan.

Notitie

Als u gebruikmaakt van het klassieke Azure-implementatiemodel, installeert u de klassieke Azure CLI.

Aanmelden bij de Azure CLI

Voordat u Azure CLI-opdrachten met een lokale installatie gebruikt, moet u zich aanmelden met az login.

  1. Voer de opdracht login uit.

    az login

    Als de CLI uw standaardbrowser kan openen, gebeurt dat ook en wordt er een Azure-aanmeldingspagina geladen.

    Als dat niet het geval is, opent u een browserpagina op https://aka.ms/devicelogin en voert u de autorisatiecode in die wordt weergegeven in uw terminal.

    Als er geen webbrowser beschikbaar is of de webbrowser niet kan worden geopend, gebruikt u de apparaatcodestroom met az login --use-device-code.

  2. Meldt u zich in de browser aan met uw accountreferenties.

Nadat u zich hebt aangemeld, ziet u een lijst met abonnementen die zijn gekoppeld aan uw Azure-account. De abonnementsgegevens met isDefault: true zijn het abonnement dat momenteel is geactiveerd na aanmelden. Als u een ander abonnement wilt selecteren, gebruikt u de opdracht az account set met de abonnements-id waarnaar moet worden overgeschakeld. Zie Meerdere Azure-abonnementen gebruiken voor meer informatie over het selecteren van abonnementen.

Er zijn ook manieren om u niet-interactief aan te melden. Deze manieren worden uitvoerig behandeld in Aanmelden met Azure CLI.

Algemene Azure CLI-opdrachten

Deze tabel bevat enkele veelgebruikte opdrachten die worden gebruikt in de CLI en koppelingen naar de bijbehorende referentiedocumentatie.

Resourcetype Azure CLI-opdrachtgroep
Resourcegroep az group
Virtuele machines az vm
Opslagaccounts az storage account
Key Vault az keyvault
Webtoepassingen az webapp
SQL-databases az sql server
Cosmos DB az cosmosdb

Opdrachten opzoeken

Azure CLI-opdrachten zijn ingedeeld als opdrachten van groepen. Elke groep vertegenwoordigt een Azure-service en opdrachten worden uitgevoerd voor die service.

Gebruik az find om opdrachten op te zoeken. Als u bijvoorbeeld wilt zoeken naar namen van opdrachten waar secret in voorkomt, gebruikt u de volgende opdracht:

az find secret

Gebruik het argument --help voor een volledige lijst met opdrachten en subgroepen van een groep. Als u bijvoorbeeld de CLI-opdrachten wilt vinden voor het werken met Netwerkbeveiligingsgroepen (NSG's):

az network nsg --help

De CLI heeft volledige tabvoltooiing voor opdrachten in de bash-shell.

Algemeen beschikbare argumenten

Er is een aantal argumenten dat voor elke opdracht beschikbaar is.

  • Met --help wordt CLI-verwijzingsinformatie over opdrachten en de argumenten ervan afgedrukt en worden de beschikbare subgroepen en opdrachten getoond.
  • Met --output wordt de indeling van de uitvoer gewijzigd. De beschikbare uitvoerindelingen zijn , (gekleurde JSON), (door tabs gescheiden waarden), (door mensen leesbare json jsonc tsv table ASCII-tabellen) en yaml . Standaard is json de uitvoer van de CLI. Raadpleeg Uitvoerindelingen voor Azure CLI 2.0-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
  • Met --query wordt er gebruikgemaakt van de querytaal JMESPath om de uitvoer van de Azure-services te filteren. Zie Query command results with Azure CLI (Queryopdrachtresultaten met Azure CLI) en de JMESPath-zelfstudievoor meer informatie over query's.
  • Met --verbose wordt er informatie afgedrukt over resources die tijdens een bewerking in Azure zijn gemaakt, evenals andere nuttige informatie.
  • Met --debug wordt er nog meer informatie afgedrukt over de CLI-bewerkingen. Dit is handig voor foutopsporing. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd.

Interactieve modus

De CLI biedt een interactieve modus waarmee automatisch Help-informatie wordt weergegeven en die het eenvoudiger maakt om subopdrachten te selecteren. U activeert de interactieve modus met de opdracht az interactive.

az interactive

Raadpleeg Interactieve modus in Azure CLI voor meer informatie over de interactieve modus.

Er is ook een invoegtoepassing voor Visual Studio Code voor een interactieve ervaring, waaronder automatisch aanvullen en documentatie die wordt weergegeven als u met de muis iets aanwijst.

De basis van CLI onder de knie krijgen met snelstartgidsen en zelfstudies

Als u wilt weten hoe u de Azure CLI gebruikt, kunt u een uitgebreide zelfstudie volgen voor het instellen van virtuele machines en het gebruik van de kracht van de CLI om query's uit te voeren op Azure-resources.

Zelfstudie: Virtuele machines maken met de Azure CLI

Er zijn ook quickstarts voor andere populaire services.

Feedback geven

We stellen het bijzonder op prijs als u feedback wilt geven op de CLI en ons wilt helpen verbeteringen aan te brengen en fouten op te lossen. U kunt een probleem indienen op GitHub of de ingebouwde functies van de CLI gebruiken om algemene feedback te geven met de opdracht az feedback.

az feedback

Zie ook