Azure-Cloudverwaltung mit der Azure CLI

Wenn Sie regionsübergreifend arbeiten oder Azure Stack verwenden, müssen Sie möglicherweise mehrere Clouds verwenden. Hierzu stellt Ihnen Microsoft Clouds zur Verfügung, die mit regionalen Gesetzen in Einklang stehen. In diesem Artikel erfahren Sie, wie Sie Informationen zu Clouds abrufen, wie Sie die aktuelle Cloud ändern und wie Sie neue Clouds registrieren bzw. ihre Registrierung aufheben.

Auflisten verfügbarer Clouds

Die verfügbaren Clouds können mit dem Befehl az cloud list aufgelistet werden. Mit diesem Befehl erfahren Sie, welche Cloud derzeit aktiv ist, und erhalten Informationen zum aktuellen Profil, zu regionalen Suffixen und zu Hostnamen.

Gehen Sie wie folgt vor, um die aktive Cloud und eine Liste mit allen verfügbaren Clouds abzurufen:

az cloud list --output table

IsActive    Name               Profile
----------  -----------------  ---------
True        AzureCloud         latest
            AzureChinaCloud    latest
            AzureUSGovernment  latest
            AzureGermanCloud   latest

Für die derzeit aktive Cloud ist in der Spalte IsActive der Wert True angegeben. Es kann immer nur eine Cloud aktiv sein. Ausführlichere Informationen zu einer Cloud (einschließlich der Endpunkte, die sie für Azure-Dienste verwendet) erhalten Sie mit dem Befehl cloud show:

az cloud show --name AzureChinaCloud --output json

{
  "endpoints": {
    "activeDirectory": "https://login.chinacloudapi.cn",
    "activeDirectoryDataLakeResourceId": null,
    "activeDirectoryGraphResourceId": "https://graph.chinacloudapi.cn/",
    "activeDirectoryResourceId": "https://management.core.chinacloudapi.cn/",
    "batchResourceId": "https://batch.chinacloudapi.cn/",
    "gallery": "https://gallery.chinacloudapi.cn/",
    "management": "https://management.core.chinacloudapi.cn/",
    "resourceManager": "https://management.chinacloudapi.cn",
    "sqlManagement": "https://management.core.chinacloudapi.cn:8443/",
    "vmImageAliasDoc": "https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json"
  },
  "isActive": false,
  "name": "AzureChinaCloud",
  "profile": "latest",
  "suffixes": {
    "azureDatalakeAnalyticsCatalogAndJobEndpoint": null,
    "azureDatalakeStoreFileSystemEndpoint": null,
    "keyvaultDns": ".vault.azure.cn",
    "sqlServerHostname": ".database.chinacloudapi.cn",
    "storageEndpoint": "core.chinacloudapi.cn"
  }
}

Wechseln der aktiven Cloud

Informationen zum Festlegen der Standardcloud mithilfe einer Konfigurationsdatei finden Sie unter CLI-Konfigurationswerte und Umgebungsvariablen. Führen Sie zum Wechseln der Cloud den Befehl az cloud set aus. Dieser Befehl erfordert ein Argument: den Namen der Cloud.

az cloud set --name AzureChinaCloud

Wichtig

Sollte die Authentifizierung für die aktivierte Cloud abgelaufen sein, müssen Sie sich erneut authentifizieren, bevor Sie weitere CLI-Aufgaben ausführen. Beim erstmaligen Wechsel zu der neuen Cloud muss auch das aktive Abonnement festgelegt werden. Eine Anleitung zur Authentifizierung finden Sie unter Anmelden mit der Azure CLI. Weitere Informationen zur Abonnementverwaltung finden Sie unter Verwalten von Azure-Abonnements mit der Azure CLI.

Registrieren einer neuen Cloud

Registrieren Sie eine neue Cloud, wenn Sie über eigene Endpunkte für Azure Stack verfügen. Eine Cloud wird mit dem Befehl az cloud register erstellt. Dieser Befehl erfordert einen Namen und eine Reihe von Dienstendpunkten. Informationen zum Registrieren einer Cloud für die Verwendung mit Azure Stack finden Sie unter Verwenden von API-Versionsprofilen mit der Azure CLI in Azure Stack.

Für China, US Government oder deutsche Regionen müssen Sie keine Informationen registrieren. Diese Clouds werden von Microsoft verwaltet und sind standardmäßig verfügbar. Weitere Informationen zu allen verfügbaren Endpunkteinstellungen finden Sie in der Dokumentation für az cloud register.

Durch Registrieren einer Cloud wird nicht automatisch zu dieser Cloud gewechselt. Wählen Sie die neu erstellte Cloud mithilfe des Befehls az cloud set aus.

Aktualisieren einer vorhandenen Cloud

Sie können auch eine vorhandene Cloud aktualisieren, sofern Sie über die erforderlichen Berechtigungen verfügen. Bei der Aktualisierung einer Cloud wird zu einem anderen Azure-Dienstprofil gewechselt, oder die Verbindungsendpunkte werden geändert. Aktualisieren Sie eine Cloud mit dem Befehl az cloud update. Dieser akzeptiert die gleichen Argumente wie az cloud register.

Aufheben der Registrierung einer Cloud

Wenn Sie eine erstellte Cloud nicht mehr benötigen, kann ihre Registrierung mit dem Befehl az cloud unregister aufgehoben werden:

az cloud unregister --name MyCloud