Registe a ASDK com AzureRegister the ASDK with Azure

Pode registar a instalação do Azure Stack Development Kit (ASDK) com o Azure para descarregar itens de marketplace a partir do Azure e configurar dados de comércio reportando à 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. O registo é necessário para suportar a funcionalidade completa do Azure Stack, incluindo a sindicalização do mercado.Registration is required to support full Azure Stack functionality, including marketplace syndication. O registo é necessário para que possa testar a importante funcionalidade Azure Stack, como a sindicalização do mercado e o relatório de utilização.Registration is required to enable you to test important Azure Stack functionality like marketplace syndication and usage reporting. Depois de registar a Pilha Azure, o uso é reportado ao comércio Azure.After you register Azure Stack, usage is reported to Azure commerce. Pode vê-lo na subscrição que usou para o registo.You can see it under the subscription you used for registration. No entanto, os utilizadores da ASDK não são cobrados por qualquer utilização que relatem.However, ASDK users aren't charged for any usage they report.

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.If you don't register your ASDK, you might see an Activation Required warning alert that advises you to register your ASDK. Este comportamento é esperado.This behavior is expected.

Pré-requisitosPrerequisites

Antes de utilizar estas instruções para registar o ASDK com a Azure, certifique-se de que instalou o Azure Stack PowerShell e descarregou as ferramentas Azure Stack, conforme descrito no artigo de configuração pós-implantação.Before using these instructions to register the ASDK with Azure, ensure that you've installed the Azure Stack PowerShell and downloaded the Azure Stack tools as described in the post-deployment configuration article.

O modo linguístico PowerShell também deve ser definido para FullLanguage no computador utilizado para registar o ASDK com Azure.The PowerShell language mode must also be set to FullLanguage on the computer used to register the ASDK with Azure. Para verificar se o modo de linguagem atual está definido para o máximo, abra uma janela PowerShell elevada e execute os seguintes comandos PowerShell: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

Certifique-se de que a saída devolve FullLanguage.Ensure the output returns FullLanguage. Se algum outro modo de idioma for devolvido, o registo tem de ser executado noutro computador ou no modo de linguagem definido para FullLanguage antes de continuar.If any other language mode is returned, registration needs to be run on another computer or the language mode set to FullLanguage before continuing.

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.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. Recomendamos que registe a Azure Stack com Azure criando uma conta de serviço para usar para o registo em vez de usar credenciais de administração global.We recommend you register Azure Stack with Azure by creating a service account to use for registration rather than using global admin credentials.

Registar o ASDKRegister the ASDK

Siga estes passos para registar a ASDK com a Azure.Follow these steps to register the ASDK with Azure.

Nota

Todos estes passos devem ser executados a partir de um computador que tenha acesso ao ponto final privilegiado.All these steps must be run from a computer that has access to the privileged endpoint. Para o ASDK, este é o computador anfitrião ASDK.For the ASDK, that's the ASDK host computer.

  1. Abra uma consola PowerShell como administrador.Open a PowerShell console as an admin.

  2. Executar os seguintes comandos PowerShell para registar a sua instalação ASDK com a Azure.Run the following PowerShell commands to register your ASDK installation with Azure. Inscreva-se tanto no ID de subscrição de faturação Azure como na instalação ASDK local.Sign in to both your Azure billing Subscription ID and the local ASDK installation. Se ainda não tiver um ID de subscrição de faturação Azure, pode criar uma conta Azure gratuita aqui.If you don't have an Azure billing subscription ID yet, you can create a free Azure account here. Registar a Azure Stack não implica qualquer custo na sua subscrição Azure.Registering Azure Stack incurs no cost on your Azure subscription.

    Desagreie um nome único para a inscrição quando executar o cmdlet Set-AzsRegistration.Set a unique name for the registration when you run the Set-AzsRegistration cmdlet. O parâmetro RegistrationName tem um valor padrão de AzureStackRegistration.The RegistrationName parameter has a default value of AzureStackRegistration. No entanto, se utilizar o mesmo nome em mais de um caso de Azure Stack, o script falhará.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're using.
    Add-AzAccount -EnvironmentName "<environment name>"
    
    # Register the Azure Stack 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
    $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.When the script completes, you should see this message: Your environment is now registered and activated using the provided parameters.

O seu ambiente está agora registado

Registar-se em ambientes desligadosRegister in disconnected environments

