De omgeving voorbereiden op de Azure CLI

Artikel
03/05/2025

In deze zelfstudiestap voert u uw eerste Azure CLI-opdrachten uit. Dit omvat het zoeken en instellen van uw actieve abonnement en het instellen van standaardwaarden. U leert ook hoe u resourcegroepen met een willekeurige id maakt om altijd een unieke resourcenaam te garanderen.

Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account aanmaken voordat u begint.

Om deze zelfstudiestap te voltooien, hebt u contributor of hogere machtigingen op uw abonnement nodig.

De Azure CLI installeren

Ga aan de slag door eerst uw omgeving te selecteren.

Gebruik de Bash-omgeving in Azure Cloud Shell door in de rechterbovenhoek van elk Azure CLI-codeblok de knop Cloud Shell openen te selecteren.
Als u de Azure CLI-referentieopdrachten liever lokaal uitvoert, installeer de Azure CLI.

De huidige versie van de Azure CLI is 2.70.0. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release. Om uw geïnstalleerde versie te vinden en te zien of u moet bijwerken, voert u az version uit.

Er zijn verschillende verificatieopties voor de Azure CLI. De standaardverificatiemethode van Azure CLI voor aanmeldingen maakt gebruik van een webbrowser en toegangstoken om u aan te melden.

Voer het az login-commando uit.
```
az login
```
Als de Azure CLI uw standaardbrowser kan openen, wordt de autorisatiecode flow geïnitieerd en wordt de standaardbrowser geopend om een Azure-aanmeldingspagina te laden.

Anders wordt de "device code flow" gestart en krijgt u de instructie 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.

Uw actieve abonnement zoeken en wijzigen

Nadat u zich hebt aangemeld bij de Azure CLI, controleert u altijd uw huidige abonnement. Als u niet werkt onder het abonnement dat u verkiest, wijzig dan uw abonnement met az account set. Hier volgt een codevoorbeeld dat u kunt gebruiken:

# see your current/default subscription
az account show

# find the list of subscriptions available to you
az account list --output table

# change your current/default subscription
az account set --subscription <mySubscriptionName>

# you can also set your subscription using a subscription ID
az account set --subscription <00000000-0000-0000-0000-000000000000>

Console-uitvoer voor az account show opdracht:

{
  "environmentName": "AzureCloud",
  "homeTenantId": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "isDefault": true,
  "managedByTenants": [],
  "name": "Your storage account name",
  "state": "Enabled",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "user": {
    "name": "yourName@contoso.com",
    "type": "user"
  }
}

Meer informatie over resourcegroepen

Een resourcegroep is een container voor Azure-resources. Als u een resourcegroep wilt maken, hebt u contributor machtigingen of hoger nodig in uw abonnement.

Een brongroep maken

Binnen een abonnement moet de naam van een resourcegroep uniek zijn. Controleer eerst of de naam die u wilt beschikbaar is met de opdracht "az group exists". Een uitvoerwaarde van false betekent dat de naam beschikbaar is.
```
az group exists --name <myUniqueRGname>
```
Haal een lijst op met ondersteunde regio's voor uw abonnement met het commando az account list-locations. Zie Kies de juiste Azure-regio voor u voor een lijst met beschikbare Azure-locaties.
```
az account list-locations --query "[].{Region:name}" --output table
```
Het is tijd om uw resourcegroep te maken. Gebruik de az group create opdracht.
```
az group create --location <myLocation> --name <myUniqueRGname>
```

Een resourcegroep met een willekeurige id maken

Bij het testen kunt u het beste een resourcegroep maken die een willekeurige id in de naam bevat. Door een willekeurige id toe te voegen aan de naam van uw resourcegroep, kunt u de code opnieuw testen zonder dat u hoeft te wachten tot een eerdere resourcegroep met dezelfde naam uit Azure wordt verwijderd.

De syntaxis van Bash- en PowerShell-variabelen verschilt. Kopieer het juiste script voor uw omgeving.

Bash
PowerShell

let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

$randomIdentifier = (New-Guid).ToString().Substring(0,8)
$location="eastus"
$resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Uitvoer van de Bash- en PowerShell-console:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/msdocs-tutorial-rg-000000000",
  "location": "eastus",
  "managedBy": null,
  "name": "msdocs-tutorial-rg-000000000",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Omgevingsvariabelen instellen

De Azure CLI biedt verschillende opties waarmee u algemene parameterwaarden opnieuw kunt gebruiken. Deze standaardwaarden worden opgeslagen in omgevingsvariabelen en zijn uniek voor elke aanmelding.

Stel uw standaardresourcegroep in.

