Partilhar via

Registrar o Azure Stack Hub com o Azure

  • Artigo

Registre o 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 para a Microsoft. Depois de registrar o Azure Stack Hub, o uso é relatado ao comércio do Azure e você pode vê-lo na ID de Assinatura de cobrança do Azure usada para registro.

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

Importante

O registo é necessário para suportar a funcionalidade completa do Azure Stack Hub, incluindo a oferta de itens no mercado. Você violará os termos de licenciamento do Azure Stack Hub se não se registrar ao usar o modelo de cobrança de pagamento conforme uso. Para saber mais sobre os modelos de licenciamento do Azure Stack Hub, consulte a página Como comprar.

Nota

Para registros conectados, um aplicativo Microsoft Entra e uma entidade de serviço associada são criados no diretório do Ative Directory associado ao registro. Esta entidade de serviço é utilizada para cenários do Azure Stack Hub Marketplace (para ver e transferir itens do Azure Marketplace), carregar dados de utilização (se o Relatório de Utilização estiver ativado), recolher registos de diagnóstico e suporte remoto. Remover ou alterar esse aplicativo ou entidade de serviço resulta em esses cenários não funcionando e alertas sendo gerados. Se ele for excluído, ele poderá ser recriado cancelando o registro e, em seguida, registrando novamente o Azure Stack Hub com o Azure.

Nota

A distribuição do mercado online, a coleta de logs de diagnóstico e o suporte remoto não estão disponíveis para registros desconectados. Você deve usar a distribuição de mercado offline.

Pré-requisitos

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

  • Verifique suas credenciais.
  • Defina o modo de idioma do PowerShell.
  • Instale o PowerShell para Azure Stack Hub.
  • Baixe as ferramentas do Azure Stack Hub.
  • Determine o seu modelo de faturação.
  • Determine seu nome de registro exclusivo.

Verifique as suas credenciais

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

  • A ID de assinatura de uma assinatura do Azure. Somente assinaturas de serviços compartilhados EA, CSP ou CSP são suportadas para registro. Os CSPs precisam decidir se usam uma assinatura CSP ou APSS.

    Para obter a ID, vá para o portal do Azure e selecione Todas as assinaturas gerais >de serviços>, escolha a assinatura que deseja usar na lista. Na seção Essenciais, encontre a ID da assinatura. Como prática recomendada, use assinaturas separadas para ambientes de produção e desenvolvimento ou teste.

  • A ID de assinatura de uma assinatura do Azure. Apenas as subscrições EA são suportadas para registo.

    Para obter a ID, vá para o portal do Azure e selecione Todas as assinaturas gerais >de serviços>, escolha a assinatura que deseja usar na lista. Na seção Essenciais, encontre a ID da assinatura. Como prática recomendada, use assinaturas separadas para ambientes de produção e desenvolvimento ou teste.

Nota

Atualmente, as subscrições na nuvem da Alemanha não são suportadas.

  • O nome de usuário e a senha de uma conta que é proprietária 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 o Azure Stack Hub no 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 limite o acesso à sua assinatura para registro, consulte Criar uma função de registro para o Azure Stack Hub.

  • Registrado o provedor de recursos do Azure Stack Hub (consulte a seguinte seção Registrar o Provedor de Recursos do Azure Stack Hub para obter detalhes).

O usuário que registra o Azure Stack Hub é o proprietário da entidade de serviço na ID do Microsoft Entra. Somente o usuário que registrou o Azure Stack Hub pode modificar o registro do Azure Stack Hub. Todos os outros usuários devem ser adicionados à 'Assinatura do provedor padrão' através do 'Controle de acesso (IAM)'. Se um usuário não administrador que não é proprietário da entidade de serviço de registro tentar registrar ou registrar novamente o Azure Stack Hub, ele poderá se deparar com uma resposta 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. Registrar o Azure Stack Hub não incorre em nenhum custo em sua assinatura do Azure.

Nota

Se você tiver mais de um Azure Stack Hub, uma prática recomendada é registrar cada Azure Stack Hub em sua própria assinatura. Isso torna mais fácil para você rastrear o uso.

Definir o modo de idioma do PowerShell

Para registrar com êxito o Azure Stack Hub, 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 elevada do PowerShell e execute os seguintes cmdlets do PowerShell:

$ExecutionContext.SessionState.LanguageMode

Verifique se a saída retorna FullLanguage. Se qualquer outro modo de idioma for retornado, o registro precisará ser executado em outra máquina ou o modo de idioma precisará ser definido como FullLanguage antes de continuar.

Instalar o PowerShell para o 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.

Baixe as ferramentas do Azure Stack Hub

