Registrera ASDK med AzureRegister the ASDK with Azure

Du kan registrera din Azure Stack Development Kit-installation (ASDK) med Azure för att hämta Marketplace-objekt från Azure och konfigurera Commerce Data repor ting till Microsoft.You can register your Azure Stack Development Kit (ASDK) installation with Azure to download marketplace items from Azure and to set up commerce data reporting back to Microsoft. Registrering krävs för att stödja full Azure Stack Hub-funktioner, inklusive Marketplace-syndikering.Registration is required to support full Azure Stack Hub functionality, including marketplace syndication. Registrering krävs för att du ska kunna testa viktiga Azure Stack Hub-funktioner som Marketplace-syndikering och användnings rapportering.Registration is required to enable you to test important Azure Stack Hub functionality like marketplace syndication and usage reporting. När du har registrerat Azure Stack Hub rapporteras användningen till Azure Commerce.After you register Azure Stack Hub, usage is reported to Azure commerce. Du kan se den under prenumerationen som du använde för registrering.You can see it under the subscription you used for registration. ASDK användare debiteras dock inte för någon användning som de rapporterar.However, ASDK users aren't charged for any usage they report.

Om du inte registrerar din ASDK kan du se en varning om aktivering som krävs för att registrera din ASDK.If you don't register your ASDK, you might see an Activation Required warning alert that advises you to register your ASDK. Det här beteendet är förväntat.This behavior is expected.

FörutsättningarPrerequisites

Innan du använder de här anvisningarna för att registrera ASDK med Azure måste du se till att du har installerat Azure Stack Hub PowerShell och hämtat Azure Stack Hub-verktygen enligt beskrivningen i artikeln konfiguration efter distribution .Before using these instructions to register the ASDK with Azure, ensure that you've installed the Azure Stack Hub PowerShell and downloaded the Azure Stack Hub tools as described in the post-deployment configuration article.

PowerShell-språkläget måste också anges till FullLanguage på den dator som används för att registrera ASDK med Azure.The PowerShell language mode must also be set to FullLanguage on the computer used to register the ASDK with Azure. Kontrol lera att det aktuella språk läget är inställt på full genom att öppna ett upphöjt PowerShell-fönster och köra följande PowerShell-kommandon:To verify that the current language mode is set to full, open an elevated PowerShell window and run the following PowerShell commands:

$ExecutionContext.SessionState.LanguageMode

Se till att utdata returnerar FullLanguage.Ensure the output returns FullLanguage. Om något annat språk läge returneras måste registreringen köras på en annan dator, eller så är språk läget inställt på FullLanguage innan du fortsätter.If any other language mode is returned, registration needs to be run on another computer or the language mode set to FullLanguage before continuing.

Det Azure AD-konto som används för registrering måste ha åtkomst till Azure-prenumerationen och ha behörighet att skapa identitets program och tjänstens huvud namn i den katalog som är associerad med den prenumerationen.The Azure AD account used for registration needs to have access to the Azure subscription and have permissions to create identity apps and service principals in the directory associated with that subscription. Vi rekommenderar att du registrerar Azure Stack Hub med Azure genom att skapa ett tjänst konto som ska användas för registrering i stället för att använda autentiseringsuppgifter för global administratör.We recommend you register Azure Stack Hub with Azure by creating a service account to use for registration rather than using global admin credentials.

Registrera ASDKRegister the ASDK

Följ de här stegen för att registrera ASDK med Azure.Follow these steps to register the ASDK with Azure.

Anteckning

