---
title: Implantação do agente
slug: help/neurons/pt_br/implantacao-do-agente
createdAt: 2026-09-08T07:53:20.301Z
---

O agente Ivanti Neurons é necessário para usar a plataforma Ivanti Neurons. Use as seguintes abas para atribuir políticas e enviar um agente a um ponto de extremidade:

- **Atribuição automatizada de política**: selecione para gerenciar e atribuir políticas automaticamente aos dispositivos em seu ambiente, de acordo com regras configuráveis.
- **Instalação push do Neurons**: selecione para baixar o agente e implantar nos dispositivos de destino.
- **Instalação manual**: selecione para baixar o agente e instale manualmente, via linha de comando, em cada dispositivo de destino.

## Atribuição automatizada de política

A atribuição automatizada de política (APA) gerencia e atribui automaticamente políticas a dispositivos em seu ambiente com base em regras configuráveis. Com o APA, os administradores podem simplificar e centralizar o gerenciamento de políticas, garantindo que os dispositivos sempre recebam a política correta com base em critérios organizacionais, grupos de dispositivos, exceções e outros atributos.

Você pode usar o recurso APA para aproveitar as seguintes funções principais ao atribuir políticas a pontos de extremidade:

- **Atribuição baseada em regras**: as políticas são atribuídas a dispositivos de acordo com regras personalizáveis.
- **Agrupamento e tratamento de exceções**: possibilidade de agrupar dispositivos e configurar exceções.
- **Modos manual e automatizado**: passe da atribuição manual à automação com regras no seu próprio ritmo.
- **Espera de 24 horas**: limita as reatribuições de política para evitar instabilidade e consumo excessivo de recursos.

