Page cover

Instalação do agente: Hyper-V

Procedimento destinado a instalação do agente remoto em sistemas operacionais Hyper-V:

🖥️ Instalação do Agente no Hyper-V – Tiflux


🎯 Introdução

Este documento detalha o procedimento completo para instalação do agente remoto no Hyper-V dentro do ecossistema do Tiflux. A instalação permite o monitoramento e a execução de ações remotas em ambientes virtualizados. 💡 Importante: O procedimento foi homologado apenas para Hyper-V 2016 e 2019.


📚 Sumário

  1. ✅ Pré-requisitos

  2. 🛠️ Passo a Passo Detalhado

  3. ⚙️ Observações Importantes

  4. 🛠️ Troubleshooting

  5. Artigos Relacionados

  6. ❓ Perguntas Frequentes (FAQ)

  7. 🔍 Palavras-chave para IA, indexação e busca


✅ Pré-requisitos

  • Ambiente Hyper-V versão 2016 ou 2019.

  • Link de download do agente remoto disponível no menu Recursos > Baixar Agente no Tiflux.

  • Canal de suporte ativo para eventuais dúvidas.

  • Powershell habilitado no Hyper-V.

📄 Documentações relacionadas:

  • Instalação do Agente: Windows

  • Configurações de TLS no Powershell

  • Compatibilidade de Acesso Remoto no Tiflux


🛠️ Passo a Passo Detalhado

  • Acesse o menu Recursos > Baixar Agente.

  • Selecione o cliente correspondente.

  • Copie o link de download do agente remoto.


2. Abrir o PowerShell no Hyper-V

  • No terminal do Hyper-V, digite:

powershell

3. Forçar Uso do TLS 1.2

  • Execute o comando:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

4. Realizar o Download do Agente

  • Comando padrão:

invoke-webrequest "link_do_agente" -OutFile "nome_do_arquivo.msi" -UseBasicParsing

💡 Dicas:

  • Em "Link_do_agente", cole o link que copiou do Tiflux

  • Nome do arquivo: utilizar o nome do cliente.

  • Espaços devem ser substituídos por underline (_).

  • Ao inserir o comando e dar enter, irá aparecer uma tarja azul como acima, indicando processo de download.


5. Executar o Instalador

  • Após o termino do download, execute o comando abaixo

  • Sempre lembrado que o nome do arquivo deve ser igual ao que informou no passo anterior

.\nome_do_arquivo.msi

Após a execução, o agente será instalado automaticamente.


6. Confirmação da Instalação

  • Acesse a listagem de agentes no Tiflux.

  • Confirme a criação do recurso correspondente à máquina Hyper-V.


⚙️ Observações Importantes

  • ✅ Procedimento homologado no Hyper-V 2016 e 2019.

  • ⚠️ O acesso remoto Splashtop não é homologado para Hyper-V.

  • ⚠️ O acesso remoto VNC pode apresentar limitações de compatibilidade.


🛠️ Troubleshooting

Problema
Possível Causa
Solução

Erro de TLS

TLS não configurado corretamente

Reexecutar comando de configuração TLS

Download falhou

Link incorreto ou nome de arquivo com espaço

Revisar link e nomear corretamente com underline

Instalador não abre

Arquivo corrompido ou comando incorreto

Refazer download e revisar sintaxe do comando


🔗 Artigos Relacionados


❓ Perguntas Frequentes (FAQ)

🔹 Como sei que o agente foi instalado corretamente? Após a instalação, o agente aparecerá automaticamente na listagem de agentes do Tiflux associado ao cliente selecionado.

🔹 Preciso homologar o Splashtop no Hyper-V? Não. O Splashtop não é compatível com o ambiente Hyper-V.

🔹 O VNC funciona normalmente? O VNC pode apresentar limitações de compatibilidade no Hyper-V. É recomendável validar previamente.

🔹 O procedimento é compatível com outras versões do Hyper-V? Não. Este procedimento foi testado e homologado apenas para as versões 2016 e 2019.


🔍 Palavras-chave para IA, indexação e busca

instalação agente Hyper-V,
baixar agente remoto Tiflux,
comando PowerShell TLS,
invoke-webrequest Tiflux,
instalação agente virtualizado,
agente remoto Hyper-V 2016,
agente remoto Hyper-V 2019,
problemas instalação agente Hyper-V,
Splashtop Hyper-V,
VNC Hyper-V,
compatibilidade agente Tiflux

Last updated