Registre O Hub Azure Stack com Azure

  • Artigo
  • 27 minutos para ler

Registe o Azure Stack Hub com o Azure para que possa descarregar itens Azure Marketplace a partir do Azure e configurar dados de comércio reportando à Microsoft. Depois de registar o Azure Stack Hub, o uso é reportado ao comércio Azure e pode vê-lo sob o ID de subscrição de faturação Azure usado para o registo.

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

Importante

As inscrições são necessárias para suportar a funcionalidade completa do Azure Stack Hub, incluindo a oferta de itens no mercado. Você estará violando os termos de licenciamento do Azure Stack Hub se você não se registar ao usar o modelo de faturação pay-as-you-use. Para saber mais sobre os modelos de licenciamento do Azure Stack Hub, consulte a página como comprar.

Pré-requisitos

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

  • Verifique as suas credenciais.
  • Desa ajuste o modo linguagem PowerShell.
  • Instale powerShell para Azure Stack Hub.
  • Descarregue as ferramentas Azure Stack Hub.
  • Determina o teu modelo de faturação.
  • Determine o seu nome de registo único.

Verifique as suas credenciais

Antes de registar o Azure Stack Hub com a Azure, deve ter:

  • O ID de assinatura para uma subscrição do Azure. Apenas as assinaturas de serviços partilhados da EA, CSP ou CSP são suportadas para inscrição. Os CSPs têm de decidir se utilizam uma subscrição CSP ou APSS.

    Para obter o ID, vá ao portal do Azure e selecione Todos os serviços > Assinaturas Gerais>, escolha a subscrição que pretende utilizar na lista. Na secção Essencial , encontre o ID de assinatura. Como boas práticas, utilize subscrições separadas para ambientes de produção e dev ou teste.

  • O ID de assinatura para uma subscrição do Azure. Apenas as assinaturas EA são suportadas para inscrição.

    Para obter o ID, vá ao portal do Azure e selecione Todos os serviços > Assinaturas Gerais>, escolha a subscrição que pretende utilizar na lista. Na secção Essencial , encontre o ID de assinatura. Como boas práticas, utilize subscrições separadas para ambientes de produção e dev ou teste.

Nota

As subscrições em nuvem da Alemanha não são suportadas atualmente.

  • O nome de utilizador e senha de uma conta que é proprietária da subscrição.

  • A conta de utilizador 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 a Azure utilizando a administração de menos privilégios. Para obter mais informações sobre como criar uma definição de função personalizada que limite o acesso à sua subscrição para inscrição, consulte criar uma função de registo para o Azure Stack Hub.

  • Registrou o fornecedor de recursos Azure Stack Hub (consulte a seguinte secção de Fornecedor de Recursos do Hub de Azure Stack para obter mais detalhes).

Após o registo, não é necessária a permissão de administrador global Azure Ative Directory (Azure AD). No entanto, algumas operações podem exigir a credencial de administração global (por exemplo, um script de instalador de recursos ou uma nova funcionalidade que exija uma permissão para ser concedida). Pode restabelecer temporariamente as permissões de administração global da conta ou utilizar uma conta de administração global separada que seja proprietária da subscrição do fornecedor predefinido.

O utilizador que regista o Azure Stack Hub é o proprietário do principal serviço em Azure AD. Apenas o utilizador que registou o Azure Stack Hub pode modificar o registo Azure Stack Hub. Todos os outros utilizadores, mesmo que sejam administradores globais, terão de ser adicionados à 'Subscrição de Fornecedor Padrão' através do 'Controlo de Acesso (IAM)'. Se um utilizador não administrador que não seja proprietário do serviço de registo principal tentar registar ou re-registar o Azure Stack Hub, poderá encontrar uma resposta de 403. Uma resposta 403 indica que o utilizador não tem permissões suficientes para completar a operação.

Se não tiver uma subscrição Azure que satisfaça estes requisitos, pode criar uma conta Azure gratuita aqui. Registar o Azure Stack Hub não implica qualquer custo na sua subscrição Azure.

Nota

Se tiver mais do que um Azure Stack Hub, a melhor prática é registar cada Azure Stack Hub na sua própria subscrição. Isto facilita-lhe o rastreio do uso.

Desa ajuste o modo linguagem PowerShell