Alla dessa steg måste köras från en dator som har åtkomst till den privilegierade slut punkten.All these steps must be run from a computer that has access to the privileged endpoint. För ASDK är det ASDK-värddatorn.For the ASDK, that's the ASDK host computer.

  1. Öppna en upphöjd PowerShell-prompt.Open an elevated PowerShell prompt.

  2. Kör följande PowerShell-cmdlets för att registrera din ASDK-installation med Azure.Run the following PowerShell cmdlets to register your ASDK installation with Azure. Logga in på både ditt prenumerations-ID för Azure-fakturering och den lokala ASDK-installationen.Sign in to both your Azure billing Subscription ID and the local ASDK installation. Om du inte har ett prenumerations-ID för Azure-fakturering ännu kan du skapa ett kostnads fritt Azure-konto här.If you don't have an Azure billing subscription ID yet, you can create a free Azure account here. När du registrerar Azure Stack Hub debiteras ingen kostnad i din Azure-prenumeration.Registering Azure Stack Hub incurs no cost on your Azure subscription.

    Ange ett unikt namn för registreringen när du kör cmdleten set-AzsRegistration .Set a unique name for the registration when you run the Set-AzsRegistration cmdlet. Parametern RegistrationName har standardvärdet AzureStackRegistration.The RegistrationName parameter has a default value of AzureStackRegistration. Men om du använder samma namn på fler än en instans av Azure Stack hubben kommer skriptet att Miss sen.However, if you use the same name on more than one instance of Azure Stack Hub, the script will fail.

    # Add the Azure cloud subscription environment name. 
    # Supported environment names are AzureCloud, AzureChinaCloud, or AzureUSGovernment depending which Azure subscription you're using.
    Add-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. När skriptet har slutförts bör du se det här meddelandet: din miljö har nu registrerats och Aktiver ATS med de angivna parametrarna.When the script completes, you should see this message: Your environment is now registered and activated using the provided parameters.

Nu har din miljö registrerats

Registrera i frånkopplade miljöerRegister in disconnected environments

Om du registrerar Azure Stack hubb i en frånkopplad miljö (utan Internet anslutning) måste du hämta en registrerings-token från Azure Stack Hub-miljön och sedan använda denna token på en dator som kan ansluta till Azure för att registrera och skapa en aktiverings resurs för din ASDK-miljö.If you're registering Azure Stack Hub in a disconnected environment (with no internet connectivity), you need to get a registration token from the Azure Stack Hub environment and then use that token on a computer that can connect to Azure to register and create an activation resource for your ASDK environment.

Viktigt

Innan du använder de här anvisningarna för att registrera Azure Stack hubb, se till att du har installerat PowerShell för Azure Stack Hub och hämtat Azure Stack Hub-verktygen enligt beskrivningen i konfigurations artikeln efter distributionen på både ASDK-värddatorn och datorn med Internet åtkomst som används för att ansluta till Azure och registrera dig.Before using these instructions to register Azure Stack Hub, ensure that you've installed PowerShell for Azure Stack Hub and downloaded the Azure Stack Hub tools as described in the post-deployment configuration article on both the ASDK host computer and the computer with internet access used to connect to Azure and register.

Hämta en registrerings-token från Azure Stack Hub-miljönGet a registration token from the Azure Stack Hub environment

Starta PowerShell som administratör på ASDK-värddatorn och navigera till mappen Registration i katalogen AzureStack-tools-AZ som skapades när du laddade ned Azure Stack Hub-verktyg.On the ASDK host computer, start PowerShell as an admin and navigate to the Registration folder in the AzureStack-Tools-az directory created when you downloaded the Azure Stack Hub tools. Använd följande PowerShell-kommandon för att importera modulen RegisterWithAzure. psm1 och Använd cmdleten Get-AzsRegistrationToken för att hämta registrerings-token:Use the following PowerShell commands to import the RegisterWithAzure.psm1 module and then use the Get-AzsRegistrationToken cmdlet to get the registration token:

# 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

Spara detta registrerings-token för användning på den Internet-anslutna datorn.Save this registration token for use on the internet-connected computer. Du kan kopiera filen eller texten från filen som skapats av $FilePathForRegistrationToken parametern.You can copy the file or the text from the file created by the $FilePathForRegistrationToken parameter.

Anslut till Azure och registrera digConnect to Azure and register

På den Internet-anslutna datorn använder du följande PowerShell-kommandon för att importera modulen RegisterWithAzure. psm1 och använder sedan cmdleten register-AzsEnvironment för att registrera dig hos Azure med den registrerings-token som du nyss skapade och ett unikt registrerings namn:On the internet-connected computer, use the following PowerShell commands to import the RegisterWithAzure.psm1 module and then use the Register-AzsEnvironment cmdlet to register with Azure using the registration token you just created and a unique registration name:

# Add the Azure cloud subscription environment name. 
# Supported environment names are AzureCloud, AzureChinaCloud or AzureUSGovernment depending which Azure subscription you are using.
Add-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

