Registrace sady ASDK v Azure

Článek
08/05/2024

Můžete zaregistrovat instalaci sady Azure Stack Development Kit (ASDK) v Azure a stáhnout položky z marketplace z Azure a nastavit generování sestav obchodních dat zpět do Microsoftu. Registrace se vyžaduje kvůli podpoře všech funkcí služby Azure Stack Hub, včetně syndikace marketplace. Registrace se vyžaduje, abyste mohli testovat důležité funkce služby Azure Stack Hub, jako je syndikace marketplace a generování sestav využití. Po registraci služby Azure Stack Hub se využití hlásí do služby Azure Commerce. Zobrazí se pod předplatným, které jste použili k registraci. Uživatelům ASDK se ale neúčtují žádné využití, které nahlásí.

Pokud sadu ASDK nezaregistrujete, může se zobrazit upozornění Vyžaduje aktivaci s upozorněním, že máte sadu ASDK zaregistrovat. Jde o očekávané chování.

Požadavky

Než použijete tyto pokyny k registraci sady ASDK v Azure, ujistěte se, že jste nainstalovali Azure Stack Hub PowerShell a stáhli si nástroje Azure Stack Hub, jak je popsáno v článku o konfiguraci po nasazení .

Na počítači použitém k registraci sady ASDK v Azure musí být také nastavený režim jazyka PowerShell na FullLanguage . Pokud chcete ověřit, že je aktuální režim jazyka nastavený na plný, otevřete okno PowerShellu se zvýšenými oprávněními a spusťte následující příkazy PowerShellu:

$ExecutionContext.SessionState.LanguageMode

Ujistěte se, že výstup vrací fulllanguage. Pokud se vrátí jakýkoli jiný jazykový režim, je nutné před pokračováním spustit registraci na jiném počítači nebo jazykový režim nastavit na FullLanguage .

Účet Microsoft Entra použitý k registraci musí mít přístup k předplatnému Azure a oprávnění k vytváření aplikací identit a instančních objektů v adresáři přidruženém k ho předplatnému. Doporučujeme zaregistrovat službu Azure Stack Hub v Azure tak, že vytvoříte účet služby, který se použije k registraci , a ne pomocí přihlašovacích údajů globálního správce.

Registrace ASDK

Pokud chcete sadu ASDK zaregistrovat v Azure, postupujte podle těchto kroků.

Poznámka

Všechny tyto kroky se musí spustit z počítače, který má přístup k privilegovanému koncovému bodu. V případě asdk je to hostitelský počítač asdk.

Moduly Az
Moduly AzureRM

Otevřete příkazový řádek PowerShellu se zvýšenými oprávněními.

Spuštěním následujících rutin PowerShellu zaregistrujte instalaci sady ASDK v Azure. Přihlaste se k ID předplatného pro fakturaci Azure i k místní instalaci ASDK. Pokud ještě nemáte ID předplatného pro fakturaci Azure, můžete si zde vytvořit bezplatný účet Azure. S registrací služby Azure Stack Hub se za předplatné Azure neúčtují žádné poplatky.

Při spuštění rutiny Set-AzsRegistration nastavte jedinečný název registrace. Parametr RegistrationName má výchozí hodnotu AzureStackRegistration. Pokud ale použijete stejný název ve více instancích služby Azure Stack Hub, skript selže.

# 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

Po dokončení skriptu by se měla zobrazit tato zpráva: Vaše prostředí je teď zaregistrované a aktivované pomocí zadaných parametrů.

Otevřete příkazový řádek PowerShellu se zvýšenými oprávněními.

Spuštěním následujících příkazů PowerShellu zaregistrujte instalaci sady ASDK v Azure. Přihlaste se k ID předplatného pro fakturaci Azure i k místní instalaci ASDK. Pokud ještě nemáte ID předplatného pro fakturaci Azure, můžete si zde vytvořit bezplatný účet Azure. S registrací služby Azure Stack Hub se za předplatné Azure neúčtují žádné poplatky.

Při spuštění rutiny Set-AzsRegistration nastavte jedinečný název registrace. Parametr RegistrationName má výchozí hodnotu AzureStackRegistration. Pokud ale použijete stejný název ve více instancích služby Azure Stack Hub, skript selže.

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

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

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

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

# Register Azure Stack Hub
$AzureContext = Get-AzureRmContext
$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

Po dokončení skriptu by se měla zobrazit tato zpráva: Vaše prostředí je teď zaregistrované a aktivované pomocí zadaných parametrů.

Vaše prostředí je teď zaregistrované.

Registrace v odpojených prostředích

