Interaktives Erstellen einer Azure-Ressource mit der Azure CLI

5 Minuten

Im interaktiven Modus können Sie mit Azure CLI Befehle sofort eingeben und ausführen.

Im CRM-Beispiel (Customer Relationship Management) besteht das Ziel darin, drei Testumgebungen zu erstellen, die jeweils VMs enthalten. Verwenden Sie Ressourcengruppen, um sicherzustellen, dass die VMs in separaten Umgebungen organisiert sind:

Komponententests
Testen der Integration
Akzeptanztests

Da Sie die Ressourcengruppen nur einmal erstellen müssen, ist die interaktive Verwendung von Azure CLI für diese Aufgabe eine angemessene Wahl.

Beispiel: Erstellen einer Ressourcengruppe mit Azure CLI

Führen Sie nun eine gängige Aufgabe aus: das Erstellen einer Ressourcengruppe. Ressourcengruppen helfen Ihnen bei der gemeinsamen Verwaltung verwandter Ressourcen, und das Erstellen einer neuen Ressourcengruppe ist häufig eine der ersten Aufgaben, die Sie beim Starten einer neuen Azure-Lösung ausführen.

Hierzu sind die drei folgenden Schritte erforderlich:

Stellen Sie über az login eine Verbindung mit Azure her.
Verwenden Sie Azure-Abonnements über az account.
Verwenden Sie Ressourcengruppen über az group.

Herstellen einer Verbindung mit Azure

Wenn Sie eine lokale Installation von Azure CLI verwenden, müssen Sie sich authentifizieren, bevor Sie Azure CLI-Befehle ausführen. Der Befehl az login fordert Sie zur Eingabe Ihrer Azure-Anmeldeinformationen auf und stellt dann eine Verbindung mit Ihrem Azure-Abonnement her.

Um interaktiv eine Verbindung herzustellen, müssen Sie keine Parameter angeben:

az login

Dieser Befehl öffnet eine Eingabeaufforderung für Ihre Azure-Anmeldeinformationen und stellt eine Verbindung mit Ihrem Azure-Abonnement her.

Hier sind einige praktische Tipps für die Authentifizierung bei Azure mit Azure CLI:

Falls Sie Azure CLI in Azure Cloud Shell ausführen...
- Sie werden automatisch authentifiziert.
- Möglicherweise müssen Sie Ihr Standardabonnement ändern.
Wenn Sie Azure CLI über eine lokale Installation ausführen...
- Sie werden zur Eingabe Ihrer Azure-Anmeldeinformationen aufgefordert.
- Zum Zeitpunkt der Anmeldung können Sie ein Abonnement auswählen.

Arbeiten mit Abonnements

Falls Sie noch keine Erfahrung mit Azure haben, verfügen Sie nur über ein Einzelabonnement. Wenn Sie Azure schon eine Weile verwenden, besitzen Sie möglicherweise mehrere Abonnements. Mit Azure CLI können Sie konfigurieren, für welches Abonnement Ihre Befehle ausgeführt werden.

Sie können jeweils nur in einem Abonnement aktiv sein. Verwenden Sie den Referenzbefehl az account show, um zu ermitteln, welches Abonnement derzeit aktiv ist. Wenn dieses nicht das richtige ist, können Sie Abonnements mithilfe des Referenzbefehls az account set ändern.

Rufen Sie eine Liste aller Abonnements ab, die die Ergebnisse in einer Tabelle zurückgibt:
```
az account list --output table
```
Rufen SIe nur das aktuelle aktive Abonnement ab:
```
az account show
```

Wechseln Sie das aktive Abonnement:

az account set --subscription "00000000-0000-0000-0000-000000000000"

Verwenden von Ressourcengruppen

Ressourcen werden bei ihrer Erstellung in Azure zu Verwaltungszwecken in einer Ressourcengruppe platziert.

Verwenden Sie den Referenzbefehl az group create, um eine Ressourcengruppe zu erstellen. Sie müssen einen Namen und einen Standort angeben, und der Name muss innerhalb Ihres Abonnements eindeutig sein. Der Standort bestimmt, wo die Metadaten für Ihre Ressourcengruppe gespeichert werden. Dies kann für Sie aus Konformitätsgründen wichtig sein. Verwenden Sie den Befehl az account list-locations, um die verfügbaren Standorte zu ermitteln.

Hinweis

