Registrar Azure Stack Hub com o Azure

Registre Azure Stack Hub com o Azure para que você possa baixar itens do Azure Marketplace do Azure e configurar o relatório de dados de comércio de volta à Microsoft. Depois de registrar o Azure Stack Hub, o uso é relatado para o Azure Commerce e você pode vê-lo sob a ID de assinatura de cobrança do Azure usada para o registro.

As informações neste artigo descrevem o registro de sistemas integrados de Hub Azure Stack com o Azure. Para obter informações sobre como registrar o ASDK com o Azure, consulte Azure Stack registro de Hub na documentação do ASDK.

Importante

O registro é necessário para dar suporte total à funcionalidade do Azure Stack Hub, incluindo itens de oferta no Marketplace. Você estará violando os termos de licenciamento do Azure Stack Hub se não se registrar ao usar o modelo de cobrança pago conforme o uso. Para saber mais sobre os modelos de licenciamento de Hub Azure Stack, consulte a página como comprar.

Pré-requisitos

Conclua as seguintes seções de pré-requisitos antes de se registrar:

  • Verificar suas credenciais.
  • Definir o modo de linguagem do PowerShell.
  • Instalar o PowerShell para Azure Stack Hub.
  • Baixar as ferramentas do Azure Stack Hub.
  • Determinar seu modelo de cobrança.
  • Determinar seu nome de registro exclusivo.

Verificar suas credenciais

Antes de registrar o Azure Stack Hub com o Azure, você deve ter:

  • A ID da assinatura para uma assinatura do Azure. Somente as assinaturas EA, CSP ou serviços compartilhados CSP têm suporte para registro. Os CSPs precisam decidir se devem usar uma assinatura CSP ou APSS.

    Para obter a ID, vá para o portal do Azure e selecione todos os Serviços > assinaturas gerais, escolha a assinatura que você deseja usar na lista. Na seção Essentials , localize a ID da assinatura. Como melhor prática, use assinaturas separadas para ambientes de produção e desenvolvimento ou teste.
  • A ID da assinatura para uma assinatura do Azure. Somente as assinaturas EA têm suporte para registro.

    Para obter a ID, vá para o portal do Azure e selecione todos os Serviços > assinaturas gerais, escolha a assinatura que você deseja usar na lista. Na seção Essentials , localize a ID da assinatura. Como melhor prática, use assinaturas separadas para ambientes de produção e desenvolvimento ou teste.

Observação

Atualmente, não há suporte para as assinaturas da nuvem da Alemanha.

  • O nome de usuário e a senha de uma conta que seja um proprietário da assinatura.

  • A conta de usuário precisa ter acesso à assinatura do Azure e ter permissões para criar aplicativos de identidade e entidades de serviço no diretório associado a essa assinatura. Recomendamos que você registre Azure Stack Hub com o Azure usando a administração de privilégios mínimos. Para obter mais informações sobre como criar uma definição de função personalizada que limita o acesso à sua assinatura para registro, consulte criar uma função de registro para Azure Stack Hub.

  • Registrado o provedor de recursos do hub de Azure Stack (consulte a seção registrar Azure Stack provedor de recursos do hub a seguir para obter detalhes).

Após o registro, a permissão de administrador global do Azure AD (Azure Active Directory) não é necessária. No entanto, algumas operações podem exigir a credencial de administrador global (por exemplo, um script do instalador do provedor de recursos ou um novo recurso que exija uma permissão a ser concedida). Você pode reabilitar temporariamente as permissões de administrador global da conta ou usar uma conta de administrador global separada que seja proprietária da assinatura do provedor padrão.

O usuário que registra o Azure Stack Hub é o proprietário da entidade de serviço no Azure AD. Somente o usuário que registrou o Azure Stack Hub pode modificar o registro do Azure Stack Hub. Todos os outros usuários, mesmo que sejam um administrador global, precisarão ser adicionados à ' assinatura do provedor padrão ' por meio de ' controle de acesso (IAM) '. Se um usuário não administrador que não é um proprietário da entidade de serviço de registro tentar registrar ou registrar novamente o Azure Stack Hub, ele poderá receber uma resposta de 403. Uma resposta 403 indica que o usuário não tem permissões suficientes para concluir a operação.