Para registar com sucesso o Azure Stack Hub, o modo linguístico PowerShell tem de ser definido para FullLanguage. Para verificar se o modo de linguagem atual está definido para estar completo, abra uma janela PowerShell elevada e execute os seguintes cmdlets PowerShell:

$ExecutionContext.SessionState.LanguageMode

Certifique-se de que a saída devolve FullLanguage. Se algum outro modo linguístico for devolvido, o registo tem de ser executado noutra máquina ou o modo idioma tem de ser definido para FullLanguage antes de continuar.

Instale PowerShell para Azure Stack Hub

Utilize o mais recente PowerShell para o Azure Stack Hub para se registar com o Azure.

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

Descarregue as ferramentas Azure Stack Hub

As ferramentas Azure Stack Hub GitHub repositório contém módulos PowerShell que suportam a funcionalidade Azure Stack Hub, incluindo a funcionalidade de registo. Durante o processo de registo, é necessário importar e utilizar o módulo RegisterWithAzure.psm1 PowerShell (encontrado no repositório de ferramentas Azure Stack Hub) para registar a sua instância Azure Stack Hub com a Azure.

Para garantir que está a utilizar a versão mais recente, elimine quaisquer versões existentes das ferramentas Azure Stack Hub e descarregue a versão mais recente de GitHub antes de se registar no Azure.

Nota

Também pode utilizar a Estação de Trabalho de Acesso ao Operador (OAW) para aceder ao ponto final privilegiado (PEP), o portal administrador para cenários de suporte e ferramentas GitHub Do Azure Stack Hub. Para mais informações consulte a estação de trabalho de acesso ao operador do Azure Stack Hub.

Determine o seu modelo de faturação

Uma implementação conectada permite que o Azure Stack Hub se conecte à internet e ao Azure. Também pode utilizar a Azure AD ou Serviços de Federação do Ative Directory (AD FS) (AD FS) como sua loja de identidade, e escolher entre dois modelos de faturação: pay-as-you-use ou baseado na capacidade. Especifica o modelo de faturação mais tarde, enquanto executa o script de registo.

Uma implementação desligada permite-lhe utilizar o Azure Stack Hub sem uma ligação à internet. Com uma implementação desligada, está limitado a uma loja de identidade AD FS e ao modelo de faturação baseado na capacidade. Especifica o modelo de faturação mais tarde, enquanto executa o script de registo.

Determine o seu nome de registo único

Ao executar o roteiro de inscrição, deve fornecer um nome de registo único. Uma maneira fácil de associar a sua assinatura Azure Stack Hub a um registo Azure é usar o seu ID cloud Azure Stack Hub.

Nota

As inscrições do Azure Stack Hub utilizando o modelo de faturação baseado na capacidade terão de alterar o nome único quando se re-registar após a expiração dessas subscrições anuais, a menos que elimine o registo expirado e volte a registar-se com o Azure.

Para determinar o ID da Cloud para a sua implementação do Azure Stack Hub, consulte encontre o seu ID de nuvem.

Registe-se com faturação paga como utilização

Utilize estes passos para registar o Azure Stack Hub com o Azure utilizando o modelo de faturação pay-as-you-use.

Nota

Todos estes passos devem ser executados a partir de um computador que tenha acesso ao ponto final privilegiado (PEP). Para mais detalhes sobre o PEP, consulte Usando o ponto final privilegiado no Azure Stack Hub.

