Registe a ASDK com Azure

Pode registar a instalação do Azure Stack Development Kit (ASDK) com o Azure para descarregar itens de marketplace da Azure e configurar dados de comércio reportando à Microsoft. O registo é necessário para suportar a funcionalidade completa do Azure Stack Hub, incluindo a sindicalização do mercado. O registo é necessário para que possa testar a importante funcionalidade do Azure Stack Hub, como a sindicalização do mercado e o relatório de utilização. Depois de registar o Azure Stack Hub, o uso é reportado ao comércio Azure. Pode vê-lo sob a subscrição que usou para o registo. No entanto, os utilizadores da ASDK não são cobrados por qualquer utilização que reportem.

Se não registar o seu ASDK, poderá ver um alerta de aviso necessário para ativação que o aconselha a registar o seu ASDK. Este comportamento é esperado.

Pré-requisitos

Antes de utilizar estas instruções para registar o ASDK com a Azure, certifique-se de que instalou o Azure Stack Hub PowerShell e descarregou as ferramentas Azure Stack Hub, conforme descrito no artigo de configuração pós-implantação.

O modo linguagem PowerShell também deve ser definido para FullLanguage no computador utilizado para registar o ASDK com Azure. Para verificar se o modo de linguagem atual está definido para estar completo, abra uma janela PowerShell elevada e execute os seguintes comandos PowerShell:

$ExecutionContext.SessionState.LanguageMode

Certifique-se de que a saída devolve FullLanguage. Se algum outro modo de idioma for devolvido, o registo tem de ser executado noutro computador ou no modo de idioma definido para FullLanguage antes de continuar.

A conta Azure AD utilizada para o registo precisa de ter acesso à subscrição do Azure e ter permissões para criar aplicações de identidade e diretores de serviço no diretório associado a essa subscrição. Recomendamos que registe o Azure Stack Hub com o Azure criando uma conta de serviço para usar para registo em vez de usar credenciais de administração globais.

Registar o ASDK

Siga estes passos para registar a ASDK com a Azure.

Nota

Todos estes passos devem ser executados a partir de um computador que tenha acesso ao ponto final privilegiado. Para o ASDK, este é o computador anfitrião ASDK.

  1. Abra uma linha de comandos elevada do PowerShell.

  2. Executar os seguintes cmdlets PowerShell para registar a sua instalação ASDK com a Azure. Inscreva-se tanto no ID de subscrição de faturação Azure como na instalação ASDK local. Se ainda não tiver um ID de subscrição de faturação Azure, pode criar uma conta Azure gratuita aqui. Registar o Azure Stack Hub não implica qualquer custo na sua subscrição Azure.

    Desagreie um nome único para a inscrição quando executar o cmdlet Set-AzsRegistration. O parâmetro RegistrationName tem um valor padrão de AzureStackRegistration. No entanto, se utilizar o mesmo nome em mais de um caso de Azure Stack Hub, o script falhará.

    # 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. Quando o script estiver concluído, deverá ver esta mensagem: O seu ambiente está agora registado e ativado utilizando os parâmetros fornecidos.

O seu ambiente está agora registado

Registar-se em ambientes desligados

Se estiver a registar o Azure Stack Hub num ambiente desligado (sem conectividade com a Internet), precisa de obter um token de registo do ambiente Azure Stack Hub e, em seguida, usar esse token num computador que pode ligar-se ao Azure para se registar e criar um recurso de ativação para o seu ambiente ASDK.

Importante

Antes de utilizar estas instruções para registar o Azure Stack Hub, certifique-se de que instalou o PowerShell para o Azure Stack Hub e descarregou as ferramentas Azure Stack Hub, conforme descrito no artigo de pós-configuração no computador anfitrião ASDK e no computador com acesso à Internet utilizado para ligar ao Azure e registar-se.

Obtenha um sinal de inscrição do ambiente Azure Stack Hub

No computador anfitrião ASDK, inicie o PowerShell como administrador e navegue para a pasta de Registo no diretório AzureStack-Tools-az criado quando descarregou as ferramentas Azure Stack Hub. Utilize os seguintes comandos PowerShell para importar o módulo RegisterWithAzure.psm1 e, em seguida, utilize o cmdlet Get-AzsRegistrationToken para obter o token de registo:

# 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

Guarde este sinal de registo para utilização no computador ligado à Internet. Pode copiar o ficheiro ou o texto do ficheiro criado pelo $FilePathForRegistrationToken parâmetro.

Ligação para Azure e registe-se

No computador ligado à Internet, utilize os seguintes comandos PowerShell para importar o módulo RegisterWithAzure.psm1 e, em seguida, utilize o cmdlet Register-AzsEnvironment para se registar com a Azure utilizando o token de registo que acabou de criar e um nome de registo único:

# 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

Em alternativa, pode utilizar o cmdlet Get-Content para indicar um ficheiro que contenha o seu símbolo de registo:

# 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

Quando a inscrição estiver concluída, deverá ver uma mensagem semelhante a: O seu ambiente Azure Stack Hub está agora registado no Azure.

Importante

Não feche a janela PowerShell.

Guarde o token de registo e o nome do recurso de registo para referência futura.

Recuperar uma chave de ativação do recurso de registo Azure

Ainda utilizando o computador ligado à Internet e a mesma janela da consola PowerShell,recupere uma chave de ativação do recurso de registo criado quando se registou no Azure.

Para obter a chave de ativação, executar os seguintes comandos PowerShell. Utilize o mesmo valor único de nome de registo que forneceu ao registar-se com a Azure na etapa anterior:

$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

Criar um recurso de ativação no Azure Stack Hub

Regressar ao ambiente Azure Stack Hub com o ficheiro ou texto da chave de ativação criada a partir do Get-AzsActivationKey. Executar os seguintes comandos PowerShell para criar um recurso de ativação no Azure Stack Hub utilizando esta chave de ativação:

# 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

Em alternativa, pode utilizar o cmdlet Get-Content para indicar um ficheiro que contenha o seu símbolo de registo:

# 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

Quando a ativação estiver completa, deverá ver uma mensagem semelhante a: O seu ambiente terminou o processo de registo e ativação.

Verifique se o registo foi bem sucedido

Pode utilizar o azulejo de gestão da Região para verificar se o registo do Azure Stack Hub foi bem sucedido. Este azulejo está disponível no painel de instrumentos predefinido no portal do administrador.

  1. Inscreva-se no portal do administrador do Azure Stack Hub https://adminportal.local.azurestack.external .

  2. A partir do Painel de Instrumentos, selecione Gestão da Região.

    Azulejo de gestão da região em Azure Stack Hub portal

  3. Selecione Propriedades. Esta lâmina mostra o estado e detalhes do seu ambiente. O estado pode ser registado ou não registado. Se registado, também mostra o ID de subscrição Azure que usou para registar o seu Azure Stack Hub, juntamente com o grupo de recursos de registo e o nome.

Mover um recurso de registo

É suportada a deslocação de um recurso de registo entre grupos de recursos ao abrigo da mesma subscrição. Para obter mais informações sobre a mudança de recursos para um novo grupo de recursos, consulte os recursos movem-se para um novo grupo de recursos ou subscrição.

Passos seguintes