Se você não tiver uma assinatura do Azure que atenda a esses requisitos, poderá criar uma conta gratuita do Azure aqui. O registro de Azure Stack Hub não provoca nenhum custo na sua assinatura do Azure.

Observação

Se você tiver mais de um Azure Stack Hub, a melhor prática será registrar cada Azure Stack Hub em sua própria assinatura. Isso torna mais fácil para você acompanhar o uso.

Definir o modo de linguagem do PowerShell

Para registrar Azure Stack Hub com êxito, o modo de linguagem do PowerShell deve ser definido como FullLanguage. Para verificar se o modo de idioma atual está definido como completo, abra uma janela do PowerShell com privilégios elevados e execute os seguintes cmdlets do PowerShell:

$ExecutionContext.SessionState.LanguageMode

Verifique se a saída retorna FullLanguage. Se qualquer outro modo de linguagem for retornado, o registro precisa ser executado em outro computador ou o modo de idioma precisa ser definido como FullLanguage antes de continuar.

Instalar o PowerShell para Azure Stack Hub

Use o PowerShell mais recente para o Azure Stack Hub para se registrar no Azure.

Se a versão mais recente ainda não estiver instalada, consulte instalar o PowerShell para Azure Stack Hub.

Baixar as ferramentas do Azure Stack Hub

O repositório GitHub de ferramentas do Azure Stack Hub contém módulos do PowerShell que dão suporte à funcionalidade do Azure Stack Hub, incluindo funcionalidade de registro. Durante o processo de registro, você precisa importar e usar o módulo do PowerShell RegisterWithAzure.psm1 (encontrado no repositório de ferramentas do Azure Stack Hub) para registrar sua instância do Azure Stack Hub com o Azure.

para garantir que você esteja usando a versão mais recente, exclua todas as versões existentes das ferramentas de Hub de Azure Stack e baixe a versão mais recente de GitHub antes de se registrar no Azure.

Observação

você também pode usar a estação de trabalho de acesso do operador (OAW) para acessar o ponto de extremidade privilegiado (PEP), o portal do administrador para cenários de suporte e as ferramentas de GitHub do Hub Azure Stack. Para obter mais informações, consulte Azure Stack estação de trabalho acesso de operador de Hub.

Determinar seu modelo de cobrança

Uma implantação conectada permite que o Azure Stack Hub se conecte à Internet e ao Azure. Você também pode usar o Azure AD ou os Serviços de Federação do Active Directory (AD FS) como seu armazenamento de identidade e escolher entre dois modelos de cobrança: pago conforme o uso ou com base na capacidade. Você especifica o modelo de cobrança mais tarde, enquanto executa o script de registro.

Uma implantação desconectada permite que você use Azure Stack Hub sem uma conexão com a Internet. Com uma implantação desconectada, você está limitado a um repositório de identidades AD FS e ao modelo de cobrança baseado em capacidade. Você especifica o modelo de cobrança mais tarde, enquanto executa o script de registro.

Determinar seu nome de registro exclusivo

Ao executar o script de registro, você deve fornecer um nome de registro exclusivo. Uma maneira fácil de associar sua assinatura do Azure Stack Hub a um registro do Azure é usar a ID de nuvem do Azure Stack Hub.

Observação

Azure Stack registros de Hub usando o modelo de cobrança baseado em capacidade precisarão alterar o nome exclusivo ao registrar novamente depois que as assinaturas anuais expirarem, a menos que você exclua o registro expirado e registre novamente com o Azure.

Para determinar a ID de nuvem para sua implantação de Hub de Azure Stack, consulte localizar sua ID de nuvem.

Registrar-se na cobrança de pagamento conforme o uso

Use estas etapas para registrar o Azure Stack Hub com o Azure usando o modelo de cobrança de pagamento conforme o uso.

Observação

Todas essas etapas devem ser executadas em um computador que tenha acesso ao PEP (ponto de extremidade privilegiado). Para obter detalhes sobre o PEP, consulte usando o ponto de extremidade privilegiado no Hub Azure Stack.

