Azure-resourcegroepen beheren met de Azure CLI

Een Azure-resourcegroep is een container met gerelateerde resources voor een Azure-oplossing. Een resourcegroep kan opslag, virtuele machines, apps, dashboards, services of bijna alles bevatten waar u mee te maken hebt in Azure.

Met de Azure Command-Line Interface (CLI) kunt u standaard Azure-resourcegroepen maken, persistent maken en instellen. Met de CLI kunt u ook resources ops schonen nadat u ze hebt aanmaken.

Een resourcegroep maken

U kunt een resourcegroep maken met de opdracht az group create:

az group create --name MyResourceGroup --location eastus

Een resourcegroep behoort tot één locatie. Voer de opdracht az account list-locations uit om alle locaties te zien die worden ondersteund in uw huidige abonnement:

az account list-locations

Als u alle resourcegroepen voor uw huidige abonnement wilt zien, gebruikt u de opdracht az group list:

az group list --output table

Tip

De --output parameter is een globale parameter die beschikbaar is voor alle opdrachten. De tabelwaarde geeft uitvoer weer in een gebruiksvriendelijke indeling. Zie Uitvoerindelingen voor Azure CLI-opdrachten voor meer informatie.

Wanneer u een resource maakt, maakt u deze in een resourcegroep. In het volgende voorbeeld ziet u een opslagaccount dat is gemaakt met behulp van de opdracht az storage account create:

az storage account create --resource-group MyResourceGroup --name storage134 --location eastus --sku Standard_LRS

Voer de opdracht az group delete uit om een resourcegroep te verwijderen:

az group delete --name MyResourceGroup

Wanneer u een resourcegroep verwijdert, verwijdert u alle resources die er deel van uitmaken. Er is geen optie om het gebruik van resources te dedigen. Als u een van de opdrachten in dit artikel probeert uit te voeren, wordt uw account verwijderd door de resourcegroepen te verwijderen die u maakt.

Een resourcegroep persistent maken

Met persistentie van parameters kunt u waarden voor bepaalde parameters opnieuw gebruiken, waaronder resourcegroepen.

Schakel eerst de persistentiefunctie in met behulp van de opdracht az config param-persist on:

az config param-persist on

Maak na het in-/uitschakelen van persistentie nog een resourcegroep:

az group create --name OtherResourceGroup --location eastus

Zolang persistentie is aan, kunt u de --resource-group parameter buiten toekomstige opdrachten laten. Met de volgende opdracht maakt u een opslagaccount in de groep OtherResourceGroup:

az storage account create --name storage135 --location eastus --sku Standard_LRS

Als u een resourcegroep opgeeft in de opdracht , heeft deze prioriteit. Met de volgende opdracht maakt u een opslaggroep in een resourcegroep met de naam StorageGroups:

az storage account create --resource-group StorageGroups --name storage136 --location eastus --sku Standard_LRS

Zodra u een andere resourcegroep als waarde opgeeft, wordt de persistente waarde echter opnieuw ingesteld in Azure CLI. Nieuwe opdrachten gebruiken StorageGroups als de resourcegroep. U kunt de persistente waarden zien met behulp van de opdracht az config param-persist show:

az config param-persist show

Met deze opdracht ziet u de huidige persistente waarden. Deze waarden worden opgeslagen in een bestand met de naam <username> local_context_ in een verborgen map met de naam .azure. Azure CLI maakt de map op uw huidige locatie wanneer u voor het eerst een permanente waarde maakt.

Wanneer u klaar bent met het gebruik van persistente parameters, moet u de opdracht az config param-persist off uitvoeren:

az config param-persist off

Azure CLI slaat uw persistente waarden op. U kunt ze zien in het lokale contextbestand. Als u parameter persistentie opnieuw in te stellen, zijn deze waarden al ingesteld.

Zie Persistente parameters gebruiken om sequentiële Azure CLI-opdrachten tevereenvoudigen voor meer informatie over het gebruik van de opdrachten az config param-persist.

Een standaardresourcegroep instellen

U kunt een standaardresourcegroep instellen voor alle opdrachten die u vanuit uw lokale Azure CLI of vanuit de Azure Cloud Shell. Azure CLI slaat deze configuratie lokaal op in een configuratiebestand. Voer de opdracht az config get uit om uw huidige configuratie te zien:

az config get

Het resultaat bevat standaardresourcegroepen en andere standaardwaarden. Als u Azure CLI voor het eerst gebruikt, zijn de resultaten mogelijk leeg.

Voer de opdracht az config set uit om een standaardresourcegroep in te stellen voor uw Azure CLI-installatie:

az config set defaults.group=MyResourceGroup

Met de opdracht stelt u een waarde in voor een opgegeven sleutel, in dit geval defaults.group . Zie Azure CLI-configuratie voor beschikbare configuratieopties.

Notitie

Met de opdracht az config set wordt het bestaan van de door u invoeren resourcegroep niet gevalideerd. De opdracht slaat gewoon het sleutel-waardepaar op.

Nadat u de opdracht hebt uitgevoerd, krijgt u met de volgende twee opdrachten hetzelfde resultaat:

az storage account create --resource-group MyResourceGroup --name storage01  --location eastus --sku Standard_LRS
az storage account create --name storage01 --location eastus --sku Standard_LRS

Een resourcegroep behoort tot een abonnement. Als uw organisatie meer dan één abonnement heeft, moet u dat abonnement instellen voordat u met een resourcegroep in het abonnement gaat werken. Als de standaardwaarde van een resourcegroep niet bij uw huidige abonnement hoort, wordt er een foutbericht weergegeven. Zie Use multiple Azure subscriptions (Meerdere Azure-abonnementen gebruiken) voor meer informatie over meerdere abonnementen.

U hoeft de standaardinstelling niet opnieuw in te stellen om andere resourcegroepen te gebruiken. Geef in plaats daarvan de resourcegroep op:

az group create --name OtherResourceGroup --location eastus
az storage account create --resource-group StorageGroups --name storage03  --location westus --sku Standard_LRS

De standaardwaarde is alleen voor u. Dit heeft geen invloed op andere gebruikers of wijzigingen die u via de Azure Portal.

Als u persistente parameterwaarden gebruikt, zoals beschreven in dit artikel, hebben deze waarden voorrang op de standaardwaarden die zijn ingesteld in het configuratiebestand.

Resources opschonen

Als u een van de opdrachten in dit artikel hebt geprobeerd, kunt u alle resources die u hebt gemaakt, verwijderen met behulp van de opdracht az group delete:

az group delete --name MyResourceGroup
az group delete --name OtherResourceGroup
az group delete --name StorageGroups

Met deze opdracht verwijdert u de groep en alle resources die deze in één keer bevat.

U kunt de permanente parameters verwijderen door de opdracht az config param-persist delete uit te voeren:

az config param-persist delete --all

Zie ook

Azure CLI-configuratie

Zelfstudie: Persistente parameters gebruiken om sequentiële Azure CLI-opdrachten te vereenvoudigen

Meerdere Azure-abonnementen gebruiken