De ASDK registreren bij Azure

  • Artikel

U kunt de installatie van uw Azure Stack Development Kit (ASDK) registreren bij Azure om Marketplace-items te downloaden van Azure en om rapportage van handelsgegevens naar Microsoft in te stellen. Registratie is vereist voor de volledige ondersteuning van Azure Stack Hub-functionaliteit, inclusief marketplace-syndicatie. Registratie is vereist om belangrijke Azure Stack Hub-functionaliteit te testen, zoals marketplace-syndicatie en gebruiksrapportage. Nadat u Azure Stack Hub hebt geregistreerd, wordt het gebruik gerapporteerd aan Azure Commerce. U kunt deze zien onder het abonnement dat u hebt gebruikt voor de registratie. ASDK-gebruikers worden echter niet in rekening gebracht voor het gebruik dat ze rapporteren.

Als u uw ASDK niet registreert, ziet u mogelijk een waarschuwing activering vereist die u aanraadt om uw ASDK te registreren. Dit gedrag is verwacht.

Vereisten

Voordat u deze instructies gebruikt om de ASDK bij Azure te registreren, moet u ervoor zorgen dat u Azure Stack Hub PowerShell hebt geïnstalleerd en de Azure Stack Hub-hulpprogramma's hebt gedownload, zoals beschreven in het artikel over configuratie na implementatie .

De PowerShell-taalmodus moet ook worden ingesteld op FullLanguage op de computer die wordt gebruikt om de ASDK bij Azure te registreren. Als u wilt controleren of de huidige taalmodus is ingesteld op Volledig, opent u een PowerShell-venster met verhoogde bevoegdheid en voert u de volgende PowerShell-opdrachten uit:

$ExecutionContext.SessionState.LanguageMode

Zorg ervoor dat de uitvoer FullLanguage retourneert. Als een andere taalmodus wordt geretourneerd, moet de registratie worden uitgevoerd op een andere computer of de taalmodus ingesteld op FullLanguage voordat u doorgaat.

Het Microsoft Entra-account dat wordt gebruikt voor registratie, moet toegang hebben tot het Azure-abonnement en machtigingen hebben om identiteits-apps en service-principals te maken in de directory die is gekoppeld aan dat abonnement. U wordt aangeraden Azure Stack Hub bij Azure te registreren door een serviceaccount te maken voor registratie in plaats van de referenties van een globale beheerder te gebruiken.

De ASDK registreren

Volg deze stappen om de ASDK bij Azure te registreren.

Notitie

Al deze stappen moeten worden uitgevoerd vanaf een computer die toegang heeft tot het bevoegde eindpunt. Voor de ASDK is dat de ASDK-hostcomputer.

  1. Open een PowerShell-prompt met verhoogde bevoegdheid.

  2. Voer de volgende PowerShell-cmdlets uit om uw ASDK-installatie bij Azure te registreren. Meld u aan bij zowel uw Abonnements-id voor Azure-facturering als de lokale ASDK-installatie. Als u nog geen abonnements-id voor Azure-facturering hebt, kunt u hier een gratis Azure-account maken. Voor het registreren van Azure Stack Hub zijn er geen kosten verbonden aan uw Azure-abonnement.

    Stel een unieke naam in voor de registratie wanneer u de cmdlet Set-AzsRegistration uitvoert. De parameter RegistrationName heeft de standaardwaarde AzureStackRegistration. Als u echter dezelfde naam gebruikt op meer dan één exemplaar van Azure Stack Hub, mislukt het script.

    # Add the Azure cloud subscription environment name. 
# Supported environment names are AzureCloud, AzureChinaCloud, or AzureUSGovernment depending which Azure subscription you're using.
Connect-AzAccount -EnvironmentName "<environment name>"

# Register the Azure Stack Hub resource provider in your Azure subscription
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

# If you have multiple subscriptions, run the following command to select the one you want to use:
# Get-AzSubscription -SubscriptionID "<subscription ID>" | Select-AzSubscription