Os ambientes conectados podem acessar a Internet e o Azure. Para esses ambientes, você precisa registrar o provedor de recursos do Azure Stack Hub com o Azure e, em seguida, configurar seu modelo de cobrança.

  1. Para registrar o provedor de recursos do Azure Stack Hub com o Azure, inicie o ISE do PowerShell como administrador e use os seguintes cmdlets do PowerShell com o parâmetro EnvironmentName definido como o tipo de assinatura do Azure apropriado (confira os parâmetros abaixo).

  2. Adicione a conta do Azure que você usou para registrar o Azure Stack Hub. para adicionar a conta, execute o cmdlet Conexão-AzAccount . Você será solicitado a inserir suas credenciais de conta do Azure e talvez precise usar a autenticação de dois fatores com base na configuração da sua conta.

    Connect-AzAccount -EnvironmentName "<environment name>"
    
    Parâmetro Descrição
    EnvironmentName O nome do ambiente de assinatura de nuvem do Azure. Os nomes de ambiente com suporte são AzureCloud, AzureUSGovernmentou, se estiver usando uma assinatura do Azure na China, AzureChinaCloud.

    Observação

    se sua sessão expirar, sua senha foi alterada ou você simplesmente deseja alternar contas, execute o seguinte cmdlet antes de entrar usando Conexão-AzAccount:Remove-AzAccount-Scope Process

  3. Se você tiver várias assinaturas, execute o seguinte comando para selecionar aquela que deseja usar:

    Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription
    
  4. Execute o seguinte comando para registrar o provedor de recursos do Azure Stack Hub em sua assinatura do Azure:

    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
    
  5. Inicie o ISE do PowerShell como administrador e navegue até a pasta Registration no diretório AzureStack-Tools-az criado quando você baixou as ferramentas do Azure Stack Hub. Importe o módulo RegisterWithAzure.psm1 usando o PowerShell:

    Import-Module .\RegisterWithAzure.psm1
    
  6. Em seguida, na mesma sessão do PowerShell, verifique se você está conectado ao contexto do Azure PowerShell correto. Esse contexto seria a conta do Azure que foi usada para registrar o provedor de recursos do Azure Stack Hub anteriormente. PowerShell a ser executado:

    Connect-AzAccount -Environment "<environment name>"
    
    Parâmetro Descrição
    EnvironmentName O nome do ambiente de assinatura de nuvem do Azure. Os nomes de ambiente com suporte são AzureCloud, AzureUSGovernmentou, se estiver usando uma assinatura do Azure na China, AzureChinaCloud.
  7. Na mesma sessão do PowerShell, execute o cmdlet Set-AzsRegistration. PowerShell a ser executado:

    $CloudAdminCred = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
    $RegistrationName = "<unique-registration-name>"
    Set-AzsRegistration `
       -PrivilegedEndpointCredential $CloudAdminCred `
       -PrivilegedEndpoint <PrivilegedEndPoint computer name> `
       -BillingModel PayAsYouUse `
       -RegistrationName $RegistrationName
    

    Para obter mais informações sobre o cmdlet Set-AzsRegistration, consulte referência de registro.

O processo leva entre 10 e 15 minutos. Quando o comando for concluído, você verá a mensagem "seu ambiente agora está registrado e ativado usando os parâmetros fornecidos".

Registrar com a cobrança de capacidade

Use estas etapas para registrar o Azure Stack Hub com o Azure usando o modelo de cobrança de capacidade.

Observação

Todas essas etapas devem ser executadas em um computador que tenha acesso ao PEP (ponto de extremidade privilegiado). Para obter detalhes sobre o PEP, consulte usando o ponto de extremidade privilegiado no Hub Azure Stack.