Ambientes conectados podem aceder à internet e ao Azure. Para estes ambientes, você precisa registar o fornecedor de recursos Azure Stack Hub com Azure e, em seguida, configurar o seu modelo de faturação.

  1. Para registar o fornecedor de recursos Azure Stack Hub com o Azure, inicie o PowerShell ISE como administrador e utilize os seguintes cmdlets PowerShell com o parâmetro EnvironmentName definido para o tipo de subscrição Azure apropriado (ver parâmetros abaixo).

  2. Adicione a conta Azure que usou para registar o Azure Stack Hub. Para adicionar a conta, executar o Ligação-AzAccount cmdlet. É-lhe pedido que introduza as suas credenciais de conta Azure e poderá ter de utilizar a autenticação de dois fatores com base na configuração da sua conta.

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

    Nota

    Se a sessão expirar, a sua palavra-passe mudou ou simplesmente deseja mudar de conta, executar o seguinte cmdlet antes de iniciar sessão usando Ligação-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. Executar o seguinte comando para registar o fornecedor de recursos Azure Stack Hub na sua subscrição Azure:

    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

  5. Inicie o PowerShell ISE como administrador e navegue para a pasta registo no diretório AzureStack-Tools-az criado quando descarregou as ferramentas Azure Stack Hub. Importe o módulo RegisterWithAzure.psm1 utilizando o PowerShell:

    Import-Module .\RegisterWithAzure.psm1

  6. Em seguida, na mesma sessão PowerShell, certifique-se de que está inscrito no contexto Azure PowerShell correto. Este contexto seria a conta Azure que foi usada para registar anteriormente o fornecedor de recursos Azure Stack Hub. PowerShell a executar:

    Connect-AzAccount -Environment "<environment name>"
    Parâmetro Description
    Nome ambiente O nome do ambiente de subscrição em nuvem Azure. Os nomes do ambiente suportados são AzureCloud, AzureUSGovernment, ou se usando uma Subscrição Azure China, AzureChinaCloud.

  7. Na mesma sessão PowerShell, executar o cmdlet Set-AzsRegistration . PowerShell a executar:

    $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 Set-AzsRegistration cmdlet, consulte a referência Registo.

O processo demora entre 10 e 15 minutos. Quando o comando estiver concluído, vê a mensagem "O seu ambiente está agora registado e ativado utilizando os parâmetros fornecidos."

Registar-se com faturação de capacidade

Utilize estes passos para registar o Azure Stack Hub com o Azure utilizando o modelo de faturação de capacidade.

Nota

Todos estes passos devem ser executados a partir de um computador que tenha acesso ao ponto final privilegiado (PEP). Para mais detalhes sobre o PEP, consulte Usando o ponto final privilegiado no Azure Stack Hub.

Ambientes conectados podem aceder à internet e ao Azure. Para estes ambientes, você precisa registar o fornecedor de recursos Azure Stack Hub com Azure e, em seguida, configurar o seu modelo de faturação.

  1. Para registar o fornecedor de recursos Azure Stack Hub com o Azure, inicie o PowerShell ISE como administrador e utilize os seguintes cmdlets PowerShell com o parâmetro EnvironmentName definido para o tipo de subscrição Azure apropriado (ver parâmetros abaixo).

  2. Adicione a conta Azure que usou para registar o Azure Stack Hub. Para adicionar a conta, executar o Ligação-AzAccount cmdlet. É-lhe pedido que introduza as suas credenciais de conta Azure e poderá ter de utilizar a autenticação de dois fatores com base na configuração da sua conta.

    Connect-AzAccount -Environment "<environment name>"
    Parâmetro Description
    Nome ambiente O nome do ambiente de subscrição em nuvem Azure. Os nomes do ambiente suportados são AzureCloud, AzureUSGovernment, ou se usando uma Subscrição Azure 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. Executar o seguinte comando para registar o fornecedor de recursos Azure Stack Hub na sua subscrição Azure:

    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

  5. Inicie o PowerShell ISE como administrador e navegue para a pasta registo no diretório AzureStack-Tools-az criado quando descarregou as ferramentas Azure Stack Hub. Importe o módulo RegisterWithAzure.psm1 utilizando 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

    Utilize o número do contrato EA onde foram adquiridas as licenças SKU de capacidade.

    Nota

    Pode desativar o relatório de utilização com o parâmetro UsageReportingEnabled para o cmdlet Set-AzsRegistration definindo o parâmetro para falso.

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

Registar-se com faturação de capacidade

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. Em seguida, utilize esse token num computador que pode ligar-se ao Azure e tenha o PowerShell para o Azure Stack Hub instalado.

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

  1. Inicie o PowerShell ISE como administrador e navegue para a pasta registo no diretório AzureStack-Tools-az criado quando descarregou as ferramentas Azure Stack Hub. Importar o módulo RegisterWithAzure.psm1 :

    Import-Module .\RegisterWithAzure.psm1

  2. Para obter o token de registo, executar os seguintes cmdlets PowerShell:

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

    Utilize o número do contrato EA onde foram adquiridas as licenças SKU de capacidade.

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

    Dica

    O sinal de registo é guardado no ficheiro especificado para $FilePathForRegistrationToken. Pode alterar o filepath ou o nome de ficheiros a seu critério.

  3. Guarde este sinal de registo para utilização na máquina ligada ao Azure. Pode copiar o ficheiro ou o texto a partir de $FilePathForRegistrationToken.