# Register Azure Stack Hub
$AzureContext = Get-AzContext
$CloudAdminCred = Get-Credential -UserName AZURESTACK\CloudAdmin -Message "Enter the credentials to access the privileged endpoint."
$RegistrationName = "<unique-registration-name>"
Set-AzsRegistration `
-PrivilegedEndpointCredential $CloudAdminCred `
-PrivilegedEndpoint AzS-ERCS01 `
-BillingModel Development `
-RegistrationName $RegistrationName `
-UsageReportingEnabled:$true

  3. Wanneer het script is voltooid, ziet u dit bericht: Uw omgeving is nu geregistreerd en geactiveerd met behulp van de opgegeven parameters.

Uw omgeving is nu geregistreerd

Registreren in niet-verbonden omgevingen

Als u Azure Stack Hub registreert in een niet-verbonden omgeving (zonder internetverbinding), moet u een registratietoken ophalen uit de Azure Stack Hub-omgeving en dat token vervolgens gebruiken op een computer die verbinding kan maken met Azure om een activeringsresource voor uw ASDK-omgeving te registreren en te maken.

Belangrijk

Voordat u deze instructies gebruikt om Azure Stack Hub te registreren, moet u ervoor zorgen dat u PowerShell voor Azure Stack Hub hebt geïnstalleerd en de Azure Stack Hub-hulpprogramma's hebt gedownload, zoals beschreven in het artikel configuratie na implementatie op zowel de ASDK-hostcomputer als de computer met internettoegang die wordt gebruikt om verbinding te maken met Azure en om te registreren.

Een registratietoken ophalen uit de Azure Stack Hub-omgeving

Start PowerShell op de ASDK-hostcomputer als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die u hebt gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Gebruik de volgende PowerShell-opdrachten om de module RegisterWithAzure.psm1 te importeren en gebruik vervolgens de cmdlet Get-AzsRegistrationToken om het registratietoken op te halen:

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

# Create registration token
$CloudAdminCred = Get-Credential -UserName AZURESTACK\CloudAdmin -Message "Enter the credentials to access the privileged endpoint."
# File path to save the token. This example saves the file as C:\RegistrationToken.txt.
$FilePathForRegistrationToken = "$env:SystemDrive\RegistrationToken.txt"
$RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $CloudAdminCred `
-UsageReportingEnabled:$false `
-PrivilegedEndpoint AzS-ERCS01 `
-BillingModel Development `
-MarketplaceSyndicationEnabled:$false `
-TokenOutputFilePath $FilePathForRegistrationToken

Sla dit registratietoken op voor gebruik op de computer met internetverbinding. U kunt het bestand of de tekst kopiëren uit het bestand dat is gemaakt met de $FilePathForRegistrationToken parameter .

Verbinding maken met Azure en registreren

Gebruik op de computer met internetverbinding de volgende PowerShell-opdrachten om de module RegisterWithAzure.psm1 te importeren en gebruik vervolgens de cmdlet Register-AzsEnvironment om u te registreren bij Azure met behulp van het registratietoken dat u zojuist hebt gemaakt en een unieke registratienaam:

# Add the Azure cloud subscription environment name. 
# Supported environment names are AzureCloud, AzureChinaCloud or AzureUSGovernment depending which Azure subscription you are using.
Connect-AzAccount -EnvironmentName "<environment name>"

# If you have multiple subscriptions, run the following command to select the one you want to use:
# Get-AzSubscription -SubscriptionID "<subscription ID>" | Select-AzSubscription

# Register the Azure Stack Hub resource provider in your Azure subscription
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

# Register with Azure
# This example uses the C:\RegistrationToken.txt file.
$registrationToken = Get-Content -Path "$env:SystemDrive\RegistrationToken.txt"
$RegistrationName = "<unique-registration-name>"
Register-AzsEnvironment -RegistrationToken $registrationToken `
-RegistrationName $RegistrationName

U kunt ook de cmdlet Get-Content gebruiken om te verwijzen naar een bestand dat uw registratietoken bevat:

# Add the Azure cloud subscription environment name. 
# Supported environment names are AzureCloud, AzureChinaCloud or AzureUSGovernment depending which Azure subscription you are using.
Connect-AzAccount -EnvironmentName "<environment name>"

# If you have multiple subscriptions, run the following command to select the one you want to use:
# Get-AzSubscription -SubscriptionID "<subscription ID>" | Select-AzSubscription

# Register the Azure Stack Hub resource provider in your Azure subscription
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

# Register with Azure 
# This example uses the C:\RegistrationToken.txt file.
$registrationToken = Get-Content -Path "$env:SystemDrive\RegistrationToken.txt"
Register-AzsEnvironment -RegistrationToken $registrationToken `
-RegistrationName $RegistrationName