Os ambientes conectados podem acessar a Internet e o Azure. Para esses ambientes, você precisa registrar o provedor de recursos do Azure Stack Hub com o Azure e, em seguida, configurar seu modelo de cobrança.

  1. Para registrar o provedor de recursos do Azure Stack Hub com o Azure, inicie o ISE do PowerShell como administrador e use os seguintes cmdlets do PowerShell com o parâmetro EnvironmentName definido como o tipo de assinatura do Azure apropriado (confira os parâmetros abaixo).

  2. Adicione a conta do Azure que você usou para registrar o Azure Stack Hub. para adicionar a conta, execute o cmdlet Conexão-AzAccount . Você será solicitado a inserir suas credenciais de conta do Azure e talvez precise usar a autenticação de dois fatores com base na configuração da sua conta.

    Connect-AzAccount -Environment "<environment name>"
    
    Parâmetro Descrição
    EnvironmentName O nome do ambiente de assinatura de nuvem do Azure. Os nomes de ambiente com suporte são AzureCloud, AzureUSGovernmentou, se estiver usando uma assinatura do Azure na China, AzureChinaCloud.
  3. Se você tiver várias assinaturas, execute o seguinte comando para selecionar aquela que deseja usar:

    Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription
    
  4. Execute o seguinte comando para registrar o provedor de recursos do Azure Stack Hub em sua assinatura do Azure:

    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
    
  5. Inicie o ISE do PowerShell como administrador e navegue até a pasta Registration no diretório AzureStack-Tools-az criado quando você baixou as ferramentas do Azure Stack Hub. Importe o módulo RegisterWithAzure.psm1 usando o PowerShell:

    $CloudAdminCred = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
    $RegistrationName = "<unique-registration-name>"
    Set-AzsRegistration `
       -PrivilegedEndpointCredential $CloudAdminCred `
       -PrivilegedEndpoint <PrivilegedEndPoint computer name> `
       -AgreementNumber <EA agreement number> `
       -BillingModel Capacity `
       -RegistrationName $RegistrationName
    

    Use o número do contrato ea em que suas licenças de SKU de capacidade foram adquiridas.

    Observação

    Você pode desabilitar o relatório de uso com o parâmetro UsageReportingEnabled para o cmdlet set-AzsRegistration definindo o parâmetro como false.

    Para obter mais informações sobre o cmdlet Set-AzsRegistration, consulte referência de registro.

Registrar com a cobrança de capacidade

Se estiver registrando Azure Stack Hub em um ambiente desconectado (sem conectividade com a Internet), você precisará obter um token de registro do ambiente de Hub de Azure Stack. Em seguida, use esse token em um computador que possa se conectar ao Azure e tenha o PowerShell para Azure Stack Hub instalado.

Obter um token de registro do ambiente de Hub de Azure Stack

  1. Inicie o ISE do PowerShell como administrador e navegue até a pasta Registration no diretório AzureStack-Tools-az criado quando você baixou as ferramentas do Azure Stack Hub. Importe o módulo RegisterWithAzure. psm1 :

    Import-Module .\RegisterWithAzure.psm1
    
  2. Para obter o token de registro, execute os seguintes cmdlets do PowerShell:

    $FilePathForRegistrationToken = "$env:SystemDrive\RegistrationToken.txt"
    $RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $YourCloudAdminCredential -UsageReportingEnabled:$false -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel Capacity -AgreementNumber '<EA agreement number>' -TokenOutputFilePath $FilePathForRegistrationToken
    

    Use o número do contrato ea em que suas licenças de SKU de capacidade foram adquiridas.

    Para obter mais informações sobre o cmdlet Get-AzsRegistrationToken, consulte referência de registro.

    Dica

    O token de registro é salvo no arquivo especificado para $FilePathForRegistrationToken. Você pode alterar o filePath ou o nome de arquivo de acordo com seu critério.

  3. Salve esse token de registro para uso no computador conectado ao Azure. Você pode copiar o arquivo ou o texto de $FilePathForRegistrationToken.

Conexão para o Azure e registrar

no computador que está conectado à internet, execute as mesmas etapas para importar o módulo RegisterWithAzure. psm1 e entre no contexto de Azure PowerShell correto. Em seguida, chame Register-AzsEnvironment. Especifique o token de registro a ser registrado no Azure. Se você estiver registrando mais de uma instância do hub de Azure Stack usando a mesma ID de assinatura do Azure, especifique um nome de registro exclusivo.

Você precisa do token de registro e de um nome de token exclusivo.

  1. Inicie o ISE do PowerShell como administrador e navegue até a pasta Registration no diretório AzureStack-Tools-az criado quando você baixou as ferramentas do Azure Stack Hub. Importe o módulo RegisterWithAzure. psm1 :

    Import-Module .\RegisterWithAzure.psm1
    
  2. Em seguida, execute os seguintes cmdlets do PowerShell:

    $RegistrationToken = "<Your Registration Token>"
    $RegistrationName = "<unique-registration-name>"
    Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName
    

Opcionalmente, você pode usar o cmdlet Get-Content para apontar para um arquivo que contém o token de registro.

Você precisa do token de registro e de um nome de token exclusivo.

  1. Inicie o ISE do PowerShell como administrador e navegue até a pasta Registration no diretório AzureStack-Tools-az criado quando você baixou as ferramentas do Azure Stack Hub. Importe o módulo RegisterWithAzure. psm1 :

    Import-Module .\RegisterWithAzure.psm1
    
  2. Em seguida, execute os seguintes cmdlets do PowerShell:

    $RegistrationToken = Get-Content -Path '<Path>\<Registration Token File>'
    Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName
    

Observação

Salve o nome do recurso de registro e o token de registro para referência futura.

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

Em seguida, você precisa recuperar uma chave de ativação do recurso de registro criado no Azure durante o Register-AzsEnvironment.

Para obter a chave de ativação, execute os seguintes cmdlets do PowerShell:

$RegistrationResourceName = "<unique-registration-name>"
$KeyOutputFilePath = "$env:SystemDrive\ActivationKey.txt"
$ActivationKey = Get-AzsActivationKey -RegistrationName $RegistrationResourceName -KeyOutputFilePath $KeyOutputFilePath

Dica

A chave de ativação é salva no arquivo especificado para $KeyOutputFilePath. Você pode alterar o filePath ou o nome de arquivo de acordo com seu critério.

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

Retorne ao ambiente de Hub de Azure Stack com o arquivo ou o texto da chave de ativação criada em Get-AzsActivationKey. Em seguida, crie um recurso de ativação no Hub Azure Stack usando essa chave de ativação. Para criar um recurso de ativação, execute os seguintes cmdlets do PowerShell:

$ActivationKey = "<activation key>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey

Opcionalmente, você pode usar o cmdlet Get-Content para apontar para um arquivo que contém seu token de registro:

$ActivationKey = Get-Content -Path '<Path>\<Activation Key File>'
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey

Verificar o registro do Azure Stack Hub

Você pode usar o bloco Gerenciamento de região para verificar se o registro do Azure Stack Hub foi bem-sucedido. Esse bloco está disponível no painel padrão no portal do administrador. O status pode ser registrado ou não registrado. Se registrado, ele também mostra a ID de assinatura do Azure que você usou para registrar seu Azure Stack Hub junto com o grupo de recursos de registro e o nome.

  1. Entre no portal de administrador do Azure Stack Hub https://adminportal.local.azurestack.external.

  2. No painel, selecione Gerenciamento de região.

  3. Selecione Propriedades. Essa folha mostra o status e os detalhes do seu ambiente. O status pode ser registrado, não registradoou expirado.

    Region management tile in Azure Stack Hub administrator portal

    Se registrado, as propriedades incluem:

    • ID de assinatura de registro: a ID de assinatura do Azure registrada e associada ao Azure Stack Hub.
    • Grupo de recursos de registro: o grupo de recursos do Azure na assinatura associada que contém os recursos do Azure Stack Hub.
  4. Você pode usar o portal do Azure para exibir os recursos de registro do Azure Stack Hub e verificar se o registro foi bem-sucedido. Entre no portal do Azure usando uma conta associada à assinatura que você usou para registrar Azure Stack Hub. Selecione Todos os recursos, habilite a caixa de seleção Mostrar tipos ocultos e selecione o nome do registro.

  5. Se o registro não tiver sido malsucedido, você deverá registrar novamente seguindo as etapas aqui para resolver o problema.

Como alternativa, você pode verificar se o registro foi bem-sucedido usando o recurso de gerenciamento do Marketplace. Se você vir uma lista de itens do Marketplace na folha de gerenciamento do Marketplace, isso significará que seu registro foi bem-sucedido. No entanto, em ambientes desconectados, você não pode ver itens do Marketplace no gerenciamento do Marketplace.

Renovar ou alterar o registro

Você precisa atualizar seu registro nas seguintes circunstâncias:

  • Depois de renovar sua assinatura anual baseada em capacidade.
  • Quando você altera seu modelo de cobrança.
  • Quando você dimensiona as alterações (adicionar/remover nós) para a cobrança baseada em capacidade.

Pré-requisitos

Você precisa das seguintes informações do portal do administrador para renovar ou alterar o registro:

Portal do administrador Parâmetro de cmdlet Observações
ID DA ASSINATURA DE REGISTRO Subscription ID da assinatura usada durante o registro anterior
GRUPO DE RECURSOS DE REGISTRO ResourceGroupName Grupo de recursos no qual existe o recurso de registro anterior
NOME DE REGISTRO RegistrationName Nome de registro usado durante o registro anterior

Alterar a assinatura que você usa

Se você quiser alterar a assinatura usada, deverá primeiro executar o cmdlet Remove-AzsRegistration e, em seguida, verificar se está conectado ao contexto de Azure PowerShell correto. Em seguida, execute set-AzsRegistration com quaisquer parâmetros alterados, incluindo . Ao executar Remove-AzsRegistration, você deve estar conectado à assinatura usada durante os valores de registro e de uso dos parâmetros e ResourceGroupName , conforme mostrado no ResourceGroupName:

# select the subscription used during the registration (shown in portal)
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
# unregister using the parameter values from portal
Remove-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'
# switch to new subscription id
Select-AzSubscription -Subscription '<New subscription ID>'
# register
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<Billing model>' -RegistrationName '<Registration name>' -ResourceGroupName '<Registration resource group name>'

Alterar o modelo de cobrança, como os recursos são oferecidos ou registrar novamente sua instância

Esta seção se aplicará se você quiser alterar o modelo de cobrança, como os recursos são oferecidos ou se quiser registrar novamente sua instância. Para todos esses casos, você chama a função de registro para definir os novos valores. Você não precisa remover primeiro o registro atual. Entre na ID da assinatura mostrada no portal do administradore execute novamente o registro com um novo valor, mantendo os RegistrationName valores de parâmetros e os ResourceGroupName mesmos, conforme mostrado no RegistrationName:

# select the subscription used during the registration
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
# rerun registration with new BillingModel (or same billing model in case of re-registration) but using other parameters values from portal
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<New billing model>' -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'

Você precisa atualizar ou renovar seu registro nas seguintes circunstâncias:

  • Depois de renovar sua assinatura anual baseada em capacidade.
  • Quando você altera seu modelo de cobrança.
  • Quando você dimensiona as alterações (adicionar/remover nós) para a cobrança baseada em capacidade.

Remover o recurso de ativação do Hub Azure Stack

Primeiro, você precisa remover o recurso de ativação do Hub Azure Stack e, em seguida, o recurso de registro no Azure.

Para remover o recurso de ativação no Hub Azure Stack, execute os seguintes cmdlets do PowerShell em seu ambiente de Hub de Azure Stack:

Remove-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint

em seguida, para remover o recurso de registro no azure, verifique se você está em um computador conectado ao Azure, entre no contexto de Azure PowerShell correto e execute os cmdlets do PowerShell apropriados, conforme descrito abaixo.

Você pode usar o token de registro usado para criar o recurso:

$RegistrationToken = "<registration token>"
Unregister-AzsEnvironment -RegistrationToken $RegistrationToken

Ou você pode usar o nome do registro e do grupo de recursos de registro no portal do administrador:

Unregister-AzsEnvironment -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'

Registrar novamente usando etapas conectadas

Se você alterar seu modelo de cobrança da cobrança de capacidade em um estado desconectado para a cobrança de consumo em um estado conectado, você registrará novamente as etapas de modelo conectadasa seguir.

Observação

Isso não altera seu modelo de identidade, apenas o mecanismo de cobrança e você ainda usará AD FS como sua fonte de identidade.

Registrar novamente usando etapas desconectadas

Você agora não se registrou completamente em um cenário desconectado e deve repetir as etapas para registrar um ambiente de Hub de Azure Stack em um cenário desconectado.

Desabilitar ou habilitar relatório de uso

Para ambientes do Azure Stack Hub que usam um modelo de cobrança de capacidade, desative o relatório de uso com o parâmetro UsageReportingEnabled usando os cmdlets Set-AzsRegistration ou Get-AzsRegistrationToken. O Azure Stack Hub relata métricas de uso por padrão. Os operadores com capacidade que usam ou dão suporte a um ambiente desconectado precisam desativar os relatórios de uso.

Execute o seguinte comando do PowerShell:

$CloudAdminCred = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
$RegistrationName = "<unique-registration-name>"
Set-AzsRegistration `
   -PrivilegedEndpointCredential $CloudAdminCred `
   -PrivilegedEndpoint <PrivilegedEndPoint computer name> `
   -BillingModel Capacity
   -RegistrationName $RegistrationName
   -UsageReportingEnabled:$false
  1. Para alterar o token de registro, execute os seguintes cmdlets do PowerShell:

    $FilePathForRegistrationToken = $env:SystemDrive\RegistrationToken.txt
    $RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $YourCloudAdminCredential -UsageReportingEnabled:$false -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel Capacity -AgreementNumber '<EA agreement number>' -TokenOutputFilePath $FilePathForRegistrationToken
    

    Use o número do contrato EA em que suas licenças de SKU de capacidade foram adquiridas.

    Dica

    O token de registro é salvo no arquivo especificado para $FilePathForRegistrationToken. Você pode alterar o caminho do arquivo ou o nome do arquivo a seu critério.

  2. Salve esse token de registro para uso no computador conectado do Azure. Você pode copiar o arquivo ou o texto de $FilePathForRegistrationToken.

