Registrieren von Azure Stack Hub in Azure

• Sie müssen über eine Abonnement-ID eines Azure-Abonnements verfügen. Nur Abonnements freigegebener EA-, CSP- oder CSP-Dienste werden für die Registrierung unterstützt. CSPs müssen entscheiden, ob ein CSP- oder APSS-Abonnement verwendet werden soll.
  
  Um die ID abzurufen, navigieren Sie zum Azure-Portal und wählen Alle Dienste > Allgemein > Abonnements aus. Wählen Sie in der Liste das Abonnement aus, das Sie verwenden möchten. Suchen Sie im Abschnitt Essentials nach der Abonnement-ID. Verwenden Sie als bewährte Methode separate Abonnements für Produktions- und Entwicklungs-/Testumgebungen.

• Sie müssen über eine Abonnement-ID eines Azure-Abonnements verfügen. Die Registrierung wird nur für EA-Abonnements unterstützt.

  Um die ID abzurufen, navigieren Sie zum Azure-Portal und wählen Alle Dienste > Allgemein > Abonnements aus. Wählen Sie in der Liste das Abonnement aus, das Sie verwenden möchten. Suchen Sie im Abschnitt Essentials nach der Abonnement-ID. Verwenden Sie als bewährte Methode separate Abonnements für Produktions- und Entwicklungs-/Testumgebungen.

Bei einer verbundenen Bereitstellung kann Azure Stack Hub eine Verbindung mit dem Internet und mit Azure herstellen. Sie können auch Microsoft Entra ID oder Active Directory-Verbunddienste (AD FS) (AD FS) als Identitätsspeicher verwenden und aus zwei Abrechnungsmodellen wählen: nutzungsbasierte Bezahlung oder kapazitätsbasiert. Sie geben das Abrechnungsmodell später beim Ausführen des Registrierungsskripts an.

Bei einer getrennten Bereitstellung können Sie Azure Stack Hub ohne Internetverbindung verwenden. Getrennte Bereitstellungen sind auf einen AD FS-Identitätsspeicher und das kapazitätsbasierte Abrechnungsmodell beschränkt. Sie geben das Abrechnungsmodell später beim Ausführen des Registrierungsskripts an.

Registrieren für die nutzungsbasierte Abrechnung

Befolgen Sie diese Schritte zum Registrieren von Azure Stack Hub bei Azure unter Verwendung des nutzungsbasierten Abrechnungsmodells.

In mit Azure verbundenen Umgebungen kann auf das Internet und Azure zugegriffen werden. Für diese Umgebungen müssen Sie den Azure Stack Hub-Ressourcenanbieter bei Azure registrieren und dann Ihr Abrechnungsmodell konfigurieren.

Der Vorgang dauert zwischen 10 und 15 Minuten. Wenn der Befehl abgeschlossen ist, sehen Sie die Meldung, dass Ihre Umgebung nun registriert und mit den angegebenen Parametern aktiviert wurde.

Registrieren für die kapazitätsbasierte Abrechnung

Befolgen Sie diese Schritte zum Registrieren von Azure Stack Hub bei Azure unter Verwendung des kapazitätsbasierten Abrechnungsmodells.

In mit Azure verbundenen Umgebungen kann auf das Internet und Azure zugegriffen werden. Für diese Umgebungen müssen Sie den Azure Stack Hub-Ressourcenanbieter bei Azure registrieren und dann Ihr Abrechnungsmodell konfigurieren.

Registrieren für die kapazitätsbasierte Abrechnung

Wenn Sie Azure Stack Hub in einer nicht verbundenen Umgebung (ohne Internetverbindung) registrieren, müssen Sie ein Registrierungstoken aus der Azure Stack Hub-Umgebung abrufen. Dieses Token muss dann auf einem Computer verwendet werden, der eine Verbindung mit Azure herstellen kann und auf dem PowerShell für Azure Stack Hub installiert ist.

Abrufen eines Registrierungstokens aus der Azure Stack Hub-Umgebung

1. Starten Sie PowerShell ISE als Administrator, und navigieren Sie zum Ordner Registration im Verzeichnis AzureStack-Tools-az, das beim Herunterladen der Azure Stack Hub-Tools erstellt wurde. Importieren Sie das Modul RegisterWithAzure.psm1:

   Import-Module .\RegisterWithAzure.psm1
   

