Vorbereiten der Umgebung für die Azure CLI

Artikel
12/11/2023

In diesem Tutorialschritt führen Sie Ihre ersten Azure CLI-Befehle aus. Dazu gehören das Ermitteln und Festlegen Ihres aktiven Abonnements und das Festlegen von Standardwerten. Außerdem erfahren Sie, wie Sie Ressourcengruppen erstellen, die eine zufällige ID enthalten, um immer einen eindeutigen Ressourcennamen zu garantieren.

Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.

Für diesen Tutorialschritt benötigen Sie mindestens Berechtigungen vom Typ contributor für Ihr Abonnement.

Installieren der Azure CLI

Wählen Sie zuerst Ihre Umgebung aus.

Verwenden Sie die Bash-Umgebung in Azure Cloud Shell, indem Sie in der oberen rechten Ecke jedes Azure CLI-Codeblocks die Schaltfläche Cloud Shell öffnen auswählen.
Wenn Sie die Azure CLI-Verweisbefehle lieber lokal ausführen möchten, installieren Sie die Azure-Befehlszeilenschnittstelle (Azure CLI).

Die aktuelle Version der Azure CLI ist 2.66.0. Informationen zur neuesten Version finden Sie in den Versionshinweisen. Führen Sie az version aus, um Ihre installierte Version zu ermitteln und festzustellen, ob Sie die CLI aktualisieren müssen.

Beim Arbeiten mit der Azure CLI gibt es verschiedene Authentifizierungsoptionen. Die Standardauthentifizierungsmethode für Anmeldungen der Azure CLI ist die Anmeldung über einen Webbrowser mit Zugriffstoken.

Führen Sie den Befehl az login aus.
```
az login
```
Wenn die Azure CLI Ihren Standardbrowser öffnen kann, wird der Autorisierungscodeflow initiiert und der Standardbrowser geöffnet, um eine Azure-Anmeldeseite zu laden.

Andernfalls wird der Gerätecodeflow initiiert, und Sie werden angewiesen, die Browserseite https://aka.ms/devicelogin zu öffnen. Geben Sie dann den Code ein, der auf Ihrem Terminal angezeigt wird.

Falls kein Webbrowser verfügbar ist oder er nicht geöffnet werden kann, können Sie den Gerätecodefluss mit az login --use-device-code erzwingen.
Melden Sie sich im Browser mit Ihren Anmeldeinformationen an.

Ermitteln und Ändern Ihres aktiven Abonnements

Überprüfen Sie nach der Anmeldung bei der Azure CLI immer Ihr aktuelles Abonnement. Wenn Sie nicht unter dem gewünschten Abonnement arbeiten, ändern Sie Ihr Abonnement mit az account set. Hier sehen Sie ein Codebeispiel, das Sie verwenden können:

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

Konsolenausgabe für Befehl az account show:

{
  "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"
  }
}

Informationen zu Ressourcengruppen

Eine Ressourcengruppe ist ein Container für Azure-Ressourcen. Um eine Ressourcengruppe zu erstellen, benötigen Sie mindestens Berechtigungen vom Typ contributor in Ihrem Abonnement.

Erstellen einer Ressourcengruppe

Innerhalb des Azure-Abonnements muss der Name der Ressourcengruppe eindeutig sein. Überprüfen Sie zunächst mithilfe des Befehls az group exists, ob der gewünschte Name verfügbar ist. Der Ausgabewert false bedeutet, dass der Name verfügbar ist.
```
az group exists --name <myUniqueRGname>
```
Rufen Sie mit dem Befehl az account list-locations eine Liste der unterstützten Regionen für Ihr Abonnement ab. Eine Liste der verfügbaren Azure-Standorte finden Sie unter Auswählen der richtigen Azure-Region.
```
az account list-locations --query "[].{Region:name}" --output table
```
Erstellen Sie nun Ihre Ressourcengruppe. Verwenden Sie den Befehl az group create.
```
az group create --location <myLocation> --name <myUniqueRGname>
```

Erstellen einer Ressourcengruppe, die eine zufällige ID enthält

Beim Testen empfiehlt es sich, eine Ressourcengruppe zu erstellen, die eine zufällige ID im Namen enthält. Wenn Sie Ihrem Ressourcengruppennamen eine zufällige ID hinzufügen, können Sie Ihren Code erneut testen, ohne warten zu müssen, bis eine vorherige Ressourcengruppe mit demselben Namen aus Azure entfernt wird.

Die Syntax der Bash- und PowerShell-Variablen unterscheidet sich. Kopieren Sie das richtige Skript für Ihre Umgebung.

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

Bash- und PowerShell-Konsolenausgabe:

{
  "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"
}

Festlegen von Umgebungsvariablen