Mover um recurso de registro

Há suporte para mover um recurso de registro entre grupos de recursos na mesma assinatura em todos os ambientes. No entanto, a movimentação de um recurso de registro entre assinaturas só tem suporte para CSPs quando ambas as assinaturas são resolvidas para o mesmo ID de Parceiro. Para obter mais informações sobre como mover recursos para um novo grupo de recursos, consulte Mover recursos para um novo grupo de recursos ou assinatura.

Importante

Para evitar a exclusão acidental de recursos de registro no portal, o script de registro adiciona automaticamente um bloqueio ao recurso. Você deve remover esse bloqueio antes de movê-lo ou excluí-lo. É recomendável adicionar um bloqueio ao recurso de registro para evitar a exclusão acidental.

Referência de registro

Set-AzsRegistration

Você pode usar Set-AzsRegistration para registrar o Azure Stack Hub com o Azure e habilitar ou desabilitar a oferta de itens no marketplace e relatórios de uso.

Para executar o cmdlet, você precisa de:

  • Uma assinatura global do Azure de qualquer tipo.
  • Para entrar no Azure PowerShell com uma conta que seja um proprietário ou colaborador dessa assinatura.
Set-AzsRegistration [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String> [[-AzureContext]
    <PSObject>] [[-ResourceGroupName] <String>] [[-ResourceGroupLocation] <String>] [[-BillingModel] <String>]
    [-MarketplaceSyndicationEnabled] [-UsageReportingEnabled] [[-AgreementNumber] <String>] [[-RegistrationName]
    <String>] [<CommonParameters>]
Parâmetro Tipo Descrição
PrivilegedEndpointCredential PSCredential As credenciais usadas para acessar o ponto de extremidade privilegiado. O nome de usuário está no formato AzureStackDomain\CloudAdmin.
PrivilegedEndpoint Cadeia de caracteres Um console do PowerShell remoto pré-configurado que fornece recursos como coleta de log e outras tarefas pós-implantação. Para saber mais, consulte o artigo usando o ponto de extremidade privilegiado.
AzureContext PSObject
ResourceGroupName Cadeia de caracteres
ResourceGroupLocation String
BillingModel Cadeia de caracteres O modelo de cobrança que sua assinatura usa. Os valores permitidos para esse parâmetro são: Capacidade, PayAsYouUse e Desenvolvimento.
MarketplaceSyndicationEnabled Verdadeiro/Falso Determina se o recurso de gerenciamento do marketplace está disponível no portal. Definido como true se estiver registrando com conectividade com a Internet. Definido como false se estiver registrando em ambientes desconectados. Para registros desconectados, a ferramenta de sindicalação offline pode ser usada para baixar itens do marketplace.
UsageReportingEnabled Verdadeiro/Falso O Azure Stack Hub relata métricas de uso por padrão. Os operadores com capacidade que usam ou dão suporte a um ambiente desconectado precisam desativar os relatórios de uso. Os valores permitidos para esse parâmetro são: True, False.
AgreementNumber Cadeia de caracteres O número do contrato de EA sob o qual a SKU de Capacidade para este Azure Stack foi ordenada.
RegistrationName Cadeia de caracteres Descrição de um nome exclusivo para o registro se você estiver executando o script de registro em mais de uma instância do Azure Stack Hub usando a mesma ID de Assinatura do Azure. O parâmetro tem um valor padrão de AzureStackRegistration. No entanto, se você usar o mesmo nome em mais de uma instância do Azure Stack Hub, o script falhará.

Get-AzsRegistrationToken

Get-AzsRegistrationToken gera um token de registro dos parâmetros de entrada.

Get-AzsRegistrationToken [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String>
    [-BillingModel] <String> [[-TokenOutputFilePath] <String>] [-UsageReportingEnabled] [[-AgreementNumber] <String>]
    [<CommonParameters>]
Parâmetro Tipo Descrição
PrivilegedEndpointCredential PSCredential As credenciais usadas para acessar o ponto de extremidade privilegiado. O nome de usuário está no formato AzureStackDomain\CloudAdmin.
PrivilegedEndpoint Cadeia de caracteres Um console do PowerShell remoto pré-configurado que fornece recursos como coleta de log e outras tarefas pós-implantação. Para saber mais, consulte o artigo usando o ponto de extremidade privilegiado.
AzureContext PSObject
ResourceGroupName String
ResourceGroupLocation Cadeia de caracteres
BillingModel Cadeia de caracteres O modelo de cobrança que sua assinatura usa. Os valores permitidos para esse parâmetro são: Capacidade, PayAsYouUse e Desenvolvimento.
MarketplaceSyndicationEnabled Verdadeiro/Falso
UsageReportingEnabled Verdadeiro/Falso O Azure Stack Hub relata métricas de uso por padrão. Os operadores com capacidade que usam ou dão suporte a um ambiente desconectado precisam desativar os relatórios de uso. Os valores permitidos para esse parâmetro são: True, False.
AgreementNumber Cadeia de caracteres

Falhas de registro

Você pode ver um dos erros abaixo ao tentar registrar seu Azure Stack Hub:

  • Não foi possível recuperar informações de hardware obrigatórias para $hostName . Verifique o host físico e a conectividade e tente realizar o registro novamente.

  • Não é possível se conectar $hostName ao para obter informações de hardware. Verifique o host físico e a conectividade e tente realizar o registro novamente.

    Causa: isso normalmente ocorre porque tentamos obter detalhes de hardware como UUID, Bios e CPU dos hosts para tentar a ativação e não conseguimos fazer isso devido à incapacidade de se conectar ao host físico.

  • O identificador de nuvem [ GUID ] já está registrado. Não é permitido reutilizar os identificadores de nuvem.

    Causa: isso ocorrerá se o ambiente de Azure Stack já estiver registrado. Se você quiser registrar novamente seu ambiente com uma assinatura ou modelo de cobrança diferente, siga as etapas renovar ou alterar registro.

  • Ao tentar acessar o gerenciamento do Marketplace, ocorre um erro durante a tentativa de agregar produtos.

    Causa: isso geralmente ocorre quando Azure Stack Hub não consegue acessar o recurso de registro. Um motivo comum para isso é que quando um locatário de diretório de uma assinatura do Azure é alterado, ele redefine o registro. Você não poderá acessar o Marketplace do hub de Azure Stack ou o uso do relatório se tiver alterado o locatário do diretório da assinatura. Você precisa registrar novamente para corrigir esse problema.

  • O gerenciamento do Marketplace ainda solicita que você registre e ative seu hub de Azure Stack mesmo quando você já registrou seu carimbo usando o processo desconectado.

    Causa: esse é um problema conhecido para ambientes desconectados e exige que você Verifique seu status de registro. Para usar o gerenciamento do Marketplace, use a ferramenta offline.

Próximas etapas

Baixar itens do Marketplace do Azure