Aan de slag met de Azure CLI

Artikel
03/08/2024

Welkom bij de Azure-opdrachtregelinterface (CLI)! In dit artikel wordt de CLI geïntroduceerd en kunt u algemene taken uitvoeren.

Installeren of uitvoeren in Azure Cloud Shell

De eenvoudigste manier om te leren hoe u de Azure CLI gebruikt, is door een Bash-omgeving in Azure Cloud Shell uit te voeren via uw browser. Voor meer informatie over Cloud Shell raadpleegt u Snelstart voor Bash in Azure Cloud Shell.

Wanneer u klaar bent om de Azure CLI te installeren, raadpleegt u de installatie-instructies voor Windows-, Linux-, macOS- en Docker-container. Als u gebruikmaakt van het klassieke Azure-implementatiemodel, installeert u de klassieke Azure CLI.

Controleer uw versie door uit te voeren az --version. Azure Cloud Shell heeft altijd de nieuwste versie van de Azure CLI die vooraf is geïnstalleerd.

az version

Aanmelden bij de Azure CLI

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

Voer de opdracht az login uit.
```
az login
```
Als de Azure CLI uw standaardbrowser kan openen, wordt de autorisatiecodestroom gestart en wordt de standaardbrowser geopend om een Azure-aanmeldingspagina te laden.

Anders wordt de apparaatcodestroom gestart en wordt u geïnstrueerd om een browserpagina te openen op https://aka.ms/devicelogin. Voer vervolgens de code in die wordt weergegeven in uw terminal.

Als er geen webbrowser beschikbaar is of de webbrowser niet kan worden geopend, kunt u de stroom van apparaatcode forceren met az login --use-device-code.
Meldt u zich in de browser aan met uw accountreferenties.

Nadat u zich hebt aangemeld, ontvangt 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 van het gewenste account. Zie Azure-abonnementen beheren voor meer informatie over de selectie van abonnementen.

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

Opdrachten zoeken

Azure CLI-opdrachten zijn ingedeeld als opdrachtgroepen. Elke groep vertegenwoordigt een gebied van een Azure-service. Er zijn twee opties om opdrachtgroepen te vinden:

Gebruik de opdracht az find . Als u bijvoorbeeld wilt zoeken naar namen van opdrachten waar vm in voorkomt, gebruikt u de volgende opdracht:
```
az find vm
```

Gebruik het --help argument om een volledige lijst met subgroepen in een verwijzingsgroep op te halen. In dit voorbeeld worden alle subgroepen voor virtuele machines geretourneerd:

az vm --help

Hier volgt een voorbeeld van uitvoer met regels die zijn weggelaten om kort te zijn:

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

Hier volgt een ander voorbeeld dat de Azure CLI-opdrachten vindt voor het groeperen van virtuele machines in beschikbaarheidssets, een subgroep van az vm:

az vm availability-set --help

--help Gebruik ook voor het ophalen van parameterlijsten en opdrachtvoorbeelden voor een referentieopdracht.

az vm create --help

Hier volgt een voorbeeld van uitvoer met regels die zijn weggelaten om kort te zijn:

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

Gebruik de A-naar-Z-verwijzingsindex waarin alle opdrachtgroepen alfabetisch worden vermeld.

Gepubliceerde voorbeelden en artikelen zoeken

Als u liever azure CLI-syntaxis leert door geteste gepubliceerde voorbeelden te bekijken, zijn er twee indexen van artikelinhoud:

Voorbeelden index A tot Z. De voorbeeldenindex bevat een lijst met Azure CLI-voorbeelden gesorteerd op onderwerpgebied, referentiegroep en GitHub-opslagplaats.

Artikelindex A tot Z. Gebruik de sneltoetsen find om Ctrl + Fsnel naar de referentieopdrachtgroep te gaan waarin u geïnteresseerd bent. De artikelindex ziet er bijvoorbeeld ongeveer als volgt uit:az vm

Verwijzingssubgroep	Azure CLI-artikel met verwijzingsgebruik
az vm	Uitvoerindelingen voor Azure CLI-opdrachten
	Variabelen gebruiken in Azure CLI-opdrachten
	VM-gegevens ophalen met query's
	{Meer artikelen die hier worden vermeld.}
az vm aem	Nieuwe versie van de Azure VM-extensie voor SAP-oplossingen
	Standaardversie van azure VM-extensie voor SAP-oplossingen
az vm application	{...}

Tabvoltooiing gebruiken

De CLI heeft volledige tabvoltooiing voor opdrachten in een Bash-omgeving. Zie Tabvoltooiing inschakelen in PowerShell als u tabvoltooiing in een PowerShell-omgeving wilt inschakelen.

Houd rekening met wereldwijd beschikbare argumenten

Er zijn enkele argumenten beschikbaar voor de meeste opdrachten.

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 json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), table (door mensen leesbare 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 de resultaten van queryopdrachten met Azure CLI en de zelfstudie JMESPath voor 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.
--subscription is de naam of id van een abonnement. Zie Azure-abonnementen beheren met de Azure CLI voor meer informatie over het instellen van uw standaardabonnement.
--only-show-errors onderdrukt waarschuwingen in opdrachtuitvoer en toont alleen fouten.

Interactieve modus gebruiken

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

Zie De Azure CLI uitvoeren in de interactieve modus 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.

Basisbeginselen van Azure CLI leren met quickstarts en zelfstudies

Als u wilt weten hoe u de Azure CLI gebruikt, kunt u onze zelfstudie voor onboarding gebruiken om u de volgende vaardigheden te leren tijdens het werken met Azure Storage:

Uw standaardabonnement zoeken en wijzigen.
Maak een Azure-resource met een willekeurige id in de naam.
Stel omgevingsvariabelen in.
Meer informatie over syntaxisverschillen tussen Bash, PowerShell en Cmd.
Fouten opsporen in Azure CLI-referentieopdrachten.
Eigenschappen ophalen uit een lokaal JSON-bestand.. In dit voorbeeld ziet u hoe u configuratiewaarden kunt ophalen voor ontwikkeling, fase en productie.
Meerdere resources verwijderen met behulp van een script.

Notitie

In scripts en op de Microsoft-documentatiesite worden Azure CLI-voorbeelden geschreven voor de Bash-shell. De meeste voorbeelden van één regel worden uitgevoerd op elk platform. Langere voorbeelden, waaronder regelvervolgingen (\), variabeletoewijzing of aanhalingstekens , moeten worden gewijzigd om te kunnen werken in andere shells, waaronder PowerShell. Zie De syntaxisverschillen tussen Bash, PowerShell en Cmd voor meer informatie over syntaxisverschillen tussen omgevingen.

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