Wanneer de registratie is voltooid, ziet u een bericht dat lijkt op: Uw Azure Stack Hub-omgeving is nu geregistreerd bij Azure.

Belangrijk

Sluit het PowerShell-venster niet .

Sla het registratietoken en de naam van de registratieresource op voor toekomstig gebruik.

Een activeringssleutel ophalen uit de Azure-registratieresource

Gebruik nog steeds de computer met internetverbinding en hetzelfde PowerShell-consolevenster om een activeringssleutel op te halen uit de registratieresource die u hebt gemaakt toen u zich registreerde bij Azure.

Voer de volgende PowerShell-opdrachten uit om de activeringssleutel op te halen. Gebruik dezelfde unieke registratienaam die u hebt opgegeven bij het registreren bij Azure in de vorige stap:

$RegistrationResourceName = "<unique-registration-name>"
# File path to save the activation key. This example saves the file as C:\ActivationKey.txt.
$KeyOutputFilePath = "$env:SystemDrive\ActivationKey.txt"
$ActivationKey = Get-AzsActivationKey -RegistrationName $RegistrationResourceName `
-KeyOutputFilePath $KeyOutputFilePath

Een activeringsresource maken in Azure Stack Hub

Ga terug naar de Azure Stack Hub-omgeving met het bestand of de tekst van de activeringssleutel die is gemaakt met Get-AzsActivationKey. Voer de volgende PowerShell-opdrachten uit om een activeringsresource te maken in Azure Stack Hub met behulp van die activeringssleutel:

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

$CloudAdminCred = Get-Credential -UserName AZURESTACK\CloudAdmin -Message "Enter the credentials to access the privileged endpoint."
$ActivationKey = "<activation key>"
New-AzsActivationResource -PrivilegedEndpointCredential $CloudAdminCred `
-PrivilegedEndpoint AzS-ERCS01 `
-ActivationKey $ActivationKey

U kunt ook de cmdlet Get-Content gebruiken om te verwijzen naar een bestand dat uw registratietoken bevat:

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

$CloudAdminCred = Get-Credential -UserName AZURESTACK\CloudAdmin -Message "Enter the credentials to access the privileged endpoint."
# This example uses the C:\ActivationKey.txt file.
$ActivationKey = Get-Content -Path "$env:SystemDrive\Activationkey.txt"
New-AzsActivationResource -PrivilegedEndpointCredential $CloudAdminCred `
-PrivilegedEndpoint AzS-ERCS01 `
-ActivationKey $ActivationKey

Wanneer de activering is voltooid, ziet u een bericht dat lijkt op: Uw omgeving heeft het registratie- en activeringsproces voltooid.

Controleren of de registratie is geslaagd

U kunt de tegel Regiobeheer gebruiken om te controleren of de Azure Stack Hub-registratie is geslaagd. Deze tegel is beschikbaar op het standaarddashboard in de beheerdersportal.

  1. Meld u aan bij de Azure Stack Hub-beheerportal https://adminportal.local.azurestack.external.

  2. Selecteer in het dashboard Regiobeheer.

    Tegel Regiobeheer in azure Stack Hub-beheerportal

  3. Selecteer Eigenschappen. Op deze blade ziet u de status en details van uw omgeving. De status kan Geregistreerd of Niet geregistreerd zijn. Als u zich hebt geregistreerd, wordt ook de Azure-abonnements-id weergegeven die u hebt gebruikt om uw Azure Stack Hub te registreren, samen met de registratieresourcegroep en naam.

Een registratieresource verplaatsen

Het verplaatsen van een registratieresource tussen resourcegroepen onder hetzelfde abonnement wordt ondersteund. Zie Resources verplaatsen naar een nieuwe resourcegroep of een nieuw abonnement voor meer informatie over het verplaatsen van resources naar een nieuwe resourcegroep.

Volgende stappen