az config set defaults.group=<msdocs-tutorial-rg-0000000>

Stel meerdere omgevingsvariabelen tegelijk in.

Veel Azure CLI-parameters nemen meerdere waarden gescheiden door een spatie. Configuratiewaarden zijn een dergelijke instantie. In het volgende voorbeeld worden zowel de .location als de .group standaardinstellingen ingesteld die worden gebruikt door de --location en --resource-group parameters van elke Azure CLI-opdracht.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Stel de standaarduitvoer in.

Wanneer u ervoor kiest om in Azure Cloud Shell te werken of de Azure CLI lokaal te installeren, wordt de standaarduitvoer automatisch ingesteld op json. Dit is echter een van de belangrijkste standaardwaarden die moeten worden begrepen en ingesteld. De uitvoer bepaalt wat er op uw console wordt weergegeven en wat er naar uw logboekbestand wordt geschreven. Gebruik altijd een uitvoer van none wanneer u resources maakt die sleutels, wachtwoorden en geheimen retourneren.
```
az config set core.output=none
```
In deze zelfstudie werken we niet met geheimen. Stel de standaardinstelling weer in op json zodat u de geretourneerde uitvoer van elke verwijzingsopdracht in deze zelfstudie kunt zien.
```
az config set core.output=json
```

Leer az init te gebruiken.

De Azure CLI heeft een referentieopdracht waarmee u uw omgeving kunt configureren. Typ az init in uw console en druk op Enter. Volg de opgegeven aanwijzingen.

az init

Het eerste leuke aan az init is dat het je al je huidige instellingen geeft! Hier is een voorbeeld van de uitvoer:

Your current config settings:

  Output format: JSON 
  [core.output = json]

  Standard error stream (stderr): All events 
  [core.only_show_errors = false]

  Error output: Show recommendations 
  [core.error_recommendation = on]

  Syntax highlighting: On 
  [core.no_color = false]

  Progress Bar: On 
  [core.disable_progress_bar = false]


Select an option by typing it's number

  [1] Optimize for interaction
      These settings improve the output legibility and optimize for human interaction

  [2] Optimize for automation
      These settings optimize for machine efficiency

  [3] Customize settings
      A walk through to customize common configurations

  [4] Exit (default)
      Return to the command prompt

? Your selection:

Zoek en lees uw configuratiebestand.

Als u werkt onder een 'vertrouwen maar controleren'-instelling, wilt u weten waar uw configuratiebestanden worden opgeslagen en wat ze bevatten. Het configuratiebestand zelf bevindt zich op $AZURE_CONFIG_DIR/config. De standaardwaarde van AZURE_CONFIG_DIR is $HOME/.azure op Linux en macOS, en %USERPROFILE%\.azure op Windows. Zoek uw configuratiebestand nu en kijk wat het bevat.

Meer informatie

Wilt u meer informatie over een van de onderwerpen die in deze zelfstudiestap worden behandeld? Gebruik de koppelingen in deze tabel voor meer informatie.

Onderwerp	Meer informatie
Omgevingen	Kies het juiste Azure-opdrachtregelprogramma
Aanmeldingsopties	Aanmelden met Azure CLI
Voorwaarden	Azure CLI-terminologie en ondersteuningsniveaus
Abonnementen	Abonnementen beheren met behulp van de Azure CLI
Resourcegroepen	Resourcegroepen beheren met behulp van de Azure CLI
Configuraties	De Azure CLI configureren
Azure-rollen	Azure-rollen, Microsoft Entra-rollen en klassieke abonnementbeheerder-rollen

Volgende stap

Nu u hebt geleerd hoe u uw omgeving kunt configureren, gaat u verder met de volgende stap om de verschillen tussen scripting tussen Bash, PowerShell en Cmd te leren kennen.

Leer de syntaxisverschillen van Azure CLI in Bash, PowerShell en Cmd

Delen via

De omgeving voorbereiden op de Azure CLI

De Azure CLI installeren

Uw actieve abonnement zoeken en wijzigen

Meer informatie over resourcegroepen

Een brongroep maken

Een resourcegroep met een willekeurige id maken

Omgevingsvariabelen instellen

Meer informatie

Volgende stap

Aanvullende resources

Delen via

De omgeving voorbereiden op de Azure CLI

De Azure CLI installeren

Aanmelden bij Azure met behulp van de Azure CLI

Uw actieve abonnement zoeken en wijzigen

Meer informatie over resourcegroepen

Een brongroep maken

Een resourcegroep met een willekeurige id maken

Omgevingsvariabelen instellen

Meer informatie

Volgende stap

Aanvullende resources