---
title: Gestione agenti
slug: help/neurons/it_it/gestione-agenti
createdAt: 2026-09-08T06:59:24.752Z
---

La pagina Gestione agenti fornisce un elenco di tutti gli endpoint dell'agente. Da qui è possibile visualizzare il criterio assegnato, riassegnare o distribuire nuovamente un criterio, disinstallare un agente e rimuovere un endpoint agente.

I dispositivi vengono visualizzati in questo elenco non appena viene richiesta l'azione **Distribuisci** al dispositivo. Per maggiori informazioni sulla distribuzione su un dispositivo, vedere [Distribuzione agente](docId\:XMKW4keCFC1NXDBQGmbJH).

Per ogni endpoint agente vengono visualizzati il nome dell'endpoint agente, il criterio agente installato, l'integrità, lo stato, la piattaforma e la data/ora di installazione.

## Integrità agente

La colonna **Integrità** mostra lo stato di integrità generale relativo alle capacità dell'agente e ai controlli della piattaforma, per ogni dispositivo:

- **Buono** (verde): l'agente funziona come previsto.
- **Moderato** (ambra): agente funzionante, ma non in stato ottimale.
- **Scarso** (rosso): agente non funzionante.

Lo stato di integrità viene aggiornato automaticamente a ogni check-in dell'agente.

È possibile selezionare il menu a discesa **Check-in agente** per filtrare l'elenco degli endpoint agente in base all'ultimo check-in dell'agente:

- **Entro 7 giorni**: l'agente ha effettuato il check-in con successo negli ultimi 7 giorni.
- **Tra 7 e 90 giorni**: l'agente ha effettuato l'ultimo check-in tra 7 e 90 giorni.
- **Oltre 90 giorni**: l'agente ha effettuato l'ultimo check-in oltre 90 giorni fa.
- **Mai**: l'agente non ha mai effettuato il check-in.
- **Duplicati**: l'agente è stato sostituito da un altro agente che si è registrato con lo stesso nome di endpoint.
  I duplicati possono verificarsi, nella vista Gestione agenti, quando gli endpoint vengono regolarmente reimmaginati. Ivanti Neurons non esegue una pulizia automatica da questa vista. È possibile utilizzare il filtro **Duplicati** per identificare e rimuovere gli endpoint agente duplicati e indesiderati.
- **Tutti**: tutti i check-in degli agenti.
  Quando si seleziona **Tutti** la colonna **Endpoint agente** visualizza un'icona per indicare lo stato di check-in dell'agente:
  - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/eFYiYUKV6b1fKL5H7eXqh_agent-health-late.png" alt caption size="10" width="22" height="22"} **In ritardo**: l'agente non ha effettuato il check-in negli ultimi 7 giorni.
  - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/PmtM8SjFzLGBJ0g1-87nD_agent-health-missing.png" alt caption size="10" width="22" height="22"} **mancante**: l'agente ha effettuato l'ultimo check-in più di 90 giorni fa.
  - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/n3VjiPRY3rBOrKnA2Xfvb_agent-health-never.png" alt caption size="10" width="26" height="23"} **mai**: l'agente non ha mai effettuato il check-in.
  - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/64MRQgnEruT02RmZgX1PX_agent-health-duplicate.png" alt caption size="10" width="22" height="21"} **duplicato**: l'agente è stato sostituito da un altro agente che si è registrato con lo stesso nome di endpoint.

Nella tabella, fare clic sull'indicatore di integrità di un endpoint agente: Buono, Moderato, Scarso, per visualizzare maggiori dettagli. Viene visualizzata la pagina **Integrità agente**. Per maggiori dettagli, consultare [Integrità agente ](docId\:keXhh15q2oJMdbOODqqod).

## Stato agente

La colonna **Stato** fornisce informazioni dettagliate sullo stato dell'endpoint. Per ulteriori dettagli, passare il mouse sull'icona Informazioni sullo stato :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/kxu9WLkHyrTUpa6cLMEHq_info.png" alt="icona i" caption size="10" width="17" height="17"} per qualsiasi endpoint agente.

:::ExpandableHeading{customAnchorSlug="status"}
## Valori Stato

**DeploySuccess**: attivo

**DeployStarted**: distribuzione avviata