Du kan också använda cmdleten Get-Content för att peka på en fil som innehåller din registrerings-token:Alternatively, you can use the Get-Content cmdlet to point to a file that contains your registration token:

# Add the Azure cloud subscription environment name. 
# Supported environment names are AzureCloud, AzureChinaCloud or AzureUSGovernment depending which Azure subscription you are using.
Add-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

När registreringen är klar bör du se ett meddelande som liknar: din Azure Stack Hub-miljö är nu registrerad i Azure.When registration is complete, you should see a message similar to: Your Azure Stack Hub environment is now registered with Azure.

Viktigt

Stäng inte PowerShell-fönstret.Do not close the PowerShell window.

Spara registrerings-token och registrerings resurs namnet för framtida bruk.Save the registration token and registration resource name for future reference.

Hämta en aktiverings nyckel från Azure Registration ResourceRetrieve an activation key from the Azure registration resource

Om du fortfarande använder den Internet-anslutna datorn och samma PowerShell-konsol fönster, hämtar du en aktiverings nyckel från registrerings resursen som skapades när du registrerade dig för Azure.Still using the internet-connected computer, and the same PowerShell console window, retrieve an activation key from the registration resource created when you registered with Azure.

Kör följande PowerShell-kommandon för att hämta aktiverings nyckeln.To get the activation key, run the following PowerShell commands. Använd samma unika registrerings namn värde som du angav när du registrerade dig med Azure i föregående steg:Use the same unique registration name value you provided when registering with Azure in the previous step:

$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

Skapa en aktiverings resurs i Azure Stack hubbCreate an activation resource in Azure Stack Hub

Gå tillbaka till Azure Stack Hub-miljön med filen eller texten från aktiverings nyckeln som skapats från Get-AzsActivationKey.Return to the Azure Stack Hub environment with the file or text from the activation key created from Get-AzsActivationKey. Kör följande PowerShell-kommandon för att skapa en aktiverings resurs i Azure Stack hubb med den aktiverings nyckeln:Run the following PowerShell commands to create an activation resource in Azure Stack Hub using that activation key:

# 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

Du kan också använda cmdleten Get-Content för att peka på en fil som innehåller din registrerings-token:Alternatively, you can use the Get-Content cmdlet to point to a file that contains your registration token:

# 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

När aktiveringen är klar bör du se ett meddelande som liknar: din miljö har slutfört registrerings-och aktiverings processen.When activation is complete, you should see a message similar to: Your environment has finished the registration and activation process.

Verifiera att registreringen lyckadesVerify the registration was successful

Du kan använda panelen regions hantering för att kontrol lera att registreringen av Azure Stack Hub lyckades.You can use the Region management tile to verify that the Azure Stack Hub registration was successful. Den här panelen finns på standard instrument panelen på administratörs portalen.This tile is available on the default dashboard in the administrator portal.

  1. Logga in på Azure Stack Hubbs administratörs Portal https://adminportal.local.azurestack.external .Sign in to the Azure Stack Hub administrator portal https://adminportal.local.azurestack.external.

  2. Välj regions hantering på instrument panelen.From the Dashboard, select Region management.

    Panelen för region hantering i Azure Stack Hubbs administratörs PortalRegion management tile in Azure Stack Hub administrator portal

  3. Välj Egenskaper.Select Properties. Det här bladet visar status och information om din miljö.This blade shows the status and details of your environment. Status kan vara registrerad eller ej registrerad.The status can be Registered or Not registered. Om det är registrerat visas även det Azure-prenumerations-ID som du använde för att registrera Azure Stack hubb, tillsammans med den registrerade resurs gruppen och namnet.If registered, it also shows the Azure subscription ID that you used to register your Azure Stack Hub, along with the registration resource group and name.

Flytta en registrerings resursMove a registration resource

Det finns stöd för att flytta en registrerings resurs mellan resurs grupper under samma prenumeration.Moving a registration resource between resource groups under the same subscription is supported. Mer information om hur du flyttar resurser till en ny resurs grupp finns i Flytta resurser till ny resurs grupp eller prenumeration.For more info on moving resources to a new resource group, see Move resources to new resource group or subscription.

Nästa stegNext steps