Conexão com Amulet Hotkey CoreStation

Last published : Nov 03, 2026
Criar e gerenciar conexões e recursos descreve os assistentes gerais para criar uma conexão. As informações a seguir cobrem detalhes específicos do Amulet Hotkey CoreStation. Atualmente, você pode criar uma conexão com o Amulet Hotkey CoreStation usando comandos PowerShell.
Nota:
Antes de criar uma conexão com o Amulet Hotkey CoreStation, você precisa primeiro concluir a configuração da sua conta Amulet Hotkey CoreStation. Consulte Ambientes de virtualização do Amulet Hotkey CoreStation

Criar uma conexão

Você pode criar uma conexão com o Amulet Hotkey CoreStation usando:

Criar uma conexão usando o Studio

  1. Na página Adicionar Conexão e Recursos, selecione Amulet Hotkey CoreStation como o tipo de conexão.
  2. Insira o endereço de conexão do seu Gerenciador de gabinete Amulet Hotkey CoreStation. Você pode usar um endereço IP, nome de host ou FQDN para o endereço.
  3. Insira suas credenciais administrativas do gabinete e um nome de conexão amigável.
    A configuração da conexão para quando uma das seguintes situações ocorre:
    • O DaaS recebe um certificado assinado por CA público com erros: Uma mensagem de erro aparece. Siga as instruções na tela para corrigir o problema. Caso contrário, você não poderá prosseguir com a criação da conexão.
    • O DaaS recebe um certificado assinado por CA privado: Uma página de aviso aparece. Compare a impressão digital recebida com a do servidor para verificar a validade do certificado. Se for válido, selecione Confiar no certificado e clique em OK para prosseguir com a criação da conexão. O DaaS então confiará no certificado e armazenará a impressão digital para validação futura.

Criar uma conexão usando comandos PowerShell

Ao criar uma conexão usando o comando PowerShell, forneça as seguintes informações:
  • IP: Endereço IP do Amulet Hotkey CoreStation
  • Nome de usuário: Nome de usuário do Amulet Hotkey CoreStation
  • Senha: Senha do Amulet Hotkey CoreStation
Exemplo:
Get-ConfigZone
Get-HypHypervisorPlugin
New-Item `
    -ConnectionType "Custom" `
    -HypervisorAddress $IP `
    -Metadata @{"Citrix_Orchestration_Hypervisor_Secret_Allow_Edit"="false"} `
    -Path @("XDHyp:\Connections\$connectionName") `
    -Persist `
    -PluginId "AmuletHotkeyCoreStationFactory" `
    -Scope @() `
    -SecurePassword $Password `
    -UserName $UserName `
    -ZoneUid $ZoneUid `
    -SslThumbprint $SslThumbprint
New-BrokerHypervisorConnection -HypHypervisorConnectionUid $HypervisorConnectionID
Nota:
O parâmetro -SslThumbprint é necessário apenas para certificados privados assinados por CA.

Validação de certificado e impressão digital

Para criar uma conexão bem-sucedida com o Amulet Hotkey CoreStation, o certificado não deve ter erros e a impressão digital deve ter um valor correto. A seguir estão os casos de uso relacionados à validação de certificado e impressão digital:
Cenário Resultado
Certificado público assinado por CA apresenta erros. A conexão não é criada com sucesso. Consulte os detalhes do erro e resolva o problema.
Certificado público assinado por CA sem erros. A conexão é criada com sucesso, e o valor SslThumbprints é Null.
Certificado assinado por CA privada sem erros e um valor sslthumbprint. A conexão é criada com sucesso com um valor SslThumbprints correto.
Certificado assinado por CA privada com um valor de impressão digital incorreto. A conexão não é criada com sucesso.
Certificado assinado por CA privada sem erros. (nenhuma impressão digital fornecida) A conexão é criada com sucesso. O SSlThumbprints é Null ao criar a conexão. O valor SSlThumbprints é atualizado para um valor pelo serviço do site.

Gerenciar conexões

Corrigir problemas de certificado

O Citrix DaaS bloqueia uma conexão do Amulet Hotkey CoreStation quando surgem problemas de certificado, impedindo que você entregue e gerencie cargas de trabalho em nós associados do Amulet Hotkey CoreStation. Você verá um ícone de erro ao lado da conexão na lista Conexões de host.
Consulte a tabela a seguir para problemas e soluções específicas.
Problema Solução
Ocorre um erro de certificado para o certificado assinado por CA pública. Clique na conexão e selecione a guia Solução de problemas. Visualize os detalhes do erro e resolva o problema.
O certificado recebido é assinado por CA privada ou expirou. Edite a conexão do host para atualizar a impressão digital do certificado. Etapas detalhadas:
  1. Selecione a conexão e clique em Editar Conexão.
  2. Na página Propriedades da Conexão, clique em Editar configurações.
  3. Insira a senha para se conectar ao gabinete Amulet Hotkey CoreStation e, em seguida, clique em Salvar.
  4. Na página de Aviso que aparece, compare a impressão digital recebida com a do servidor para validar o certificado.
  5. Se forem iguais, selecione Confiar no certificado e clique em OK.

Atualizar valor da impressão digital

Após criar a conexão, você pode atualizar o valor da impressão digital de uma conexão usando o comando PowerShell Set-Item. Siga as etapas para atualizar o valor da impressão digital.
  1. Obtenha os detalhes de conexão de uma conexão. Por exemplo:
    Get-Item -LiteralPath xdhyp:\connections\AmuletCon-101
  2. Atualize o valor do thumbprint. Por exemplo:
    Set-Item -LiteralPath xdhyp:\connections\AmuletCon-101 -Username Administrator -SslThumbprint xxxxxxxxxxx12AD048480631BB7AB10D69xxxxx
  3. Verifique o valor do thumbprint atualizado. Por exemplo:
    Get-Item -LiteralPath xdhyp:\connections\AmuletCon-101
Nota:
A atualização falha se você fornecer um valor de thumbprint incorreto no comando Set-Item.

Onde ir a seguir

Mais informações