Herstellen einer Verbindung mit Azure Stack Hub über die Azure-Kontoerweiterung in Visual Studio Code

  • Artikel
  • 4 Minuten Lesedauer

In diesem Artikel wird Schritt für Schritt beschrieben, wie Sie eine Verbindung mit Azure Stack Hub herstellen, indem Sie die Azure-Kontoerweiterung verwenden. Über Erweiterungen können Sie Azure direkt in Visual Studio Code verwenden. Sie müssen Ihre VS Code-Einstellungen (Visual Studio Code) aktualisieren.

VS Code ist ein einfacher Editor zum Erstellen und Debuggen von Web- und Cloudanwendungen. ASP.NET Core, Python, NodeJS, Go und andere Entwickler verwenden VS Code. Mit der Azure-Kontoerweiterung können Sie eine einzelne Azure-Anmeldung mit Abonnementfilterung für andere Azure-Erweiterungen verwenden. Die Erweiterung macht die Azure Cloud Shell im VS Code-integrierten Terminal verfügbar. Mit der Erweiterung können Sie eine Verbindung mit Ihrem Azure Stack Hub-Abonnement herstellen, indem Sie sowohl Azure Active Directory (Azure AD) als auch Active Directory-Verbunddienste (AD FS) für Ihren Identitäts-Manager verwenden. Sie können sich bei Azure Stack Hub anmelden, Ihr Abonnement auswählen und eine neue Befehlszeile in einer Cloud Shell-Instanz öffnen.

Hinweis

Sie können die Schritte in diesem Artikel für eine AD FS-Umgebung (Active Directory-Verbunddienste) nutzen. Verwenden Sie Ihre AD FS-Anmeldeinformationen und -Endpunkte.

Visual Studio Code und Azure Stack Hub

Zusätzlich zur Azure-Kontoerweiterung für Visual Studio werden einige andere Azure-Erweiterungen für die Verwendung mit Azure Stack Hub und Visual Studio Code unterstützt. Dazu gehören:

Voraussetzungen für die Azure-Kontoerweiterung

Anmeldeinformationen eingeben

In diesem Abschnitt verwenden Sie Ihre Anmeldeinformationen, um Ihre Mandanten-ID abzurufen. Sie benötigen Ihre Azure Stack Hub Resource Manager-URL und die Mandanten-ID.

Der Microsoft Azure Stack Hub Resource Manager ist ein Verwaltungsframework, mit dem Sie Azure-Ressourcen bereitstellen, verwalten und überwachen können.

  • Die Resource Manager-URL für das Azure Stack Development Kit (ASDK) lautet: https://management.local.azurestack.external/.
  • Die Resource Manager-URL in integrierten Systemen lautet https://management.region.<fqdn>/, wobei <fqdn> Ihr vollqualifizierter Domänenname ist.

  1. Öffnen Sie PowerShell mit einer Eingabeaufforderung mit erhöhten Rechten. Führen Sie die folgenden Cmdlets aus:

    Add-AzEnvironment -Name "<username@contoso.com>" -ArmEndpoint "https://management.region.<fqdn>"

    Name  Resource Manager Url                            ActiveDirectory Authority
----  --------------------                            -------------------------
username@contoso.com https://management.region.<fqdn> https://login.microsoftonline.com/

  2. Führen Sie in der gleichen Sitzung die folgenden Cmdlets aus:

    $AuthEndpoint = (Get-AzEnvironment -Name "sethm@microsoft.com").ActiveDirectoryAuthority.TrimEnd('/')
$AADTenantName = "masselfhost.onmicrosoft.com"
$TenantId = (invoke-restmethod "$($AuthEndpoint)/$($AADTenantName)/.well-known/openid-configuration").issuer.TrimEnd('/').Split('/')[-1]
Add-AzAccount -EnvironmentName "sethm@microsoft.com" -TenantId $TenantId

    Account               SubscriptionName  TenantId                             Environment
-------               ----------------  --------                             -----------
username@contoso.com   azure-stack-sub  6d5ff183-b37f-4a5b-9a2f-19959cb4224a username@contoso.com

  3. Notieren Sie sich die Mandanten-ID. Diese Information ist beim Hinzufügen des JSON-Abschnitts erforderlich, der die Azure-Kontoerweiterung konfiguriert.