2. Führen Sie die folgenden PowerShell-Cmdlets zum Abrufen des Registrierungstokens aus:

   $FilePathForRegistrationToken = "$env:SystemDrive\RegistrationToken.txt"
   $YourCloudAdminCredential = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
   $RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $YourCloudAdminCredential `
    -UsageReportingEnabled:$false `
    -PrivilegedEndpoint <PrivilegedEndPoint computer name> `
    -BillingModel Capacity `
    -AgreementNumber '<EA agreement number>' `
    -TokenOutputFilePath $FilePathForRegistrationToken
   

   Verwenden Sie die Nummer des Enterprise Agreement, mit dem Ihre Kapazitäts-SKU-Lizenzen erworben wurden.

   Weitere Informationen zum Cmdlet „Get-AzsRegistrationToken“ finden Sie in der Referenz zur Registrierung.

   Tipp

   Das Registrierungstoken wird in der Datei gespeichert, die für $FilePathForRegistrationToken angegeben ist. Sie können den Dateipfad oder den Dateinamen nach eigenem Ermessen ändern.

3. Speichern Sie dieses Registrierungstoken für die Verwendung auf dem mit Azure verbundenen Computer. Sie können die Datei oder den Text aus $FilePathForRegistrationToken kopieren.

Verbinden mit Azure und Registrieren

Führen Sie auf dem Computer, der mit dem Internet verbunden ist, die gleichen Schritte aus, um das Modul „RegisterWithAzure.psm1“ zu importieren und sich im richtigen Azure PowerShell-Kontext anzumelden. Rufen Sie dann „Register-AzsEnvironment“ auf. Geben Sie das Registrierungstoken für die Registrierung bei Azure an. Wenn Sie mehrere Instanzen von Azure Stack Hub mit der gleichen Azure-Abonnement-ID registrieren, legen Sie einen eindeutigen Namen für die Registrierung fest.

Sie benötigen Ihr Registrierungstoken und einen eindeutigen Tokennamen.

1. Starten Sie PowerShell ISE als Administrator, und navigieren Sie zum Ordner Registration im Verzeichnis AzureStack-Tools-az, das beim Herunterladen der Azure Stack Hub-Tools erstellt wurde. Importieren Sie das Modul RegisterWithAzure.psm1:

   Import-Module .\RegisterWithAzure.psm1
   

2. Führen Sie anschließend die folgenden PowerShell-Cmdlets aus:

   $RegistrationToken = "<Your Registration Token>"
   $RegistrationName = "<unique-registration-name>"
   Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName
   

Optional können Sie mit dem Cmdlet „Get-Content“ auf eine Datei verweisen, die Ihr Registrierungstoken enthält.

Sie benötigen Ihr Registrierungstoken und einen eindeutigen Tokennamen.

1. Starten Sie PowerShell ISE als Administrator, und navigieren Sie zum Ordner Registration im Verzeichnis AzureStack-Tools-az, das beim Herunterladen der Azure Stack Hub-Tools erstellt wurde. Importieren Sie das Modul RegisterWithAzure.psm1:

   Import-Module .\RegisterWithAzure.psm1
   

2. Führen Sie anschließend die folgenden PowerShell-Cmdlets aus:

   $RegistrationToken = Get-Content -Path '<Path>\<Registration Token File>'
   Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName
   

Abrufen eines Aktivierungsschlüssels aus der Azure-Registrierungsressource

Als Nächstes müssen Sie einen Aktivierungsschlüssel aus der Registrierungsressource abrufen, die in Azure während der Ausführung von „Register-AzsEnvironment“ erstellt wurde.

Führen Sie die folgenden PowerShell-Cmdlets zum Abrufen des Aktivierungsschlüssels aus:

$RegistrationResourceName = "<unique-registration-name>"
$KeyOutputFilePath = "$env:SystemDrive\ActivationKey.txt"
$ActivationKey = Get-AzsActivationKey -RegistrationName $RegistrationResourceName -KeyOutputFilePath $KeyOutputFilePath

Erstellen einer Aktivierungsressource in Azure Stack Hub

Kehren Sie mit der Datei oder dem Text aus dem Aktivierungsschlüssel, der von Get-AzsActivationKey erstellt wurde, zur Azure Stack Hub-Umgebung zurück. Erstellen Sie als Nächstes in Azure Stack Hub eine Aktivierungsressource mit diesem Aktivierungsschlüssel. Führen Sie die folgenden PowerShell-Cmdlets zum Erstellen einer Aktivierungsressource aus:

# Open the file that contains the activation key (from Azure), copy the entire contents into your clipboard, then within your PowerShell session (that will communicate with the PEP), paste the activation key contents into a string variable, enclosed by quotation marks: 
$ActivationKey = "<paste activation key here>"
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey

Optional können Sie mit dem Cmdlet „Get-Content“ auf eine Datei zeigen, die Ihr Registrierungstoken enthält:

$ActivationKey = Get-Content -Path '<Path>\<Activation Key File>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey

In folgenden Fällen müssen Sie Ihre Registrierung aktualisieren:

• Nachdem Sie Ihr kapazitätsbasiertes Jahresabonnement verlängert haben.
• Wenn Sie Ihr Abrechnungsmodell ändern.
• Wenn sich Ihre Skalierung ändert (Knoten hinzufügen/entfernen) für die kapazitätsbasierte Abrechnung.

Voraussetzungen

Sie benötigen die folgenden Informationen im Administratorportal, um die Registrierung zu erneuern oder zu ändern:

Ändern des verwendeten Abonnements

Wenn Sie das von Ihnen verwendete Abonnement ändern möchten, müssen Sie zuerst das Cmdlet Remove-AzsRegistration ausführen und sich anschließend vergewissern, dass Sie im richtigen Azure PowerShell-Kontext angemeldet sind. Führen Sie dann Set-AzsRegistration mit allen geänderten Parametern (einschließlich <billing model>) aus. Bei der Ausführung von Remove-AzsRegistration müssen Sie bei dem Abonnement angemeldet sein, das bei der Registrierung verwendet wurde, und die Werte der Parameter RegistrationName und ResourceGroupName wie im Administratorportal angezeigt verwenden:

# select the subscription used during the registration (shown in portal)
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
# unregister using the parameter values from portal
Remove-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'
# switch to new subscription id
Select-AzSubscription -Subscription '<New subscription ID>'
# register
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<Billing model>' -RegistrationName '<Registration name>' -ResourceGroupName '<Registration resource group name>'

# select the subscription used during the registration (shown in portal)
Select-AzureRMSubscription -Subscription '<Registration subscription ID from portal>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
# unregister using the parameter values from portal
Remove-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'
# switch to new subscription id
Select-AzureRMSubscription -Subscription '<New subscription ID>'
# register
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<Billing model>' -RegistrationName '<Registration name>' -ResourceGroupName '<Registration resource group name>'

Ändern des Abrechnungsmodells, des Verfahrens zum Anbieten von Features oder erneutes Registrieren Ihrer Instanz

Dieser Abschnitt bietet Anweisungen für den Fall, dass Sie das Abrechnungsmodell ändern möchten, dass Sie ändern möchten, wie Features angeboten werden, oder dass Sie die Instanz erneut registrieren möchten. In allen diesen Fällen wird die-Registrierungsfunktion aufgerufen, um die neuen Werte festzulegen. Die aktuelle Registrierung muss zuvor nicht entfernt werden. Melden Sie sich mit der Abonnement-ID an, die im Administratorportal angezeigt wird. Führen Sie dann die Registrierung erneut mit einem neuen BillingModel-Wert aus,und lassen Sie die im Administratorportal angezeigten Werte für die Parameter RegistrationName und ResourceGroupName unverändert:

# select the subscription used during the registration
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
# rerun registration with new BillingModel (or same billing model in case of re-registration) but using other parameters values from portal
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<New billing model>' -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'

# select the subscription used during the registration
Select-AzureRMSubscription -Subscription '<Registration subscription ID from portal>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
# rerun registration with new BillingModel (or same billing model in case of re-registration) but using other parameters values from portal
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<New billing model>' -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'

In folgenden Fällen müssen Sie Ihre Registrierung aktualisieren oder verlängern:

• Nachdem Sie Ihr kapazitätsbasiertes Jahresabonnement verlängert haben.
• Wenn Sie Ihr Abrechnungsmodell ändern.
• Wenn Sie Änderungen für die kapazitätsbasierte Abrechnung vornehmen (Knoten hinzufügen/entfernen).

Entfernen der Aktivierungsressource aus Azure Stack Hub

Sie müssen zuerst die Aktivierungsressource aus Azure Stack Hub und dann die Registrierungsressource in Azure entfernen.

Zum Entfernen der Aktivierungsressource in Azure Stack Hub führen Sie die folgenden PowerShell-Cmdlets in Ihrer Azure Stack Hub-Umgebung aus:

$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
Remove-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint

Um die Registrierungsressource in Azure zu entfernen, vergewissern Sie sich als Nächstes, dass Sie einen mit Azure verbundenen Computer verwenden. Melden Sie sich dann im richtigen Azure PowerShell-Kontext an, und führen Sie die entsprechenden PowerShell-Cmdlets aus, wie weiter unten beschrieben.

Sie können das Registrierungstoken verwenden, mit dem die Ressource erstellt wurde:

$RegistrationToken = "<registration token>"
Unregister-AzsEnvironment -RegistrationToken $RegistrationToken

Oder Sie können den Registrierungsnamen und die Registrierungsressourcengruppe aus dem Administratorportal verwenden:

Unregister-AzsEnvironment -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'

Erneutes Registrieren in einem verbundenen Szenario

Wenn Sie Ihr Abrechnungsmodell von der Kapazitätsabrechnung in einem getrennten Zustand zur Verbrauchsabrechnung in einem verbundenen Zustand ändern, registrieren Sie sich nach den Schritten des verbundenen Modells erneut.

Erneutes Registrieren in einem nicht verbundenen Szenario

Sie haben nun die Registrierung in einem nicht verbundenen Szenario vollständig aufgehoben und müssen die Schritte zum Registrieren einer Azure Stack Hub-Umgebung in einem nicht verbundenen Szenario wiederholen.

Führen Sie die folgenden PowerShell-Cmdlets aus:

$CloudAdminCred = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
$RegistrationName = "<unique-registration-name>"
Set-AzsRegistration `
   -PrivilegedEndpointCredential $CloudAdminCred `
   -PrivilegedEndpoint <PrivilegedEndPoint computer name> `
   -BillingModel Capacity
   -RegistrationName $RegistrationName
   -UsageReportingEnabled:$false