Ligação para Azure e registe-se

No computador que está ligado à internet, faça os mesmos passos para importar o módulo RegisterWithAzure.psm1 e inscreva-se no contexto Azure PowerShell correto. Em seguida, ligue para o Registo-AzsEnvironment. Especifique o sinal de inscrição para registar-se com a Azure. Se estiver a registar mais de um exemplo do Azure Stack Hub utilizando o mesmo ID de subscrição Azure, especifique um nome de registo único.

Você precisa do seu token de inscrição e um nome simbólico único.

  1. Inicie o PowerShell ISE como administrador e navegue para a pasta registo no diretório AzureStack-Tools-az criado quando descarregou as ferramentas Azure Stack Hub. Importar o módulo RegisterWithAzure.psm1 :

    Import-Module .\RegisterWithAzure.psm1

  2. Em seguida, executar os seguintes cmdlets PowerShell:

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

Opcionalmente, pode utilizar o Get-Content cmdlet para indicar um ficheiro que contenha o seu token de registo.

Você precisa do seu token de inscrição e um nome simbólico único.

  1. Inicie o PowerShell ISE como administrador e navegue para a pasta registo no diretório AzureStack-Tools-az criado quando descarregou as ferramentas Azure Stack Hub. Importar o módulo RegisterWithAzure.psm1 :

    Import-Module .\RegisterWithAzure.psm1

  2. Em seguida, executar os seguintes cmdlets PowerShell:

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

Nota

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

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

Em seguida, precisa de obter uma chave de ativação do recurso de registo criado em Azure durante o Registo-AzsEnvironment.

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

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

Dica

A chave de ativação é guardada no ficheiro especificado para $KeyOutputFilePath. Pode alterar o filepath ou o nome de ficheiros a seu critério.

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

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

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

Opcionalmente, pode utilizar o Get-Content cmdlet para indicar um ficheiro que contenha o seu token de registo:

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

Verifique o registo do Azure Stack Hub

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

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

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

  3. Selecione Propriedades. Esta lâmina mostra o estado e detalhes do seu ambiente. O estado pode ser registado, não registado ou caducado.

    Region management tile in Azure Stack Hub administrator portal

    Se registados, as propriedades incluem:

    • ID de assinatura de registo: O ID de assinatura Azure registado e associado ao Azure Stack Hub.
    • Grupo de recursos de registo: O grupo de recursos Azure na subscrição associada que contém os recursos do Azure Stack Hub.

  4. Pode utilizar o portal do Azure para visualizar os recursos de registo do Azure Stack Hub e, em seguida, verificar se o registo foi bem sucedido. Inscreva-se no portal do Azure utilizando uma conta associada à subscrição que usou para registar o Azure Stack Hub. Selecione Todos os recursos, ative a caixa de verificação dos tipos de séries do Show e selecione o nome de registo.

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

Em alternativa, pode verificar se o seu registo foi bem sucedido utilizando a funcionalidade de gestão marketplace. Se vir uma lista de itens de mercado na lâmina de gestão do Marketplace, o seu registo foi bem sucedido. No entanto, em ambientes desligados, não é possível ver itens de marketplace na gestão do Marketplace.

Renovar ou alterar registo

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

  • Depois de renovar a subscrição anual baseada na sua capacidade.
  • Quando mudares o teu modelo de faturação.
  • Quando escalar alterações (adicionar/remover nós) para faturação baseada na capacidade.

Pré-requisitos

Precisa das seguintes informações do portal do administrador para renovar ou alterar o registo:

Portal do administrador Parâmetro de cmdlet Notas
ID DE ASSINATURA DE REGISTO Subscrição ID de assinatura usado durante o registo anterior
GRUPO DE RECURSOS DE REGISTO ResourceGroupName Grupo de recursos ao abrigo do qual existe o recurso de registo anterior
NOME DE REGISTO Nome de registos Nome de registo utilizado durante o registo anterior

Alterar a subscrição que utiliza

