Citrix Virtual Apps and Desktops

Conexão com Amulet Hotkey CoreStation (Pré-visualização)

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

Nota:

Antes de criar uma conexão com o Amulet Hotkey CoreStation, você precisa primeiro concluir a configuração da sua conta do Amulet Hotkey CoreStation.

Criar uma conexão

Você pode criar uma conexão com o Amulet Hotkey CoreStation usando comandos do PowerShell.

Ao criar uma conexão usando o comando do 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
<!--NeedCopy-->

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:

  • O certificado assinado por CA pública tem erros. A conexão não é criada com sucesso. Consulte os detalhes do erro e resolva o problema.
  • Certificado assinado por CA pública 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. 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 Virtual Apps and Desktops bloqueia uma conexão Amulet Hotkey CoreStation quando surgem problemas de certificado, impedindo que você entregue e gerencie cargas de trabalho em nós Amulet Hotkey CoreStation associados. Você verá um ícone de erro ao lado da conexão na lista de conexões do host.

Consulte a tabela a seguir para problemas e soluções específicas.

Problema Solução
Ocorre um erro de certificado no 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 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 uma conexão. Por exemplo:

    Get-Item -LiteralPath xdhyp:\connections\AmuletCon-101
    <!--NeedCopy-->
    
  2. Atualize o valor da impressão digital. Por exemplo:

    Set-Item -LiteralPath xdhyp:\connections\AmuletCon-101 -Username Administrator -SslThumbprint xxxxxxxxxxx12AD048480631BB7AB10D69xxxxx
    <!--NeedCopy-->
    
  3. Verifique o valor da impressão digital atualizado. Por exemplo:

    Get-Item -LiteralPath xdhyp:\connections\AmuletCon-101
    <!--NeedCopy-->
    

Nota:

A atualização falha se você fornecer um valor de thumbprint incorreto no comando Set-Item.

Onde ir em seguida

Mais informações

Conexão com Amulet Hotkey CoreStation (Pré-visualização)