Para implantar a APA, você precisa primeiramente configurar a atribuição de políticas. Para obter mais informações sobre como configurar a APA, consulte [Configurar a atribuição automatizada de política](https://docs.ivanti.com/help/neurons/pt_br/configurar-a-atribuicao-automatizada-de-politica).

## Instalar agente manualmente

Para instalar um agente Ivanti Neurons manualmente, faça o seguinte:

1. Navegue até **Agentes** > **Implantação do Agente**, no bloco **Instalação manual**, clique em **Iniciar**.
   A página **Instalar manualmente um agente** é exibida.
2. **Escolha a política do agente**: no menu suspenso, selecione a **Política do Agente** que você deseja atribuir ao agente ou comece a digitar o nome da política para filtrar a lista suspensa.
   Ou selecione a opção **Usar atribuição automatizada de política** no menu suspenso para usar a implantação com APA.
   As políticas do agente são criadas em **Agentes&#x20;**> **Políticas do Agente**.
3. **Escolha sua chave de inscrição**: no menu suspenso, selecione a **chave de inscrição** que você deseja usar para registrar o agente. Como alternativa, para usar uma nova chave, selecione **Criar nova chave**. O painel [Criar chave de inscrição](https://docs.ivanti.com/help/neurons/pt_br/chaves-de-inscricao#create-enrollment-key) aparece.
   As chaves de inscrição são criadas em **Agentes&#x20;**> **Chaves de inscrição**.


:::hint{type="info"}
Se você estiver usando o recurso de atribuição automatizada de políticas na implantação do agente, uma chave integrada gerada automaticamente será usada para registrar o agente no locatário. A chave de inscrição vem predefinida como **Gerada Automaticamente**. Você também pode usar sua própria chave de inscrição de cliente, se necessário.
:::

4. **Escolha o sistema do ponto de extremidade host**: selecione o sistema operacional do dispositivo no qual você está instalando o agente: 

:::ExpandableHeading
## Microsoft Windows

Selecione o bloco **Windows** para instalar o agente Ivanti Neurons em um ponto de extremidade com Microsoft Windows e escolha seu método de instalação preferido:

- **Instalação interativa**
  1. Em **Modo de instalação**, selecione **Interativo**.
  2. Clique em **Baixar**.
     Dois arquivos são baixados:
     - IvantiCloudAgent - o arquivo de instalação do agente (`.exe`)
     - IvantiCloudAgent.exe.options - as definições de configuração (`.options`).
  3. Certifique-se de que os dois arquivos baixados estejam na mesma pasta e execute o arquivo executável.
- **Instalação silenciosa**
  1. Em **Modo de instalação**, selecione **Silencioso**.
  2. Clique em **Baixar**.
  3. Copie o **comando** e use com os parâmetros de instalação no arquivo de opções para executar o arquivo de instalação.
:::

:::ExpandableHeading
## Apple macOS

Selecione o bloco **macOS** para instalar o agente Ivanti Neurons em um ponto de extremidade com Apple macOS e escolha seu método de instalação preferido:

- **Instalação interativa**
  1. Em **Modo de instalação**, selecione **Interativo**.
  2. Clique em **Baixar**.
  3. No ponto de extremidade, distribua e monte a imagem do disco de instalação do agente (`.dmg`).
  4. Execute o pacote de instalação (`.pkg`).
  5. Depois que o agente estiver instalado, copie o **comando** e execute-o em um terminal para configurar o agente.
- **Instalação silenciosa**
  1. Em **Modo de instalação**, selecione **Silencioso**.
  2. Clique em **Baixar**.
  3. No ponto de extremidade, distribua o executável.
  4. Copie o **comando** e use com os parâmetros de instalação no arquivo de opções para executar o arquivo de instalação.

Durante a instalação do agente Neurons em dispositivos macOS, serão exibidos vários diálogos de permissão e notificação, possivelmente incluindo o uso de serviços de localização para o [sensor de localização](https://docs.ivanti.com/help/neurons/pt_br/configuracoes-do-edge-intelligence#Generic). Essas permissões e notificações devem ser definidas e/ou permitidas para que o agente funcione corretamente.
Você pode encontrar perfis MDM para definir a maioria dessas permissões antecipadamente, na Comunidade Ivanti, no artigo [Perfis MDM para Ivanti Neurons](https://forums.ivanti.com/s/article/MDM-Profiles-for-Ivanti-Neurons).
:::

::::ExpandableHeading
## Linux

:::hint{type="info"}
Antes de instalar o Ubuntu 24, os usuários devem instalar o pacote `libltdl-dev`, necessário para o funcionamento do sistema, usando o comando
`sudo apt install -y libltdl-dev`
:::

Selecione o bloco **Linux** para instalar o agente Ivanti Neurons em um ponto de extremidade Linux e escolha a versão do Linux:

1. No menu suspenso **Versão**, selecione a distribuição Linux aplicável.
2. Clique em **Baixar**.
3. No ponto de extremidade, abra um shell como root e navegue até o arquivo de instalação baixado (`.sh`).
4. Torne o arquivo de instalação executável.
5. Execute o arquivo de instalação:
   `bash <filename>.sh`

### Log de depuração

Os superadministradores têm a opção de habilitar ou desabilitar os logs de depuração do mecanismo P2Z usando a linha de comando. O superadministrador deve estabelecer uma conexão SSH com a máquina do agente e executar os seguintes comandos com privilégios de superusuário.

- Para habilitar os logs de depuração, use o comando no terminal: `touch /opt/ivanti/isec/data/agentPatchP2Z_EnableDebugLog`
- Para desabilitar os logs de depuração, use o comando no terminal: `rm -f /opt/ivanti/isec/data/agentPatchP2Z_EnableDebugLog`

### Observações importantes para o processo de instalação e modificações do sistema no Linux

**Criação de usuário**

- O processo de instalação cria apenas um usuário: "**ivanticloudagent**".
- Esse usuário é removido quando o agente é desinstalado.
- Nenhum outro usuário é criado pelo Agente Ivanti Cloud em nenhuma circunstância.
- O usuário "ivanticloudagent":
  - Tem como diretório inicial o local onde o agente está instalado
  - Esse diretório pertence ao root com permissões 755
  - O usuário pode pesquisar nesse diretório, mas não pode fazer alterações
  - Não pode efetuar login (sem senha ou shell de login predefinido)

**Modificações no sistema**: a instalação do Agente Ivanti Cloud NÃO faz nenhuma alteração em:

- Configuração sudoers
- Parâmetros de controle do sistema (sysctl)
- Definições de serviço (exceto para o próprio serviço dele)
- Permissões do sistema
- Quaisquer outras configurações em nível de sistema

**Configuração do serviço**

- Um arquivo de serviço é criado em "/lib/systemd/system/ivanticloudagent.service"
- O serviço permanece inativo até que o agente seja registrado
- Uma vez registrado, o serviço irá:
  - Ativar e iniciar o agente
  - Reiniciar o agente se ele parar devido a um erro
- O serviço não tem dependências de outros serviços do sistema
- Ele só inicia quando o sistema inicializa no modo multiusuário
- O serviço usa "/opt/ivanti/cloudagent/run/agent" como diretório de trabalho
- O programa de inicialização desse serviço é "stagentd"
::::

Após a instalação do agente no ponto de extremidade, os detalhes do dispositivo serão listados no menu principal > **Dispositivos**.

:::hint{type="success"}
Se você usar um software de distribuição (como o Ivanti Endpoint Manager), que envia os argumentos separadamente, lembre-se de remover o nome de arquivo do agente do texto copiado antes de colá-lo no software de distribuição. Para obter detalhes de como usar o Ivanti Endpoint Manager para distribuir o agente Ivanti Neurons, consulte [Como implantar um agente Ivanti Neurons usando o Endpoint Manager](https://forums.ivanti.com/s/article/How-to-deploy-an-Ivanti-Cloud-agent-using-Ivanti-Endpoint-Manager).
:::

## Implantar agente com instalação push do Neurons

:::hint{type="info"}
Certifique-se de que o nome do dispositivo, o endereço IP e as informações do sistema operacional estejam disponíveis para o dispositivo, para que possam ser selecionados ou visualizados durante uma instalação por push.
:::

Para implantar e instalar o agente Ivanti Neurons em um ponto de extremidade por meio do Ivanti Neurons, faça o seguinte:

1. Navegue até **Agentes** > **Implantação do Agente**, no bloco **Instalação push do Neurons**, clique em **Iniciar**.
   A página **Implantar com Ivanti Neurons** é exibida.

### Configurações de implantação

**Política do agente**: no menu suspenso, selecione a **Política do Agente** que você deseja atribuir ao agente ou comece a digitar o nome da política para filtrar a lista suspensa. Ou selecione a opção **Usar atribuição automatizada de política** no menu suspenso para usar a implantação com APA.
As políticas do agente são criadas em **Agentes&#x20;**> **Políticas do Agente**.

3. **Chave de inscrição (ativações restantes)**: no menu suspenso, selecione a **Chave de inscrição** que deseja usar para registrar o agente ou comece a digitar o nome da chave de inscrição para filtrar a lista suspensa. Certifique-se de ter ativações suficientes para o número de dispositivos nos quais deseja implantar.
   Como alternativa, para usar uma nova chave, selecione **Criar nova chave**. O painel [Criar chave de inscrição](https://docs.ivanti.com/help/neurons/pt_br/chaves-de-inscricao#create-enrollment-key) aparece.
   As chaves de inscrição são criadas em **Agentes&#x20;**> **Chaves de inscrição**.


:::hint{type="info"}
Se você estiver usando o recurso de atribuição automatizada de políticas na implantação do agente, uma chave integrada gerada automaticamente será usada para registrar o agente no locatário. A chave de inscrição vem predefinida como **Gerada Automaticamente**. Você também pode usar sua própria chave de inscrição de cliente, se necessário.
:::

4. **Implantar de**: selecione o ponto de extremidade a ser usado para a implantação. Se houver pelo menos um, mas menos de 500 pontos de extremidade com agente, cujo recurso Implantação esteja habilitado, a opção **Automático** será a seleção padrão. Você pode selecionar um ponto de extremidade específico na lista suspensa ou começar a digitar o nome dele para filtrá-la. Somente pontos de extremidade que possuem o agente instalado, com o recurso de Implementação ativado, estão disponíveis para seleção.

### Dispositivos de origem

A seção **Dispositivos de origem** lista todos os dispositivos que possuem nome, endereço IP e sistema operacional na exibição principal de **Dispositivos** dos Neurons.

:::hint{type="info"}
Os pontos de extremidade VDI não persistentes estão atualmente indisponíveis para seleção. Para aplicar alterações, é necessário retirar o selo desses pontos de extremidade, atualizá-los e lacrados novamente. Em vez disso, implante a política do agente diretamente nas imagens NP-VDI. Para obter mais informações sobre VDI, consulte Infraestrutura de dispositivo virtual [não persistente (NP-VDI)](https://docs.ivanti.com/help/neurons/pt_br/infraestrutura-de-dispositivo-virtual-nao-persistente-np-vdi) e Interface de dispositivo virtual [persistente (VDI) e Dispositivos clonados com imagens](https://docs.ivanti.com/help/neurons/pt_br/infraestrutura-de-dispositivo-virtual-vdi-persistente-e-dispositivos-clonados-com-imagens-douradas)douradas.
:::

A lista padrão é **Todos os dispositivos**. Você pode filtrar a lista pelos seguintes itens ou usar a pesquisa para localizar um dispositivo específico:

:::Paragraph{listStyleType="disc" indent="2"}
**Todos os dispositivos** (padrão), grupos de dispositivos padrão: **gerenciado em EPM**, **gerenciado na nuvem**, **portátil**, grupos de dispositivos públicos ou seus grupos de dispositivos privados (criados em **Dispositivos**).
:::

:::Paragraph{listStyleType="disc" indent="2"}
**Com** ou **Sem agentes**.
:::

6. **Marque** a caixa de seleção de cada dispositivo em que deseja implantar o agente.
7. Clique em **Adicionar** para adicionar os dispositivos de origem selecionados à seção **Dispositivos de destino**.

### Dispositivos de destino

A seção **Dispositivos de destino** lista todos os dispositivos que você adicionou a partir da seção **Dispositivos de origem**. São os dispositivos que você selecionou para implantar o agente.
O nome do dispositivo, o endereço IP e o sistema operacional do registro **Dispositivos** são exibidos.
Clique em **Implantar** para iniciar a implantação em todos os dispositivos de destino.
O status de implantação pode ser visto na coluna [Status](https://docs.ivanti.com/help/neurons/pt_br/gerenciamento-de-agentes#status) na página **Gerenciamento de agentes**.

9. Se precisar remover um dispositivo da lista de destinos, marque a caixa de seleção ao lado do dispositivo e clique em **Remover**. Alternativamente, clique em **Remover tudo** para remover todos os dispositivos da lista de destinos.

### Credenciais

As credenciais do dispositivo são necessárias para o agente executar ações que exigem privilégios elevados no dispositivo ou procurar outros dispositivos na rede. Você não pode prosseguir com a implantação até que tenham sido adicionadas as credenciais para o sistema operacional pertinente que receberá a implantação. A guia **Credenciais&#x20;**&#x66;ica destacada em vermelho até que o problema seja resolvido.
Defina as credenciais para o sistema operacional relevante: **Windows**, **macOS**, **Linux**. No menu suspenso, selecione uma credencial. Para criar novas credenciais, selecione **Criar nova credencial**. O painel **Nova credencial** aparece.

:::ExpandableHeading{customAnchorSlug="Create-credential"}
## Criar nova credencial

1. Digite o **Nome** para as novas credenciais. Você pode fornecer uma descrição opcional.
2. Insira o **Nome de usuário**.
3. Insira a **Senha**.
4. Clique em **Enviar&#x20;**&#x70;ara salvar o conjunto de credenciais. Elas são salvas em **Administrador** > **Credenciais**.
:::

:::ExpandableHeading
## Como instalar recursos em dispositivos sem especificar credenciais de dispositivo

1. [Instalar agente manualmente](https://docs.ivanti.com/help/neurons/pt_br/implantacao-do-agente#ManuallyInstall).
2. Navegue até **Agentes** > **Políticas do agente**.
   A página **Políticas do agente** é exibida.
3. Selecione **Ações** > **Editar&#x20;**&#x70;ara a política que foi instalada durante a instalação manual.
   A página **Editar política do agente** é exibida.
4. Na seção **Capacidades**, selecione para ativar as capacidades necessários.
5. Clique em **Salvar&#x20;**&#x70;ara salvar as alterações.
   Na próxima vez que o agente fizer check-in, as alterações na política entrarão em vigor.
:::