O repositório GitHub das ferramentas do Azure Stack Hub contém módulos do PowerShell que dão suporte à funcionalidade do Azure Stack Hub, incluindo a funcionalidade de registro. Durante o processo de registro, você precisa importar e usar o módulo 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ê está usando a versão mais recente, exclua todas as versões existentes das ferramentas do Azure Stack Hub e baixe a versão mais recente do GitHub antes de se registrar no Azure.

Nota

Você também pode usar a Estação de Trabalho de Acesso ao Operador (OAW) para acessar o ponto de extremidade privilegiado (PEP), o portal do Administrador para cenários de suporte e as Ferramentas GitHub do Azure Stack Hub. Para obter mais informações, consulte Estação de Trabalho de Acesso do Operador do Azure Stack Hub.

Determinar o seu modelo de faturação

Uma implantação conectada permite que o Azure Stack Hub se conecte à Internet e ao Azure. Você também pode usar o Microsoft Entra ID ou os Serviços de Federação do Ative Directory (AD FS) como seu armazenamento de identidades e escolher entre dois modelos de cobrança: pagamento conforme o uso ou baseado em capacidade. Você especifica o modelo de faturamento mais tarde, ao executar o script de registro.

Uma implantação desconectada permite que você use o Azure Stack Hub sem uma conexão com a Internet. Com uma implantação desconectada, você fica limitado a um armazenamento de identidades do AD FS e ao modelo de cobrança baseado em capacidade. Você especifica o modelo de faturamento mais tarde, ao executar o script de registro.

Determinar o seu nome de registo 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 sua ID de Nuvem do Azure Stack Hub.

Nota

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

Para determinar a ID da Nuvem para sua implantação do Azure Stack Hub, consulte Localizar sua ID de nuvem.

Registe-se com faturação pré-paga consoante a utilização

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