**DeployResolved**: distribuzione risolta

**DeployConnected**: distribuzione connessa

**DeployValidated**: distribuzione convalidata

**DeployFilesCopied**: file di distribuzione copiati

**DeployInstallerStarted**: programma di installazione distribuzione avviato

**UserRequestAssignPolicy**: riassegnazione criterio richiesta

**UserRequestDeploy**: distribuzione agente richiesta

**UserRequestRedeploy**: nuova distribuzione agente richiesta

**UserRequestUninstall**: disinstallazione agente richiesta

**ErrorDeployEnrollmentKeyExpired**: chiave di registrazione distribuzione scaduta

**ErrorDeployInvalidCredentials**: credenziali di distribuzione non valide

**ErrorDeployInternal**: errore interno distribuzione

**ErrorDeployNameResolutionFailed**: risoluzione nome distribuzione non riuscita

**ErrorDeployConnectToDevice**: impossibile connettere la distribuzione all'endpoint

**ErrorDeployConnectToRegistry**: impossibile connettere la distribuzione al registro remoto

**ErrorDeployValidationSkipped**: convalida nome host distribuzione ignorata

**ErrorDeployValidation**: convalida nome host distribuzione non riuscita

**ErrorDeployCopyFilesNoInstaller**: programma di installazione agente di distribuzione non disponibile

**ErrorDeployCopyFilesFailed**: la distribuzione non è riuscita a copiare i file nell'endpoint

**ErrorDeployInstallerRemoteService**: la distribuzione non è riuscita a creare il servizio remoto

**ErrorDeployStartInstaller**: la distribuzione non è riuscita ad avviare il programma di installazione
:::

## Azioni

### Riassegna criterio

Per assegnare un criterio diverso a un endpoint agente.

1. Selezionare la casella di controllo accanto all'endpoint dell'agente a cui si desidera riassegnare un criterio.
2. Selezionare **Azioni&#x20;**> **Riassegna criterio**.
   Viene visualizzato il pannello **Riassegna criterio**.
3. Selezionare un **Criterio agente** dal menu a discesa, oppure immettere il nome del criterio per filtrare l'elenco. In alternativa, selezionare **Usa assegnazione criteri automatica** dall'elenco a discesa.
   Quando si riassegna un criterio agente con la configurazione di assegnazione automatica dei criteri, le eccezioni del dispositivo esistenti verranno rimosse e i relativi criteri verranno assegnati automaticamente con il nuovo criterio al termine del processo di valutazione dei criteri.
4. Fare clic su **Salva**.
   Il pannello **Riassegna criterio** si chiude.
5. Nella pagina **Gestione agenti**, lo stato si aggiorna a **Riassegnazione criterio richiesta**. Passare il mouse sullo stato per vedere chi ha richiesto la modifica del criterio, in quale data e il nome del criterio assegnato.

### Ridistribuisci agente

Per ridistribuire un agente.

1. Selezionare la casella di controllo accanto all'endpoint dell'agente per il quale si desidera riprovare una nuova distribuzione.
2. Selezionare **Azioni&#x20;**> **Ridistribuisci agente**.
   Viene visualizzato il pannello **Ridistribuisci agente**.
3. Selezionare il **Criterio agente** che si desidera distribuire, oppure immettere il nome del criterio per filtrare l'elenco.
4. Selezionare la **Chiave di registrazione**, oppure immettere il nome per filtrare l'elenco. Se si desidera utilizzare una nuova chiave, selezionare **Crea nuova chiave**: viene visualizzato il pannello [Crea chiave di registrazione](docId\:L5DZxAYpDx2e8wwDxavXW).
5. Selezionare l'endpoint agente che si desidera utilizzare per **Distribuisci da**, oppure immettere il nome per filtrare l'elenco. Il menu a discesa elenca gli endpoint agente disponibili che hanno un criterio con la funzionalità Distribuzione abilitata.
6. Se non ci sono credenziali valide, è disponibile il menu a discesa Credenziali. Selezionare la **Credenziale** per l'endpoint agente. Oppure, selezionare **Crea nuova credenziale**: viene visualizzato il pannello [Nuova credenziale](docId\:XMKW4keCFC1NXDBQGmbJH).
7. Fare clic su **Distribuisci di nuovo** per tentare nuovamente la distribuzione.