Se quiser alterar a subscrição que utiliza, tem primeiro de executar o cmdlet Remove-AzsRegistration e, em seguida, certifique-se de que está inscrito no contexto Azure PowerShell correto. Em seguida , executar Set-AzsRegistration com quaisquer parâmetros alterados, incluindo <billing model>. Durante a execução do Remove-AzsRegistration, deve ser inscrito na subscrição utilizada durante o registo e utilização dos valores do RegistrationName e ResourceGroupName parâmetros como indicado no portal do administrador:

# 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 modelo de faturação, como as funcionalidades são oferecidas, ou re-registar o seu exemplo

Esta secção aplica-se se pretender alterar o modelo de faturação, como as funcionalidades são oferecidas ou se pretende voltar a registar o seu caso. Para todos estes casos, ligue para a função de registo para definir os novos valores. Não precisa primeiro remover o registo atual. Inscreva-se no ID de subscrição apresentado no portal do administrador e, em seguida, reencando o registo com um novo BillingModel valor, mantendo os RegistrationName valores e ResourceGroupName parâmetros iguais aos indicados no portal do administrador:

# 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>'

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

  • Depois de renovar a subscrição anual baseada na sua capacidade.
  • Quando mudares o teu modelo de faturação.
  • Quando escalar alterações (adicionar/remover nós) para faturação baseada na capacidade.

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

Primeiro, é necessário remover o recurso de ativação do Azure Stack Hub e, em seguida, o recurso de registo em Azure.

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

Remove-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint

Em seguida, para remover o recurso de registo em Azure, certifique-se de que está num computador ligado ao Azure, inscreva-se no contexto Azure PowerShell correto e execute os cmdlets PowerShell apropriados, conforme descrito abaixo.

Pode utilizar o token de registo utilizado para criar o recurso:

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

Ou pode usar o nome do grupo de registo e registo do portal do administrador:

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

Re-registrar usando etapas conectadas

Se alterar o seu modelo de faturação de faturação de capacidade num estado desligado para faturação de consumo num estado ligado, registar-se-á novamente seguindo os passos do modelo ligado.

Nota

Isto não altera o seu modelo de identidade, apenas o mecanismo de faturação, e continuará a usar a AD FS como fonte de identidade.

Re-registrar usando passos desligados

Agora não registou completamente um cenário desligado e deve repetir os passos para registar um ambiente Azure Stack Hub num cenário desligado.

Desativar ou permitir relatórios de utilização

Para ambientes Azure Stack Hub que utilizam um modelo de faturação de capacidade, desligue o relatório de utilização com o parâmetro UsageReportingEnabled utilizando o Set-AzsRegistration ou os cmdlets Get-AzsRegistrationToken . Azure Stack Hub reporta métricas de utilização por padrão. Os operadores com utilização de capacidade ou suporte a um ambiente desligado precisam de desligar o relatório de utilização.

Executar os seguintes cmdlets 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 registo, executar os seguintes cmdlets PowerShell:

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

    Utilize o número do contrato EA onde foram adquiridas as licenças SKU de capacidade.

    Dica

    O sinal de registo é guardado no ficheiro especificado para $FilePathForRegistrationToken. Pode alterar o filepath ou o nome de ficheiros a seu critério.

  2. Guarde este símbolo de registo para utilização na máquina ligada Azure. Pode copiar o ficheiro ou o texto a partir de $FilePathForRegistrationToken.

Mover um recurso de registo

A deslocação de um recurso de registo entre grupos de recursos ao abrigo da mesma subscrição é suportada para todos os ambientes. No entanto, a deslocação de um recurso de registo entre subscrições só é suportada para CSPs quando ambas as subscrições resolvem para o mesmo ID do parceiro. 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.

Importante

Para evitar a eliminação acidental dos recursos de registo no portal, o script de registo adiciona automaticamente um bloqueio ao recurso. Deve retirar esta fechadura antes de a mover ou apagar. Recomenda-se que adicione um bloqueio ao seu recurso de registo para evitar a eliminação acidental.

Referência de registo

Set-AzsRegistration

Pode utilizar o Set-AzsRegistration para registar o Azure Stack Hub com o Azure e ativar ou desativar a oferta de itens no mercado e relatórios de utilização.