Se estiver a registar o Azure Stack num ambiente desligado (sem conectividade com a Internet), precisa de obter um token de registo do ambiente Azure Stack 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.If you're registering Azure Stack in a disconnected environment (with no internet connectivity), you need to get a registration token from the Azure Stack 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.

Importante

Antes de utilizar estas instruções para registar o Azure Stack, certifique-se de que instalou o PowerShell para a Azure Stack e descarregou as ferramentas Azure Stack, conforme descrito no artigo de configuração pós-implantação no computador anfitrião ASDK e no computador com acesso à Internet utilizado para ligar ao Azure e registar-se.Before using these instructions to register Azure Stack, ensure that you've installed PowerShell for Azure Stack and downloaded the Azure Stack 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.

Obtenha um sinal de inscrição do ambiente Azure StackGet a registration token from the Azure Stack environment

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

Guarde este sinal de registo para utilização no computador ligado à Internet.Save this registration token for use on the internet-connected computer. Pode copiar o ficheiro ou o texto do ficheiro criado pelo $FilePathForRegistrationToken parâmetro.You can copy the file or the text from the file created by the $FilePathForRegistrationToken parameter.

Ligue-se ao Azure e registe-seConnect to Azure and register

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: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 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: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 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 o registo estiver concluído, deverá ver uma mensagem semelhante a: O seu ambiente Azure Stack está agora registado no Azure.When registration is complete, you should see a message similar to: Your Azure Stack environment is now registered with Azure.

Importante

Não feche a janela PowerShell.Do not close the PowerShell window.

Guarde o token de registo e o nome do recurso de registo para referência futura.Save the registration token and registration resource name for future reference.

Recuperar uma chave de ativação a partir do recurso de registo AzureRetrieve an activation key from the Azure registration resource

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.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.

Para obter a chave de ativação, executar os seguintes comandos PowerShell.To get the activation key, run the following PowerShell commands. Utilize o mesmo valor único de nome de registo que forneceu ao registar-se com a Azure na etapa anterior: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

Criar um recurso de ativação em Azure StackCreate an Activation Resource in Azure Stack

Regressar ao ambiente Azure Stack com o ficheiro ou texto da chave de ativação criada a partir do Get-AzsActivationKey.Return to the Azure Stack environment with the file or text from the activation key created from Get-AzsActivationKey. Executar os seguintes comandos PowerShell para criar um recurso de ativação em Azure Stack utilizando a chave de ativação:Run the following PowerShell commands to create an activation resource in Azure Stack 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

Em alternativa, pode utilizar o cmdlet Get-Content para indicar um ficheiro que contenha o seu símbolo de registo: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

Quando a ativação estiver completa, deverá ver uma mensagem semelhante a: O seu ambiente terminou o processo de registo e ativação.When activation is complete, you should see a message similar to: Your environment has finished the registration and activation process.

Verifique se o registo foi bem sucedidoVerify the registration was successful

Pode utilizar o azulejo de gestão da Região para verificar se o registo Azure Stack foi bem sucedido.You can use the Region management tile to verify that the Azure Stack registration was successful. Este azulejo está disponível no painel de instrumentos predefinido no portal do administrador.This tile is available on the default dashboard in the administrator portal.

  1. Inscreva-se no portal do administrador Azure Stack https://adminportal.local.azurestack.external .Sign in to the Azure Stack administrator portal https://adminportal.local.azurestack.external.

  2. A partir do Painel de Instrumentos, selecione Gestão da Região.From the Dashboard, select Region management.

    Azulejo de gestão da região no portal do administrador da Azure StackRegion management tile in Azure Stack administrator portal

  3. Selecione Propriedades.Select Properties. Esta lâmina mostra o estado e os detalhes do seu ambiente.This blade shows the status and details of your environment. O estado pode ser registado ou não registado.The status can be Registered or Not registered. Se registado, também mostra o ID de assinatura Azure que usou para registar o seu Azure Stack, juntamente com o grupo de recursos de registo e o nome.If registered, it also shows the Azure subscription ID that you used to register your Azure Stack, along with the registration resource group and name.

Mover um recurso de registoMove a registration resource

É suportado o movimento de um recurso de registo entre grupos de recursos ao abrigo da mesma subscrição.Moving a registration resource between resource groups under the same subscription is supported. 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.For more info on moving resources to a new resource group, see Move resources to new resource group or subscription.

Passos seguintesNext steps