### Disinstalla agente

Per disinstallare l'Agente.

1. Selezionare la casella di controllo accanto all'endpoint dell'agente da cui si desidera disinstallare l'agente.
2. Selezionare **Azioni&#x20;**> **Disinstalla agente**.
   Viene visualizzata la finestra di dialogo **Disinstalla agente**.
3. Fare clic su **Disinstalla**.
   L'agente viene disinstallato e l'endpoint agente non è più visibile nell'elenco della pagina Gestione agenti quando viene aggiornato.

::::ExpandableHeading
## Disinstalla manualmente agente

:::ExpandableHeading
## Microsoft Windows

- Per disinstallare un Ivanti Neurons Agent su un endpoint Microsoft Windows, eseguire il seguente comando:
  `C:\Program Files\Ivanti\Ivanti Cloud Agent\STAgentManagement.exe -uninstall`
- Il registro di disinstallazione è presente qui:
  `C:\ProgramData\Ivanti\Ivanti Cloud Agent\Logs\AGENT_uninstall.log`
- Per una panoramica e una spiegazione dei possibili parametri, eseguire il seguente comando:
  `C:\Program Files\Ivanti\Ivanti Cloud Agent\STAgentManagement.exe /?`

Per informazioni aggiuntive, vedere questo articolo nella Community: [Come disinstallare l'Ivanti Neurons Agent](https://forums.ivanti.com/s/article/How-To-Manually-Uninstall-the-Ivanti-Cloud-Agent).
:::

:::ExpandableHeading
## Apple macOS

1. Per disinstallare un Ivanti Neurons Agent su un endpoint Apple macOS, eseguire il seguente comando dal terminale o utilizzando un'applicazione di gestione del dispositivo:
   `/usr/local/com.ivanti.cloud.agent/IvantiAgent/bin/stagentctl uninstall`
2. Accedere a **Utenti e Gruppi** nelle impostazioni di sistema del computer ed eliminare l'account `_ivantiNeuronsMacPatchAgent`.
   In alternativa, utilizzare il comando `sudo sysadminctl -deleteUser _ivantiNeuronsMacPatchAgent`.

- Non viene lasciato alcun log di disinstallazione.
- Per una panoramica e una spiegazione dei possibili parametri, eseguire il seguente comando:
  `/usr/local/com.ivanti.cloud.agent/IvantiAgent/bin/stagentctl`

Per informazioni aggiuntive, vedere questo articolo nella Community: [Come disinstallare manualmente l'agente macOS Neurons](https://forums.ivanti.com/s/article/How-to-manually-uninstall-macOS-Neurons-Agent).
:::

:::ExpandableHeading
## Linux

- Per disinstallare un Ivanti Neurons Agent su un endpoint Linux, eseguire il seguente comando:
  `yum remove ivanticloudagent`
- Il registro di disinstallazione è presente qui:
  `/opt/ivanti/cloudagent`
:::
::::

### Rimuovi endpoint agente

Quando un agente è stato disinstallato manualmente da un endpoint, o se lo stato non procede, è necessario rimuoverlo dall'elenco Endpoint agente.

1. Selezionare la casella di controllo accanto all'endpoint dell'agente che si desidera rimuovere dall'elenco.
2. Selezionare **Azioni&#x20;**> **Rimuovi endpoint agente**.
   Viene visualizzata la finestra di dialogo di conferma **Rimuovi endpoint agente**.
3. Fare clic su **Rimuovi**.
   L'endpoint agente viene rimosso e non è più visibile nell'elenco della pagina Gestione agenti.

:::ExpandableHeading
## Come identificare e rimuovere gli agenti inattivi dai dispositivi

1. Navigare in **Agenti&#x20;**> **Gestione agenti**.
   Viene visualizzata la pagina **Gestione agenti**.
2. La colonna **Stato&#x20;**&#x69;ndica se l'agente è inattivo. Selezionare la casella di controllo per gli endpoint agente da cui si desidera rimuovere l'agente.
3. Selezionare **Azioni&#x20;**> **Disinstalla agente**.
   Viene visualizzata la finestra di dialogo di conferma **Disinstalla agente**.
4. Fare clic su **Disinstalla&#x20;**&#x70;er confermare l'azione.
:::