Pokud službu Azure Stack Hub registrujete v odpojené prostředí (bez připojení k internetu), musíte získat registrační token z prostředí služby Azure Stack Hub a pak tento token použít na počítači, který se může připojit k Azure, a zaregistrovat a vytvořit prostředek aktivace pro vaše prostředí ASDK.

Důležité

Než použijete tyto pokyny k registraci služby Azure Stack Hub, ujistěte se, že jste nainstalovali PowerShell pro Azure Stack Hub a stáhli si nástroje azure Stack Hub, jak je popsáno v článku konfigurace po nasazení na hostitelském počítači ASDK i na počítači s přístupem k internetu, který se používá k připojení k Azure a registraci.

Získání registračního tokenu z prostředí služby Azure Stack Hub

Na hostitelském počítači ASDK spusťte PowerShell jako správce a přejděte do složky Registration v adresáři AzureStack-Tools-az vytvořeném při stažení nástrojů služby Azure Stack Hub. Pomocí následujících příkazů PowerShellu naimportujte modul RegisterWithAzure.psm1 a pak pomocí rutiny Get-AzsRegistrationToken získejte registrační token:

Moduly Az
Moduly AzureRM

# 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

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-master\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

Uložte tento registrační token pro použití v počítači připojeném k internetu. Můžete zkopírovat soubor nebo text ze souboru vytvořeného parametrem $FilePathForRegistrationToken .

Připojení k Azure a registrace

Na počítači připojeném k internetu pomocí následujících příkazů PowerShellu naimportujte modul RegisterWithAzure.psm1 a pak pomocí rutiny Register-AzsEnvironment zaregistrujte v Azure pomocí právě vytvořeného registračního tokenu a jedinečného názvu registrace:

Moduly Az
Moduly AzureRM

# 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

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

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

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

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-master\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

Případně můžete použít rutinu Get-Content a odkazovat na soubor, který obsahuje registrační token:

Moduly Az
Moduly AzureRM

# 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

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

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

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

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-master\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

Po dokončení registrace by se měla zobrazit zpráva podobná této: Vaše prostředí služby Azure Stack Hub je teď zaregistrované v Azure.

Důležité

Nezavírejte okno PowerShellu.

Uložte registrační token a název prostředku registrace pro budoucí použití.

Načtení aktivačního klíče z prostředku registrace Azure

Stále používáte počítač připojený k internetu a stejné okno konzoly PowerShellu a načtěte aktivační klíč z registračního prostředku vytvořeného při registraci v Azure.

Aktivační klíč získáte spuštěním následujících příkazů PowerShellu. Použijte stejnou jedinečnou hodnotu názvu registrace, kterou jste zadali při registraci v Azure v předchozím kroku:

Moduly Az
Moduly AzureRM

$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

$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

Vytvoření aktivačního prostředku ve službě Azure Stack Hub

Vraťte se do prostředí služby Azure Stack Hub se souborem nebo textem z aktivačního klíče vytvořeného pomocí rutiny Get-AzsActivationKey. Spuštěním následujících příkazů PowerShellu vytvořte aktivační prostředek ve službě Azure Stack Hub pomocí tohoto aktivačního klíče:

Moduly Az
Moduly AzureRM

# 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

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-master\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

Případně můžete použít rutinu Get-Content a odkazovat na soubor, který obsahuje registrační token:

Moduly Az
Moduly AzureRM

# 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

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-master\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

Po dokončení aktivace by se měla zobrazit zpráva podobná této: Vaše prostředí dokončilo proces registrace a aktivace.

Ověření úspěšné registrace

K ověření úspěšné registrace služby Azure Stack Hub můžete použít dlaždici Správa oblastí . Tato dlaždice je dostupná na výchozím řídicím panelu na portálu pro správu.

Přihlaste se k portálu https://adminportal.local.azurestack.externalpro správu služby Azure Stack Hub.
Na řídicím panelu vyberte Správa oblastí.
Vyberte Vlastnosti. Toto okno zobrazuje stav a podrobnosti o vašem prostředí. Stav může být Zaregistrováno nebo Nezaregistrováno. Pokud se zaregistrujete, zobrazí se také ID předplatného Azure, které jste použili k registraci služby Azure Stack Hub, spolu se skupinou prostředků registrace a názvem.

Přesun prostředku registrace

Přesun registračního prostředku mezi skupinami prostředků ve stejném předplatném se podporuje. Další informace o přesunu prostředků do nové skupiny prostředků najdete v tématu Přesun prostředků do nové skupiny prostředků nebo předplatného.

Další kroky

Přidání položky Marketplace služby Azure Stack Hub

Sdílet prostřednictvím