Quickstart: Resource Graph-query uitvoeren met behulp van Azure CLI

Artikel
04/25/2024

In deze quickstart wordt beschreven hoe u een Azure Resource Graph-query uitvoert met behulp van de extensie voor Azure CLI. In het artikel wordt ook beschreven hoe u de resultaten van de query sorteert (sorteert) en beperkt. U kunt een query uitvoeren voor resources in uw tenant, beheergroepen of abonnementen. Wanneer u klaar bent, kunt u de extensie verwijderen.

Vereisten

Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.
Azure CLI moet versie 2.22.0 of hoger zijn voor de Resource Graph-extensie.
Visual Studio Code.

Verbinding maken met Azure

Maak vanuit een Visual Studio Code-terminalsessie verbinding met Azure. Als u meer dan één abonnement hebt, voert u de opdrachten uit om context in te stellen op uw abonnement. Vervang <subscriptionID> door de id van uw Azure-abonnement.

az login

# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>

De extensie installeren

Als u azure CLI wilt inschakelen om query's uit te voeren op resources met behulp van Azure Resource Graph, moet de Resource Graph-extensie zijn geïnstalleerd. U kunt de extensie handmatig installeren met de volgende stappen. Anders wordt de eerste keer dat u een query uitvoert gevraagd az graph om de extensie te installeren.

Geef de beschikbare extensies en versies weer:
```
az extension list-available --output table
```
De extensie installeren:
```
az extension add --name resource-graph
```
Controleer of de extensie is geïnstalleerd:
```
az extension list --output table
```
De syntaxis van de extensie weergeven:
```
az graph query --help
```
Ga voor meer informatie over Azure CLI-extensies naar Extensies gebruiken en beheren met de Azure CLI.

Een query uitvoeren

Nadat de Azure CLI-extensie is toegevoegd aan uw omgeving, kunt u een query op basis van een tenant uitvoeren. De query in dit voorbeeld retourneert vijf Azure-resources met de name en type van elke resource. Als u een query wilt uitvoeren op een beheergroep of abonnement, gebruikt u de --management-groups of --subscriptions argumenten.

Voer een Azure Resource Graph-query uit:
```
az graph query --graph-query 'Resources | project name, type | limit 5'
```
In dit queryvoorbeeld wordt geen sorteeraanpassing zoals order by. Als u de query meerdere keren uitvoert, kan dit een andere set resources opleveren voor elke aanvraag.
Werk de query bij naar order by de name eigenschap:
```
az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
```
Net als bij de vorige query kan het voor elke aanvraag een andere set resources opleveren als u deze query meerdere keren uitvoert. De volgorde van de queryopdrachten is belangrijk. In dit voorbeeld komt order by na limit. De query beperkt de resultaten tot vijf resources en bestelt deze resultaten vervolgens op naam.
Werk de query bij naar order by de name eigenschap en vervolgens limit de uitvoer naar vijf resultaten:
```
az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
```
Als deze query meerdere keren wordt uitgevoerd zonder wijzigingen in uw omgeving, zijn de resultaten consistent en gerangschikt door de name eigenschap, maar nog steeds beperkt tot vijf resultaten. Met de query worden de resultaten op naam gesorteerd en wordt de uitvoer beperkt tot vijf resources.

Resources opschonen

Voer de volgende opdracht uit om de Resource Graph-extensie te verwijderen:

az extension remove --name resource-graph

Afmelden bij uw Azure CLI-sessie:

az logout

Volgende stappen

In deze quickstart hebt u Azure Resource Graph-query's uitgevoerd met behulp van de extensie voor Azure CLI. Ga naar het artikel met details van de querytaal voor meer informatie.

Informatie over de querytaal van Azure Resource Graph