Azure Stack registration

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. Registration is required to support full Azure Stack functionality, including marketplace syndication. Registration is recommended because it enables you to test important Azure Stack functionality like marketplace syndication and usage reporting. After you register Azure Stack, usage is reported to Azure commerce. You can see it under the subscription you used for registration. However, ASDK users aren't charged for any usage they report.

If you do not register your ASDK, you might see an Activation Required warning alert that advises you to register your Azure Stack Development Kit. This behavior is expected.

Prerequisites

Before using these instructions to register the ASDK with Azure, ensure that you have installed the Azure Stack PowerShell and downloaded the Azure Stack tools as described in the post-deployment configuration article.

In addition, the PowerShell language mode must be set to FullLanguageMode on the computer used to register the ASDK with Azure. 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

Ensure the output returns FullLanguageMode. If any other language mode is returned, registration will need to be run on another computer or the language mode will need to be set to FullLanguageMode before continuing.

Register Azure Stack with Azure

Follow these steps to register the ASDK with Azure.

Note

All these steps must be run from a computer that has access to the privileged endpoint. For the ASDK, that's the development kit host computer.

  1. Open a PowerShell console as an administrator.

  2. Run the following PowerShell commands to register your ASDK installation with Azure. You will need to sign in to both your Azure subscription and the local ASDK installation. If you don’t have an Azure subscription yet, you can create a free Azure account here. Registering Azure Stack incurs no cost on your Azure subscription.

    If you are running the registration script on more than one instance of Azure Stack using the same Azure Subscription ID, set a unique name for the registration when you run the Set-AzsRegistration cmdlet. The RegistrationName parameter has a default value of AzureStackRegistration. However, if you use the same name on more than one instance of Azure Stack, the script will fail.

    # 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 "AzureCloud"
    
    # Register the Azure Stack 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 Azure Stack
    $AzureContext = Get-AzureRmContext
    $CloudAdminCred = Get-Credential -UserName AZURESTACK\CloudAdmin -Message "Enter the credentials to access the privileged endpoint."
    Set-AzsRegistration `
    -PrivilegedEndpointCredential $CloudAdminCred `
    -PrivilegedEndpoint AzS-ERCS01 `
    -BillingModel Development `
    -RegistrationName "<Unique-name>"
    
  3. When the script completes, you should see this message: Your environment is now registered and activated using the provided parameters.

    Your environment is now registered

Verify the registration was successful

Follow these steps to verify that the ASDK registration with Azure was successful.

  1. Sign in to the Azure Stack administration portal.

  2. Click Marketplace Management > Add from Azure.

  3. If you see a list of items available from Azure, your activation was successful.

Move a registration resource

Moving a registration resource between resource groups under the same subscription is supported. For more information about moving resources to a new resource group, see Move resources to new resource group or subscription.

Next steps

Add an Azure Stack marketplace item