De omgeving voorbereiden op de Azure CLI

Artikel
12/06/2023

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 maken voordat u begint.

Als u deze zelfstudiestap wilt voltooien, hebt u machtigingen voor uw abonnement nodig contributor of hoger.

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, installeert u de Azure CLI.

De huidige versie van de Azure CLI is 2.60.0. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release. Als u de geïnstalleerde versie wilt zoeken en wilt zien of u wilt bijwerken, voert u az version uit.

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

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.

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 wilt gebruiken, wijzigt u uw abonnement met behulp van 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 machtigingen of hoger nodig contributor in uw abonnement.

Een brongroep maken

Binnen een abonnement moet de naam van een resourcegroep uniek zijn. Controleer eerst of de gewenste naam beschikbaar is met behulp van de opdracht az group. Een uitvoerwaarde van false betekent dat de naam beschikbaar is.
```
az group exists --name <myUniqueRGname>
```
Haal een lijst met ondersteunde regio's voor uw abonnement op met de opdracht az account list-locations . Zie De juiste Azure-regio voor u kiezen 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 opdracht az group create .
```
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 als de .location.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, json zodat u de geretourneerde uitvoer van elke verwijzingsopdracht in deze zelfstudie kunt zien.
```
az config set core.output=json
```

Leer hoe u dit kunt gebruiken az init.

De Azure CLI heeft een referentieopdracht waarmee u uw omgeving kunt configureren. Typ az init 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 volgt een voorbeeld van 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 deze locatie: $AZURE_CONFIG_DIR/config. De standaardwaarde van AZURE_CONFIG_DIR is in Linux- en Mac OS $HOME/.azure en in Windows %USERPROFILE%\.azure. 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	Het juiste Azure-opdrachtregelprogramma kiezen
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 abonnementsbeheerdersrollen

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.

Verschillen in Azure CLI-syntaxis in Bash, PowerShell en Cmd

Share 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

Share 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