Skip to main content

26 de agosto de 2026

Reinstalar o software Horizon Agent em VMs de áreas de trabalho dedicadas

O recurso de reinstalação permite desinstalar o agente existente da VM e reinstalar o software do agente mais recente. O recurso de reinstalação fornece um mecanismo de recuperação para falhas de atualização do agente por instalação forçada e em situações especiais em que você precisa desinstalar e reinstalar o software do agente, conforme descrito nos casos de uso a seguir.

Os seguintes casos de uso ilustram quando você pode realizar uma reinstalação do agente.

Nota:

  • Quando seu ambiente do Horizon Cloud tem uma migração de primeira geração que ainda não foi finalizada, o sistema impede a execução desse procedimento do agente de reinstalação. Depois de clicar em Agente > Reinstalar, será exibida uma mensagem sobre a finalização da migração.
  • As operações de atualização e reinstalação do agente usam o servidor proxy configurado no nível do pool. Para obter informações sobre como configurar o servidor proxy no nível do pool, consulte Editar um pool.

Procedimento

  1. No Horizon Universal Console, navegue até a página Grupos de Pools.

  2. Selecione VMs.

  3. Selecione uma ou mais VMs na lista.

  4. Selecione Agente > Reinstalar.

    A página Reinstalar Agente é aberta. A página solicita informações. Os prompts serão diferentes dependendo de você ter selecionado uma VM ou várias VMs.

    • Reinstalar a página do Agente com uma única VM selecionada

      Página Reinstalar Agente com uma única VM selecionada mostrando as caixas de seleção do recurso do agente e o menu da versão

    • Reinstalar a página do agente com várias VMs selecionadas

      Página Reinstalar Agente com várias VMs selecionadas mostrando as opções de instalação e seleção de recursos do agente em massa

  5. Preencha o formulário Reinstalar Agente e clique em Reinstalar.

    Forneça as respostas apropriadas para os prompts a seguir que se aplicarem. A opção Argumentos da Linha de Comando é aplicável quando você selecionou um único agente ou vários agentes. Todas as outras opções se aplicam somente quando você selecionou vários agentes.

    OpçãoDescrição
    Ignorar VMs com usuários ativosSelecione para ignorar a reinstalação do Horizon Agent para sessões ativas ou desconectadas. Se essa opção não for selecionada, os usuários conectados às VMs quando a reinstalação começar receberão um aviso de 5 minutos e serão desconectados à força.
    Tempo Limite de TrabalhoDefina o período de tempo durante o qual deseja que o sistema continue tentando reinstalar os agentes automaticamente. Se você deseja executar reinstalações apenas durante um período específico, pode definir um curto período de tempo, mesmo se selecionar vários modelos e VMs. Um lote de VMs pode levar de 20 a 60 minutos, dependendo do estado da VM e de qualquer outro tempo de espera e novas tentativas em andamento. Por exemplo, se você tiver mais de 600 VMs para reinstalar com 30 VMs como simultaneidade, calcule o período da seguinte maneira:
    • Número de lotes: 600/30 = 20 lotes
    • Tempo limite do trabalho: 20*60 = 1200 minutos
    Você definiria o tempo limite do trabalho para 1.200 minutos, que é um período muito mais longo do que o normalmente necessário para executar reinstalações. Nota: o sistema não tenta reinstalar as VMs que encontram um erro durante o processo de reinstalação.
    Simultaneidade Defina um limite para o número de VMs nas quais o sistema tenta reinstalar o agente simultaneamente. Essa configuração funciona em paralelo com a configuração Limite de Falhas. O ideal é manter a configuração Simultaneidade menor ou igual à configuração Limite de Falhas.
    Limite de Falhas O número de VMs para as quais a reinstalação do agente pode falhar antes que o processo de reinstalação seja interrompido. Definir esse limite impede a ocorrência de falhas em massa. Quando o processo de reinstalação é interrompido devido a reinstalações com falha do agente VM, você pode observar um número de VMs com falha maior do que o valor Limite de Falhas definido. Se você precisar garantir que haverá menos falhas do que o número especificado para a configuração Limite de Falhas, defina o valor de Simultaneidade como 1. Isso também significa que o processo de reinstalação do agente levará muito tempo, pois reinstalará uma VM por vez. Recomenda-se definir Simultaneidade e Limite de Falhas adequadamente para obter resultados ideais.
    Argumentos de Linha de ComandoNa caixa de texto Argumentos de Linha de Comando, adicione quaisquer opções de linha de comando que possam ser relevantes para esta reinstalação.

O que fazer agora

O processo de reinstalação do agente é executado em segundo plano. Você pode visualizar o andamento do processo na página Log de Atividades. Consulte Monitorar atividades do administrador e dos usuário finais na página Log de Atividades

.

Esta página foi útil?

Enviar feedback sobre este tópico

Este tópico foi útil?

Não inclua informações pessoais ou confidenciais.

Gerando o link…