1. Führen Sie die folgenden PowerShell-Cmdlets aus, um das Registrierungstoken zu ändern:

   $YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
   $FilePathForRegistrationToken = $env:SystemDrive\RegistrationToken.txt
   $RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $YourCloudAdminCredential -UsageReportingEnabled:$false -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel Capacity -AgreementNumber '<EA agreement number>' -TokenOutputFilePath $FilePathForRegistrationToken
   

   Verwenden Sie die Nummer des Enterprise Agreement, mit dem Ihre Kapazitäts-SKU-Lizenzen erworben wurden.

   Tipp

   Das Registrierungstoken wird in der Datei gespeichert, die für $FilePathForRegistrationToken angegeben ist. Sie können den Dateipfad oder den Dateinamen nach eigenem Ermessen ändern.

2. Speichern Sie dieses Registrierungstoken für die Verwendung auf einem mit Azure verbundenen Computer. Sie können die Datei oder den Text aus $FilePathForRegistrationToken kopieren.

• Sie werden von der Marketplace-Verwaltung weiterhin zur Registrierung und Aktivierung Ihrer Azure Stack Hub-Instanz aufgefordert, obwohl Sie Ihren Stempel bereits mithilfe des nicht verbundenen Prozesses registriert haben.

  Ursache: Dies ist ein bekanntes Problem für nicht verbundene Umgebungen und erfordert, dass Sie Ihre Registrierung status überprüfen müssen. Verwenden Sie das Offlinetool, um die Marketplace-Verwaltung zu nutzen.