Einrichten der Azure-Kontoerweiterung

  1. Öffnen Sie Visual Studio Code.

  2. Wählen Sie links in der Ecke die Option Erweiterungen.

  3. Geben Sie im Suchfeld Azure Accountein.

  4. Wählen Sie Azure-Konto und dann Installieren.

    Azure Stack Hub – Visual Studio Code

  5. Starten Sie VS Code neu, um die Erweiterung zu laden.

  6. Drücken Sie STRG+UMSCHALT+P, und wählen Sie Preferences: Open User Settings (JSON) (Einstellungen: Benutzereinstellungen öffnen [JSON]) aus.

  7. Aktualisieren Sie im Code-Editor den folgenden JSON-Codeausschnitt mit den Werten für Ihre Umgebung, und fügen Sie den Codeausschnitt dann in den Block mit den Einstellungen ein.

    • Werte:

      Parameter Beschreibung
      azure.cloud Sie müssen die Literalkonstante „AzureCustomCloud“ für diesen Parameter verwenden.
      azure.tenant Der Wert Ihrer Mandanten-ID für Azure Stack Hub.
      azure.customCloud.resourceManagerEndpointUrl Dies ist die Stamm-URL für die Azure Resource Manager-Instanz für Azure Stack Hub.
      validateAuthority Sie können diesen Parameter weglassen, wenn Sie Azure AD als Identity Manager verwenden. Fügen Sie den Parameter mit dem Wert false hinzu, wenn Sie AD FS verwenden.

    • JSON-Codeausschnitt:

        "azure.cloud": "AzureCustomCloud",
  "azure.customCloud.resourceManagerEndpointUrl": "https://management.region.<fqdn>",
  "azure.tenant": "<your-tenant-ID>",

  8. Speichern Sie die Benutzereinstellungen (JSON) und drücken Sie erneut STRG+UMSCHALT+P. Wählen Sie Azure: Anmelden. Die Authentifizierungsseite wird in Ihrem Browser geladen. Melden Sie sich an Ihrem Endpunkt an.

  9. Um das erfolgreiche Anmelden an Ihrem Azure Stack Hub-Abonnement zu testen, drücken Sie STRG+UMSCHALT+P und wählen Azure: Select Subscription (Azure: Abonnement auswählen). Sie können dann prüfen, ob das gewünschte Abonnement verfügbar ist.

Befehle

Azure: Anmelden Melden Sie sich bei Ihrem Azure-Abonnement an.
Azure: Anmelden mit Gerätecode Melden Sie sich an Ihrem Azure-Abonnement mit einem Gerätecode an. Verwenden Sie in Setups, in denen der Befehl „Anmelden“ nicht funktioniert, einen Gerätecode.
Azure: Anmelden an der Azure-Cloud Melden Sie sich an Ihrem Azure-Abonnement in einer der Sovereign Clouds an.
Azure: Abmelde- Melden Sie sich von Ihrem Azure-Abonnement ab.
Azure: Auswählen von Abonnements Wählen Sie die Gruppe mit den Abonnements aus, die Sie verwenden möchten. Die Erweiterung zeigt nur Ressourcen in den gefilterten Abonnements an.
Azure: Erstellen eines Kontos Falls Sie nicht über ein Azure-Konto verfügen, können Sie sich noch heute registrieren und 200 USD Guthaben erhalten.
Azure: Öffnen von Bash in Cloud Shell Öffnen Sie ein neues Terminal zur Ausführung von Bash in Cloud Shell.
Azure: Öffnen von PowerShell in Cloud Shell Öffnen Sie ein neues Terminal zur Ausführung von PowerShell in Cloud Shell.
Azure: Hochladen in Cloud Shell Laden Sie eine Datei in Ihr Cloud Shell-Speicherkonto hoch.

Nächste Schritte

Einrichten einer Entwicklungsumgebung in Azure Stack Hub

Einrichten von Azure Storage in Ihrer Azure Stack Hub-Instanz in Visual Studio Code