---
title: Gerenciamento de agentes
slug: help/neurons/pt_br/gerenciamento-de-agentes
createdAt: 2026-09-08T07:53:20.372Z
---

A página Gerenciamento de Agentes fornece uma lista de todos os pontos de extremidade do agente. A partir dela, você pode visualizar a política atribuída, reatribuir ou reimplantar uma política, desinstalar um agente e remover um ponto de extremidade do agente.

Os dispositivos são exibidos nessa lista assim que a ação **Implantar** for solicitada ao dispositivo. Para saber mais sobre como implantar em um dispositivo, consulte [Implantação do agente](https://docs.ivanti.com/help/neurons/pt_br/implantacao-do-agente).

Para cada ponto de extremidade do agente são exibidos o respectivo nome, a política instalada, a integridade, o status, a plataforma e a data/hora de instalação.

## Integridade do agente

A coluna **Integridade** mostra o status geral de integridade relacionado às capacidades do agente e às verificações da plataforma, para cada dispositivo:

- **Bom(a)** (verde): agente funcionando conforme esperado.
- **Moderado(a)** (âmbar): agente funcionando, mas não em estado ideal.
- **Ruim** (vermelho): agente não funciona.

O status de integridade é atualizado automaticamente em cada check-in do agente.

Você pode selecionar o item suspenso **Check-in do agente** para filtrar a lista de pontos de extremidade pelo último check-in do agente:

- **Em até 7 dias**: o agente fez check-in nos últimos 7 dias.
- **Entre 7 e 90 dias**: o último check-in do agente foi entre 7 e 90 dias.
- **Mais de 90 dias**: o último check-in do agente foi há mais de 90 dias.
- **Nunca**: o agente nunca fez check-in.
- **Duplicatas**: o agente foi substituído por outro agente registrado com o mesmo nome de ponto de extremidade.
  Duplicadas podem ocorrer, na exibição Gerenciamento de Agentes, quando houver recriação regular de imagem dos pontos de extremidade. O Ivanti Neurons não realiza limpeza automática nessa exibição. Você pode usar o filtro **Duplicatas** para identificar e remover pontos de extremidade duplicados e indesejados.
- **Tudo**: todos os check-ins do agente.
  Quando **Tudo** estiver selecionado, a coluna **Ponto de extremidade do agente** exibirá um ícone para indicar o estado de check-in do agente:
  - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/M0N4UsiAyXJdAQc8jgRvx_agent-health-late.png" alt caption size="10" width="22" height="22"} **atrasado**: o agente não fez check-in nos últimos 7 dias.
  - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/OQ7kCOosg0u5U0kX0_U8U_agent-health-missing.png" alt caption size="10" width="22" height="22"} **ausente**: o último check-in do agente foi há mais de 90 dias.
  - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/JMKFN0LaxiCYyW50gX01j_agent-health-never.png" alt caption size="10" width="26" height="23"} **nunca**: o agente nunca fez check-in.
  - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/vX63ryMVm9QLY9pt1rx5Q_agent-health-duplicate.png" alt caption size="10" width="22" height="21"} **duplicata**: o agente foi substituído por outro agente registrado com o mesmo nome de ponto de extremidade.

Na tabela, clique no indicador de integridade de um ponto de extremidade do agente (Bom(a), Moderado(a), Ruim) para visualizar mais detalhes. A página **Integridade do agente** é exibida. Consulte [Integridade do agente ](https://docs.ivanti.com/help/neurons/pt_br/integridade-do-agente)para obter mais detalhes.

## Status do agente

A coluna **Status** fornece detalhes sobre o estado do ponto de extremidade. Passe o mouse sobre o ícone de informações de status :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/AsbburL5sskzIIPm_HVVO_info.png" alt="ícone i" caption size="10" width="17" height="17"} de qualquer ponto de extremidade do agente para obter mais detalhes.

:::ExpandableHeading{customAnchorSlug="status"}
## Valores de status

**DeploySuccess**: ativo

**DeployStarted**: implantação iniciada

**DeployResolved**: implantação resolvida

**DeployConnected**: implantação conectada

**DeployValidated**: implantação validada

**DeployFilesCopied**: arquivos copiados de implantação

**DeployInstallerStarted**: instalador de implantação iniciado

**UserRequestAssignPolicy**: reatribuição de política solicitada

**UserRequestDeploy**: implantação de agente solicitada

**UserRequestRedeploy**: reimplantação de agente solicitada

**UserRequestUninstall**: desinstalação de agente solicitada

**ErrorDeployEnrollmentKeyExpired**: a chave de inscrição da implantação expirou

**ErrorDeployInvalidCredentials**: credenciais de implantação inválidas

**ErrorDeployInternal**: erro interno de implantação

**ErrorDeployNameResolutionFailed**: falha na resolução do nome de implantação

**ErrorDeployConnectToDevice**: implantação incapaz de se conectar ao ponto de extremidade

**ErrorDeployConnectToRegistry**: implantação incapaz de se conectar ao registro remoto

**ErrorDeployValidationSkipped**: validação do nome do host da implantação ignorada

**ErrorDeployValidation**: falha na validação do nome do host da implantação

**ErrorDeployCopyFilesNoInstaller**: instalador do agente de implantação indisponível

**ErrorDeployCopyFilesFailed**: implantação incapaz de copiar arquivos para o ponto de extremidade

**ErrorDeployInstallerRemoteService**: implantação incapaz de criar o serviço remoto

**ErrorDeployStartInstaller**: implantação incapaz de iniciar o instalador
:::

## Ações

### Reatribuir política

Para atribuir uma política diferente a um ponto de extremidade do agente.

1. Marque a caixa de seleção ao lado do ponto de extremidade do agente ao qual você deseja reatribuir uma política.
2. Selecione **Ações&#x20;**> **Reatribuir política**.
   O painel **Reatribuir política** aparece.
3. Selecione uma **Política do Agente** no menu suspenso ou insira o nome da política para filtrar a lista. Ou selecione **Usar atribuição automatizada de política** na lista suspensa.
   Quando você reatribuir uma política de agente com a configuração de atribuição automatizada, as exceções de dispositivo existentes serão removidas, e a nova política será atribuída automaticamente aos dispositivos assim que o processo de avaliação for concluído.
4. Clique em **Salvar**.
   O painel **Reatribuir política** é fechado.
5. Na página **Gerenciamento de Agentes**, o Status é atualizado para **Reatribuição de política solicitada**. Passe o mouse sobre o status para ver quem solicitou a alteração da política, em que data e o nome da política atribuída.

### Reimplantar agente

Para reimplantar um agente.

1. Marque a caixa de seleção ao lado do ponto de extremidade do agente para o qual você deseja tentar a reimplantação.
2. Selecione **Ações&#x20;**> **Reimplantar Agente**.
   O painel **Reimplantar agente** é exibido.
3. Selecione a **Política do Agente** que você deseja implantar ou insira o nome da política para filtrar a lista.
4. Selecione a **Chave de inscrição** ou digite o nome para filtrar a lista. Se quiser 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) é exibido.
5. Selecione o ponto de extremidade do agente que você deseja usar em **Implementar de** ou insira o nome para filtrar a lista. A lista suspensa apresenta os pontos de extremidade do agente disponíveis que possuem uma política com o recurso de implantação habilitado.
6. Se não houver credenciais válidas, o menu suspenso Credenciais estará disponível. Selecione a **Credencial** para o ponto de extremidade do agente. Ou selecion&#x65;**&#x20;Criar nova credencial**: o painel [Nova credencial](https://docs.ivanti.com/help/neurons/pt_br/implantacao-do-agente#Create-credential) é exibido.
7. Clique em **Reimplantar** para tentar a implantação novamente.

### Desinstalar agente

Para desinstalar o agente.

1. Marque a caixa de seleção ao lado do ponto de extremidade do qual deseja desinstalar o agente.
2. Selecione **Ações&#x20;**> **Desinstalar agente**.
   A caixa de diálogo **Desinstalar agente** é exibida.
3. Clique em **Desinstalar**.
   O agente é desinstalado, e o ponto de extremidade não fica mais visível na lista da página Gerenciamento de Agentes quando atualizada.

::::ExpandableHeading
## Desinstalar manualmente o agente

:::ExpandableHeading
## Microsoft Windows

- Para desinstalar o Agente Ivanti Neurons em um ponto de extremidade com Microsoft Windows, execute o seguinte comando:
  `C:\Program Files\Ivanti\Ivanti Cloud Agent\STAgentManagement.exe -uninstall`
- O log de desinstalação pode ser encontrado em:
  `C:\ProgramData\Ivanti\Ivanti Cloud Agent\Logs\AGENT_uninstall.log`
- Para obter o resumo e a explicação dos parâmetros possíveis, execute o seguinte comando:
  `C:\Program Files\Ivanti\Ivanti Cloud Agent\STAgentManagement.exe /?`

Para obter informações adicionais, consulte este artigo na Comunidade: [Como desinstalar o Agente Ivanti Neurons](https://forums.ivanti.com/s/article/How-To-Manually-Uninstall-the-Ivanti-Cloud-Agent).
:::

:::ExpandableHeading
## Apple macOS

1. Para desinstalar o Agente Ivanti Neurons em um ponto de extremidade com Apple macOS, execute o seguinte comando no Terminal ou usando um aplicativo de gerenciamento de dispositivos:
   `/usr/local/com.ivanti.cloud.agent/IvantiAgent/bin/stagentctl uninstall`
2. Navegue até **Grupos de usuários** nas configurações do sistema na máquina e exclua a conta `ivantiNeuronsMacPatchAgent`.
   Como alternativa, use o comando `sudo sysadminctl -deleteUser _ivantiNeuronsMacPatchAgent`.

- Nenhum log de desinstalação é deixado para trás.
- Para obter o resumo e a explicação dos parâmetros possíveis, execute o seguinte comando:
  `/usr/local/com.ivanti.cloud.agent/IvantiAgent/bin/stagentctl`

Para obter informações adicionais, consulte este artigo na Comunidade: [Como desinstalar manualmente o Agente Neurons para macOS](https://forums.ivanti.com/s/article/How-to-manually-uninstall-macOS-Neurons-Agent).
:::

:::ExpandableHeading
## Linux

- Para desinstalar o Agente Ivanti Neurons em um ponto de extremidade Linux, execute o seguinte comando:
  `yum remove ivanticloudagent`
- O log de desinstalação pode ser encontrado em:
  `/opt/ivanti/cloudagent`
:::
::::

### Remover ponto de extremidade do agente

Quando um agente tiver sido desinstalado manualmente de um ponto de extremidade, ou se o status não estiver progredindo, será necessário removê-lo da lista de pontos de extremidade do agente.

1. Marque a caixa de seleção ao lado do ponto de extremidade do agente que você deseja remover da lista.
2. Selecione **Ações&#x20;**> **Remover ponto de extremidade do agente**.
   O diálogo de confirmação **Remover ponto de extremidade do agente** é exibido.
3. Clique em **Remover**.
   O ponto de extremidade do agente é removido e não aparece mais na lista da página Gerenciamento de Agentes.

:::ExpandableHeading
## Como identificar e remover agentes inativos de dispositivos

1. Navegue até **Agentes&#x20;**> **Gerenciamento de Agentes**.
   A página **Gerenciamento de Agentes** é exibida.
2. A coluna **Status&#x20;**&#x69;ndica se o agente está inativo. Marque a caixa de seleção dos pontos de extremidade dos quais você deseja remover o agente.
3. Selecione **Ações&#x20;**> **Desinstalar agente**.
   O diálogo de confirmação **Desinstalar agente** é exibido.
4. Clique em **Desinstalar&#x20;**&#x70;ara confirmar a ação.
:::