Nota

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

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 PowerShell ISE como administrador e use os seguintes cmdlets do PowerShell com o parâmetro EnvironmentName definido para o tipo de assinatura apropriado do Azure (consulte 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 Connect-AzAccount . Você será solicitado a inserir suas credenciais de conta do Azure e talvez seja necessário usar a autenticação de dois fatores com base na configuração da sua conta.

    Connect-AzAccount -EnvironmentName "<environment name>"
    Parâmetro Description
    EnvironmentName O nome do ambiente de assinatura de nuvem do Azure. Os nomes de ambiente suportados são AzureCloud, AzureUSGovernment ou, se estiver a utilizar uma Subscrição do Azure da China, AzureChinaCloud.

    Nota

    Se sua sessão expirar, sua senha tiver sido alterada ou você simplesmente desejar mudar de conta, execute o seguinte cmdlet antes de entrar usando Connect-AzAccount: Remove-AzAccount-Scope Process

  3. Se tiver várias subscrições, execute o seguinte comando para selecionar a que pretende utilizar:

    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 PowerShell ISE como administrador e navegue até a pasta Registro 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. Antes de continuar, na mesma sessão do PowerShell, verifique novamente se você está conectado ao contexto correto do Azure PowerShell (caso contrário, repita as etapas 2 e 3). Esse contexto seria a conta do Azure que foi usada para registrar o provedor de recursos do Azure Stack Hub anteriormente. Na mesma sessão do PowerShell, execute o cmdlet Set-AzsRegistration :

    $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 demora 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".

Registe-se com faturação de capacidade

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

Nota

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

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 PowerShell ISE como administrador e use os seguintes cmdlets do PowerShell com o parâmetro EnvironmentName definido para o tipo de assinatura apropriado do Azure (consulte 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 Connect-AzAccount . Você será solicitado a inserir suas credenciais de conta do Azure e talvez seja necessário usar a autenticação de dois fatores com base na configuração da sua conta.

    Connect-AzAccount -Environment "<environment name>"
    Parâmetro Description
    EnvironmentName O nome do ambiente de assinatura de nuvem do Azure. Os nomes de ambiente suportados são AzureCloud, AzureUSGovernment ou, se estiver a utilizar uma Subscrição do Azure da China, AzureChinaCloud.

  3. Se tiver várias subscrições, execute o seguinte comando para selecionar a que pretende utilizar:

    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 PowerShell ISE como administrador e navegue até a pasta Registro 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. Antes de continuar, na mesma sessão do PowerShell, verifique novamente se você está conectado ao contexto correto do Azure PowerShell (caso contrário, repita as etapas 2 e 3). Este contexto é a conta do Azure que foi usada para registrar o provedor de recursos do Azure Stack Hub. Na mesma sessão do PowerShell, execute o cmdlet Set-AzsRegistration :

    $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 onde suas licenças SKU de capacidade foram compradas.

    Nota

    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.

Registe-se com faturação de capacidade

Se você estiver registrando o Azure Stack Hub em um ambiente desconectado (sem conectividade com a Internet), precisará obter um token de registro do ambiente do Azure Stack Hub. 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 do Azure Stack Hub

  1. Inicie o PowerShell ISE como administrador e navegue até a pasta Registro 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"
$YourCloudAdminCredential = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
$RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $YourCloudAdminCredential `
 -UsageReportingEnabled:$false `
 -PrivilegedEndpoint <PrivilegedEndPoint computer name> `
 -BillingModel Capacity `
 -AgreementNumber '<EA agreement number>' `
 -TokenOutputFilePath $FilePathForRegistrationToken

    Use o número do contrato EA onde suas licenças SKU de capacidade foram compradas.

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

    Gorjeta

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

  3. Salve esse token de registro para uso na máquina conectada ao Azure. Você pode copiar o arquivo ou o texto do $FilePathForRegistrationToken.

Conecte-se ao Azure e registre-se

No computador conectado à Internet, execute as mesmas etapas para importar o módulo RegisterWithAzure.psm1 e entrar no contexto correto do Azure PowerShell. Em seguida, ligue para Register-AzsEnvironment. Especifique o token de registro para registrar no Azure. Se você estiver registrando mais de uma instância do Azure Stack Hub usando a mesma ID de Assinatura do Azure, especifique um nome de registro exclusivo.

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

  1. Inicie o PowerShell ISE como administrador e navegue até a pasta Registro 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 seu token de registro.

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

  1. Inicie o PowerShell ISE como administrador e navegue até a pasta Registro 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

Nota

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

Gorjeta

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

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

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

# Open the file that contains the activation key (from Azure), copy the entire contents into your clipboard, then within your PowerShell session (that will communicate with the PEP), paste the activation key contents into a string variable, enclosed by quotation marks: 
$ActivationKey = "<paste activation key here>"
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
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>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
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, juntamente com o grupo de recursos de registro e o nome.

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

  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 registrado ou Expirado.

    Bloco de gerenciamento de região no portal do administrador do Azure Stack Hub

    Se registadas, as propriedades incluem:

    • ID da assinatura de registro: a ID da 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 o Azure Stack Hub. Selecione Todos os recursos, ative a caixa de seleção Mostrar tipos ocultos e selecione o nome do registro.

  5. Se o registo não tiver sido bem-sucedido, deve voltar a registar-se seguindo os passos aqui indicados para resolver o problema.

Como alternativa, você pode verificar se seu 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, 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 registo

Necessita de atualizar o seu registo nas seguintes circunstâncias:

  • Depois de renovar a sua subscrição anual baseada na capacidade.
  • Quando altera o seu modelo de faturação.
  • Quando sua escala muda (adicionar/remover nós) para faturamento baseado em capacidade.

Nota

Se a coleta de logs proativa estiver habilitada e você renovar ou alterar seu registro do Azure Stack Hub, deverá reativar a coleta de logs proativa. Para obter mais informações sobre a coleta proativa de logs, consulte Coleta de log de diagnóstico.

Pré-requisitos

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

Portal do administrador Parâmetro do cmdlet Notas
ID DA SUBSCRIÇÃO DE REGISTO Subscrição ID de subscrição utilizado durante o registo anterior
GRUPO DE RECURSOS DE REGISTO ResourceGroupName Grupo de recursos sob o qual existe o recurso de registo anterior
NOME DE REGISTO Nome do Registo Nome de registo utilizado durante o registo anterior

Alterar a subscrição que utiliza

Se quiser alterar a assinatura usada, primeiro execute o cmdlet Remove-AzsRegistration e, em seguida, verifique se está conectado ao contexto correto do Azure PowerShell. Em seguida, execute Set-AzsRegistration com quaisquer parâmetros alterados, incluindo <billing model>. Ao executar Remove-AzsRegistration, você deve estar conectado à assinatura usada durante o registro e usar os RegistrationName valores dos parâmetros e ResourceGroupName conforme mostrado no portal do administrador:

# select the subscription used during the registration (shown in portal)
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
# 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 aplica 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 primeiro remover o registro atual. Entre na ID de assinatura mostrada no portal do administrador e execute novamente o registro com um novo BillingModel valor, mantendo os RegistrationName valores e ResourceGroupName parâmetros iguais aos mostrados no portal do administrador:

# select the subscription used during the registration
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
# 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>'

Necessita de atualizar ou renovar o seu registo nas seguintes circunstâncias:

  • Depois de renovar a sua subscrição anual baseada na capacidade.
  • Quando altera o seu modelo de faturação.
  • Quando você dimensiona alterações (adicionar/remover nós) para faturamento baseado em capacidade.

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

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

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

$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
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 correto do Azure PowerShell 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 de registro e o nome do grupo de recursos de registro no portal do administrador:

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

Registre-se novamente usando as etapas conectadas

Se você estiver alterando seu modelo de faturamento de capacidade em um estado desconectado para faturamento de consumo em um estado conectado, registre-se novamente seguindo as etapas do modelo conectado.

Nota

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

Registre-se novamente usando etapas desconectadas

Agora você cancelou completamente o registro em um cenário desconectado e deve repetir as etapas para registrar um ambiente do Azure Stack Hub em um cenário desconectado.

Desativar ou ativar relatórios de utilização

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 uso de capacidade ou suporte a um ambiente desconectado precisam desativar o relatório de uso.

Execute os seguintes cmdlets 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:

    $YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
$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 onde suas licenças SKU de capacidade foram compradas.

    Gorjeta

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

  2. Salve esse token de registro para uso na máquina conectada do Azure. Você pode copiar o arquivo ou o texto do $FilePathForRegistrationToken.

Mover um recurso de registo

A movimentação de um recurso de registro entre grupos de recursos sob a mesma assinatura é suportada para todos os ambientes. No entanto, a movimentação de um recurso de registro entre assinaturas só é suportada para CSPs quando ambas as assinaturas são resolvidas para a mesma 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 que você adicione um bloqueio ao seu recurso de registro para evitar a exclusão acidental.

Referência de registo

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 mercado e o relatório de uso.

Para executar o cmdlet, você precisa:

  • Uma assinatura do Azure de qualquer tipo.
  • Para entrar no Azure PowerShell com uma conta que seja proprietária ou colaboradora 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 Description
PrivilegedEndpointCredential PSCredential As credenciais usadas para acessar o ponto de extremidade privilegiado. O nome de usuário está no formato AzureStackDomain\CloudAdmin.
PrivilegedEndpoint String Um console remoto do PowerShell pré-configurado que fornece recursos como coleta de logs e outras tarefas pós-implantação. Para saber mais, consulte o artigo Usando o ponto de extremidade privilegiado.
AzureContext PSObject
ResourceGroupName String
ResourceGroupLocation String
Modelo de Faturação String O modelo de faturação utilizado pela sua subscrição. Os valores permitidos para este parâmetro são: Capacity, PayAsYouUse e Development.
MarketplaceSyndicationEnabled True/False Determina se o recurso de gerenciamento de marketplace está disponível no portal. Defina como true se estiver se registrando com conectividade com a Internet. Defina como false se estiver se registrando em ambientes desconectados. Para registros desconectados, a ferramenta de distribuição offline pode ser usada para baixar itens do marketplace.
UsageReportingEnabled True/False O Azure Stack Hub relata métricas de uso por padrão. Os operadores com uso de capacidade ou suporte a um ambiente desconectado precisam desativar o relatório de uso. Os valores permitidos para este parâmetro são: True, False.
Número do Contrato String O número do contrato EA sob o qual a SKU de Capacidade para esta Pilha do Azure foi solicitada.
Nome do Registo String Defina um nome exclusivo para o registro se 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 a partir dos parâmetros de entrada.

Get-AzsRegistrationToken [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String>
    [-BillingModel] <String> [[-TokenOutputFilePath] <String>] [-UsageReportingEnabled] [[-AgreementNumber] <String>]
    [<CommonParameters>]
Parâmetro Tipo Description
PrivilegedEndpointCredential PSCredential As credenciais usadas para acessar o ponto de extremidade privilegiado. O nome de usuário está no formato AzureStackDomain\CloudAdmin.
PrivilegedEndpoint String Um console remoto do PowerShell pré-configurado que fornece recursos como coleta de logs e outras tarefas pós-implantação. Para saber mais, consulte o artigo Usando o ponto de extremidade privilegiado.
AzureContext PSObject
ResourceGroupName String
ResourceGroupLocation String
Modelo de Faturação String O modelo de faturação utilizado pela sua subscrição. Os valores permitidos para este parâmetro são: Capacidade, Personalizado e Desenvolvimento.
MarketplaceSyndicationEnabled True/False
UsageReportingEnabled True/False O Azure Stack Hub relata métricas de uso por padrão. Os operadores com uso de capacidade ou suporte a um ambiente desconectado precisam desativar o relatório de uso. Os valores permitidos para este parâmetro são: True, False.
Número do Contrato String

Falhas de registo

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 $hostNameo . Verifique o host físico e a conectividade e tente executar novamente o registro.

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

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

  • O identificador de nuvem [GUID] já está registrado. Não é permitida a reutilização de identificadores de nuvem.

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

  • Ao tentar acessar o gerenciamento do Marketplace, ocorre um erro ao tentar distribuir produtos.

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

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

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

Próximos passos

Baixar itens do marketplace do Azure