Para executar o cmdlet, você precisa:

  • Uma subscrição global do Azure de qualquer tipo.
  • Para ser inscrito na Azure PowerShell com uma conta que seja um proprietário ou contribuinte para essa subscrição.
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
PrivilegiadoEndpointCredential PSCredential As credenciais usadas para aceder ao ponto final privilegiado. O nome de utilizador está no formato AzureStackDomain\CloudAdmin.
Ponto privilegiado String Uma consola powerShell remota pré-configurada que lhe fornece capacidades como a recolha de registos e outras tarefas de implementação de posts. Para saber mais, consulte o artigo de ponto final privilegiado .
AzureContexto PSObject
ResourceGroupName String
ResourceGroupLocation String
BillingModel String O modelo de faturação que a sua subscrição utiliza. Os valores permitidos para este parâmetro são: Capacidade, PayAsYouUse e Desenvolvimento.
MarketplaceSyndicationEnabled Verdadeiro/Falso Determina se a funcionalidade de gestão do mercado está disponível no portal. Definido para verdadeiro se registar com conectividade de internet. Definido como falso se registar em ambientes desligados. Para registos desligados, a ferramenta de sindicalização offline pode ser usada para descarregar itens de mercado.
UsageReportingEnabled Verdadeiro/Falso Azure Stack Hub reporta métricas de utilização por padrão. Os operadores com utilização de capacidade ou suporte a um ambiente desligado precisam de desligar o relatório de utilização. Os valores permitidos para este parâmetro são: Verdadeiro, Falso.
Número de acordos String O número do acordo EA ao abrigo do qual foi encomendado o SKU de capacidade para esta Stack Azure.
Nome de registos String Desconfie de um nome único para o registo se estiver a executar o script de registo em mais de um exemplo do Azure Stack Hub utilizando o mesmo ID de subscrição Azure. O parâmetro 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 falha.

Get-AzsRegistrationToken

Get-AzsRegistrationToken gera um sinal de registo 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
PrivilegiadoEndpointCredential PSCredential As credenciais usadas para aceder ao ponto final privilegiado. O nome de utilizador está no formato AzureStackDomain\CloudAdmin.
Ponto privilegiado String Uma consola powerShell remota pré-configurada que lhe fornece capacidades como a recolha de registos e outras tarefas de implementação de posts. Para saber mais, consulte o artigo de ponto final privilegiado .
AzureContexto PSObject
ResourceGroupName String
ResourceGroupLocation String
BillingModel String O modelo de faturação que a sua subscrição utiliza. Os valores permitidos para este parâmetro são: Capacidade, PayAsYouUse e Desenvolvimento.
MarketplaceSyndicationEnabled Verdadeiro/Falso
UsageReportingEnabled Verdadeiro/Falso Azure Stack Hub reporta métricas de utilização por padrão. Os operadores com utilização de capacidade ou suporte a um ambiente desligado precisam de desligar o relatório de utilização. Os valores permitidos para este parâmetro são: Verdadeiro, Falso.
Número de acordos String

Falhas de registo

Pode ver um dos erros abaixo enquanto tenta registar o seu Azure Stack Hub:

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

  • Não é possível ligar-se para $hostName obter informações de hardware. Verifique o hospedeiro físico e a conectividade e tente refazer o registo.

    Causa: isto é tipicamente porque tentamos obter detalhes de hardware como UUID, Bios e CPU dos anfitriões para tentar ativação e não foram capazes de devido à incapacidade de se conectar com o hospedeiro físico.

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

    Porque: isto acontece se o seu ambiente Azure Stack já estiver registado. Se pretender voltar a registar o seu ambiente com um modelo de subscrição ou faturação diferente, siga as etapas de Renovação ou altere as etapas de registo.

  • Ao tentar aceder à gestão do Marketplace, ocorre um erro ao tentar sindicalizar os produtos.

    Causa: isto geralmente acontece quando o Azure Stack Hub não consegue aceder ao recurso de registo. Uma razão comum para isso é que quando o inquilino de uma subscrição da Azure muda, ele repõe o registo. Não pode aceder ao Azure Stack Hub Marketplace ou reportar o uso se tiver alterado o inquilino do diretório da subscrição. Tem de se recandistar para resolver este problema.

  • A gestão do mercado ainda lhe pede para se registar e ativar o seu Azure Stack Hub mesmo quando já registou o seu carimbo usando o processo desligado.

    Causa: este é um problema conhecido para ambientes desligados, e requer que você verifique o seu estado de registo. Para utilizar a gestão do Marketplace, utilize a ferramenta offline.

Passos seguintes

Baixar artigos de marketplace da Azure