> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/sistema/recursos/recursos/instalacao-agente-hyper-v.md).

# Instalação 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**.

{% hint style="success" %}
Converse com seu Gerente de contas e adquira esta funcionalidade [Clique aqui](https://api.whatsapp.com/send?phone=551142008293\&text=Gostaria%20de%20mais%20informa%C3%A7%C3%B5es%20relacionadas%20a%20Agentes%20no%20Tiflux)
{% endhint %}

***

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

#### 1. Obter o Link de Download

* Acesse o **menu Recursos > Baixar Agente**.
* Selecione o cliente correspondente.
* Copie o link de download do agente remoto.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F84ZL1frTf0yXmbZcaGlz%2Fimage.png?alt=media&amp;token=f0b3dbd0-0401-4578-be74-b366ba42f73c" alt=""><figcaption></figcaption></figure>

***

#### 2. Abrir o PowerShell no Hyper-V

* No terminal do Hyper-V, digite:

```powershell
powershell
```

***

#### 3. Forçar Uso do TLS 1.2

* Execute o comando:

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FrYGFY3SOfkIIjtRH5UYa%2Fimage.png?alt=media&amp;token=08fc1572-bbc7-42bf-9bf2-3eb6cf1ed8f5" alt=""><figcaption></figcaption></figure>

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

***

#### 4. Realizar o Download do Agente

* Comando padrão:

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FnFbJDDdsBVpO62KBdQP2%2Fimage.png?alt=media&amp;token=3c4af45f-5e98-4c68-b829-3cef02b616e1" alt=""><figcaption></figcaption></figure>

```powershell
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

```powershell
.\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

* 📄 [Instalação do Agente: Windows](/sistema/recursos/recursos/agente-windows.md)
* 📄 [Pré-requisitos para a instalação Agente Tiflux](/sistema/recursos/recursos/pre-requisitos-para-a-instalacao.md)

***

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

```plaintext
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
```

***