Die Azure CLI bietet mehrere Optionen, mit denen Sie allgemeine Parameterwerte wiederverwenden können. Diese Standardwerte werden in Umgebungsvariablen gespeichert und sind für jede Anmeldung eindeutig.

Legen Sie die Standardressourcengruppe fest.

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

Legen Sie mehrere Umgebungsvariablen gleichzeitig fest.

Viele Azure CLI-Parameter verwenden mehrere Werte, die durch ein Leerzeichen getrennt sind. Ein Beispiel dafür sind Konfigurationswerte. Im nächsten Beispiel werden die Standardwerte .location und .group festgelegt, die von den Parametern --location und --resource-group der einzelnen Azure CLI-Befehle verwendet werden.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Legen Sie die Standardausgabe fest.

Wenn Sie sich für die Verwendung von Azure Cloud Shell oder die lokale Installation der Azure CLI entschieden haben, wird die Standardausgabe automatisch auf json festgelegt. Dies ist jedoch eine der wichtigsten Standardwerte, die es zu verstehen und festzulegen gilt. Die Ausgabe bestimmt, was in der Konsole angezeigt wird und was in die Protokolldatei geschrieben wird. Verwenden Sie immer die Ausgabe none, wenn Sie Ressourcen erstellen, die Schlüssel, Kennwörter und Geheimnisse zurückgeben.
```
az config set core.output=none
```
In diesem Tutorial arbeiten wir nicht mit Geheimnissen. Legen Sie die Standardeinstellung wieder auf json fest, damit Sie die zurückgegebene Ausgabe der einzelnen Verweisbefehle in diesem Tutorial sehen können.
```
az config set core.output=json
```

Machen Sie sich mit der Verwendung von az init vertraut.

Die Azure CLI verfügt über einen Verweisbefehl, der Sie durch die Konfiguration Ihrer Umgebung führt. Geben Sie in Ihrer Konsole az init ein, und drücken Sie die EINGABETASTE. Befolgen Sie dann die angezeigten Anweisungen.

az init

Der erste Vorteil von az init ist, dass Sie alle aktuellen Einstellungen erhalten. Dies ist ein Beispiel für eine Ausgabe:

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:

Suchen Sie Ihre Konfigurationsdatei, und sehen Sie sich die Datei an.

Wenn Ihr Motto „Vertrauen ist gut – Kontrolle ist besser“ lautet, möchten Sie wissen, wo Ihre Konfigurationsdateien gespeichert sind und was sie enthalten. Sie befindet sich unter $AZURE_CONFIG_DIR/config. AZURE_CONFIG_DIR hat standardmäßig den Wert $HOME/.azure (Linux und macOS) bzw. %USERPROFILE%\.azure (Windows). Suchen Sie jetzt nach der Konfigurationsdatei, und sehen Sie sich an, was sie enthält.

Weitere Details

Möchten Sie weitere Details zu einem der in diesem Tutorialschritt behandelten Themen? Weitere Informationen finden Sie unter den Links in dieser Tabelle:

Betreff	Weitere Informationen
Umgebungen	Wählen des richtigen Azure-Befehlszeilentools
Anmeldeoptionen	Anmelden mit der Azure CLI
Terms	Azure CLI-Terminologie und Supportebenen
Abonnements	Verwalten von Abonnements mithilfe der Azure CLI
Ressourcengruppen	Verwalten von Ressourcengruppen mithilfe der Azure CLI
Konfigurationen	Konfigurieren der Azure CLI
Azure-Rollen	Azure-Rollen, Microsoft Entra-Rollen und Administratorrollen für klassische Abonnements

Nächster Schritt

Sie haben gelernt, wie Sie Ihre Umgebung konfigurieren. Fahren Sie nun mit dem nächsten Schritt fort, um mehr über die Skriptunterschiede zwischen Bash, PowerShell und Cmd zu erfahren.

Azure CLI-Syntaxunterschiede zwischen Bash, PowerShell und Cmd

Freigeben über

Vorbereiten der Umgebung für die Azure CLI

Installieren der Azure CLI

Ermitteln und Ändern Ihres aktiven Abonnements

Informationen zu Ressourcengruppen

Erstellen einer Ressourcengruppe

Erstellen einer Ressourcengruppe, die eine zufällige ID enthält

Festlegen von Umgebungsvariablen

Weitere Details

Nächster Schritt

Zusätzliche Ressourcen

Freigeben über

Vorbereiten der Umgebung für die Azure CLI

Installieren der Azure CLI

Anmelden bei Azure mithilfe der Azure CLI

Ermitteln und Ändern Ihres aktiven Abonnements

Informationen zu Ressourcengruppen

Erstellen einer Ressourcengruppe

Erstellen einer Ressourcengruppe, die eine zufällige ID enthält

Festlegen von Umgebungsvariablen

Weitere Details

Nächster Schritt

Zusätzliche Ressourcen