Wenn Sie in einer aktiven Azure-Sandbox arbeiten, wird die Ressourcengruppe für Sie erstellt. Verwenden Sie die folgenden Befehle, wenn Sie lieber in Ihrem eigenen Abonnement arbeiten möchten.

Die Syntax zum Erstellen einer Ressourcengruppe ist wie folgt:

az group create --name MyResourceGroup --location eastus

Verwenden Sie zum Abrufen einer Liste mit allen Ressourcengruppen im aktiven Abonnement den Befehl az group list.

az group list

Für eine kompaktere Ansicht können Sie die Liste in einer Tabelle zurückgeben:

az group list --output table

Wenn Sie ein Azure CLI-Skript entwickeln und 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.

#!/bin/bash
let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Beispiel: Erstellen einer Azure-VM

Das Erstellen von VMs ist eine gängige Aufgabe, die Sie mit Azure CLI ausführen können.

Der az vm create-Befehl wird verwendet, um eine VM zu erstellen. Dieser Befehl verfügt über mehrere Parameter, um die umfangreichen Konfigurationseinstellungen für eine VM zu behandeln. Die meisten Parameter haben sinnvolle Standardwerte, daher müssen Sie in der Regel nur fünf wichtige Werte angeben:

resource-group: Die Ressourcengruppe, in der die neue VM platziert wird
name: Der Name des virtuellen Computers in Azure.
location: Die geografische Region, in der die VM bereitgestellt wird
image: Das Betriebssystemimage, das für die VM verwendet wird. In der Regel handelt es sich um eine Linux-Distribution oder eine Windows Server-Instanz.
admin-username: Administratorbenutzername für den virtuellen Computer. Sie werden aufgefordert, ein Kennwort an der Befehlszeile einzugeben.

Bash
PowerShell

Hier ist ein Bash-Skriptbeispiel:

#!/bin/bash

# Create variables
rgName="myResourceGroupName"
vmName="myVMname"
vmImage="Win2022AzureEditionCore"
vmAdminUserName="myAzureUserName"

# Create the VM
az vm create \
    --resource-group $rgName \
    --name $vmName \
    --image $vmImage \
    --public-ip-sku Standard \
    --admin-username $vmAdminUserName

Hier sehen Sie das entsprechende Beispiel zum Erstellen eines virtuellen Computers in einer PowerShell-Umgebung:

# Create variables
$rgName = "myResourceGroupName"
$vmName = "myVMname"
$vmImage = "Win2022AzureEditionCore"
$vmAdminUserName = "myAzureUserName"

# Create the VM
az vm create `
    --resource-group $rgName `
    --name $vmName `
    --image $vmImage `
    --public-ip-sku Standard `
    --admin-username $vmAdminUserName

Beispiel: Abrufen von Informationen für einen virtuellen Computer

Sie können die VMs in Ihrem Abonnement auflisten, indem Sie den Befehl az vm list verwenden. Dieser Befehl unterstützt auch das Abrufen einer bestimmten VM, indem der Parameter --name angegeben wird.

Hier erfahren Sie, wie Sie die ID einer VM in einer Variablen speichern:

#!/bin/bash
rgName="myResourceGroupName"
vmID=$(az vm list --resource-group $rgName \
    --query "[?name=='myVMname'].id" --output tsv)
echo $vmID

Ändern Sie mithilfe des Befehls az vm update die Größe Ihrer VM:

#!/bin/bash
rgName="myResourceGroupName"
vmName="msdocs-vm-01"
newVMsize="Standard_DS3_v2"

# Get the VM ID
vmID=$(az vm list --resource-group $rgName \
    --query "[?name=='$vmName'].id" --output tsv)

# Update the VM size
az vm update --ids $vmID --size $newVMsize

# Show the new properties of the VM
az vm show --resource-group $rgName --name $vmName

In dieser Übung wurde ein typisches Muster für eine interaktive Azure CLI-Sitzung gezeigt. Zuerst haben Sie einen Standardbefehl verwendet, um eine neue Ressourcengruppe zu erstellen. Danach haben Sie eine Reihe von Befehlen verwendet, um eine Ressource (in diesem Beispiel eine VM) in dieser Ressourcengruppe bereitzustellen. Sie können diese Befehle einfach in einem Shellskript zusammenfassen und jederzeit ausführen, wenn Sie die gleiche Ressource erstellen müssen.