---
title: Distribuzione agente
slug: help/neurons/it_it/distribuzione-agente
createdAt: 2026-09-08T06:59:24.678Z
---

L'agente Ivanti Neurons è necessario per utilizzare la piattaforma Ivanti Neurons. Utilizzare le schede seguenti per assegnare criteri e inviare un agente a un endpoint:

- **Assegnazione automatica dei criteri**: selezionare per gestire e assegnare automaticamente i criteri ai dispositivi nell'ambiente in base alle regole configurabili.
- **Installazione push di Neurons**: selezionare per scaricare l'agente e distribuirlo ai dispositivi di destinazione.
- **Installazione manuale**: selezionare per scaricare l'agente e installarlo manualmente tramite la riga di comando su ogni dispositivo di destinazione.

## Assegnazione automatizzata dei criteri

L'assegnazione automatizzata dei criteri (APA) gestisce e assegna automaticamente i criteri ai dispositivi nell'ambiente in base a regole configurabili. Con APA, gli amministratori possono semplificare e centralizzare la gestione dei criteri, garantendo che ai dispositivi sia sempre assegnato il criterio corretto in base a criteri organizzativi, gruppi di dispositivi, eccezioni e altri attributi.

È possibile utilizzare la funzione APA per sfruttare le seguenti funzioni chiave per l'assegnazione dei criteri agli endpoint:

- **Assegnazione basata su regole:** i criteri vengono assegnati ai dispositivi in base a regole personalizzabili.
- **Gestione gruppi ed eccezioni:** i dispositivi possono essere raggruppati e le eccezioni possono essere configurate.
- **Modalità manuali e automatizzate**: passaggio da assegnazioni di criteri manuali a automazione basata su regole al proprio ritmo.
- **Cool-down di 24 ore**: limita le riassegnazioni dei criteri per evitare instabilità e utilizzo delle risorse.

Per distribuire APA, è necessario configurare inizialmente l'assegnazione dei criteri. Per maggiori informazioni sulla configurazione dell'APA, fare riferimento a [Configurazione dell'assegnazione automatizzata dei criteri](https://docs.ivanti.com/help/neurons/it_it/configura-assegnazione-automatizzata-dei-criteri).

## Installazione manuale dell'agente

Per installare manualmente un agente Ivanti Neurons, procedere come segue:

1. Andare su **Agenti** > **Distribuzione agenti**, sul riquadro **Installazione manuale**, fare clic su **Per iniziare**.
   Viene visualizzata la pagina **Installa manualmente un agente**.
2. **Scegliere il criterio agente**: dal menu a discesa, selezionare il **Criterio agente** che si desidera assegnare all'agente, oppure iniziare a digitare il nome del criterio per filtrare l'elenco a discesa.
   In alternativa, selezionare l'opzione **Usa assegnazione criteri automatica** dall'elenco a discesa per utilizzare la distribuzione basata su APA.
   I Criteri agente sono creati in **Agenti&#x20;**> **Criteri agente**.
3. **Scegliere la chiave di registrazione**: dal menu a discesa, selezionare la **Chiave di registrazione** che si desidera utilizzare per registrare l'agente. In alternativa, per utilizzare una nuova chiave, selezionare **Crea nuova chiave**. Viene visualizzato il pannello [Crea chiave di registrazione](https://docs.ivanti.com/help/neurons/it_it/chiavi-di-registrazione#create-enrollment-key).
   Le chiavi di registrazione vengono create in **Agenti&#x20;**> **Chiavi di registrazione**.


:::hint{type="info"}
Se si utilizza la funzione di assegnazione automatica dei criteri per la distribuzione dell'agente, verrà utilizzata una chiave generata automaticamente incorporata per registrare l'agente con il tenant. La chiave di registrazione è impostata su **Autogenerata** per impostazione predefinita. È inoltre possibile utilizzare il proprio codice di registrazione cliente, se necessario.
:::

4. **Scegliere il sistema endpoint host**: selezionare il sistema operativo del dispositivo su cui si sta installando l'agente: 

:::ExpandableHeading
## Microsoft Windows

Selezionare il riquadro **Windows** per installare un agente Ivanti Neurons su un endpoint Microsoft Windows, quindi scegliere il metodo di installazione preferito:

- **Installazione interattiva**
  1. In **Modalità installazione**, selezionare **Interattiva**.
  2. Fare clic su **Download**.
     Vengono scaricati due file:
     - IvantiCloudAgent - il file di installazione dell'agente (`.exe`)
     - IvantiCloudAgent.exe.options - le impostazioni di configurazione (`.options`).
  3. Assicurarsi che i due file scaricati si trovino nella stessa cartella ed eseguire il file eseguibile.
- **Installazione invisibile**
  1. In **Modalità installazione**, selezionare **Invisibile**.
  2. Fare clic su **Download**.
  3. Copiare il **Comando** e utilizzarlo con i parametri di installazione nel file delle opzioni per eseguire il file di installazione.
:::

:::ExpandableHeading
## Apple macOS

Selezionare il riquadro **macOS** per installare un agente Ivanti Neurons su un endpoint Apple macOS, quindi scegliere il metodo di installazione preferito:

- **Installazione interattiva**
  1. In **Modalità installazione**, selezionare **Interattiva**.
  2. Fare clic su **Download**.
  3. Sull'endpoint, distribuire e montare l'immagine del disco di installazione dell'agente (`.dmg`).
  4. Eseguire il pacchetto di installazione (`.pkg`).
  5. Una volta installato l'agente, copiare il **Comando** ed eseguirlo da un terminale per configurare l'agente.
- **Installazione invisibile**
  1. I&#x6E;**&#x20;Modalità installazione**, selezionare **Invisibile**.
  2. Fare clic su **Download**.
  3. Sull'endpoint, distribuire l'eseguibile.
  4. Copiare il **Comando** e utilizzarlo con i parametri di installazione nel file delle opzioni per eseguire il file di installazione.

Durante l'installazione dell'agente Neurons sui dispositivi macOS appariranno diverse finestre di dialogo per le autorizzazioni e le notifiche, che potrebbero includere l'uso dei servizi di posizione per il [sensore di posizione](https://docs.ivanti.com/help/neurons/it_it/impostazioni-edge-intelligence#Generic). Queste autorizzazioni e notifiche devono essere impostate e/o consentite affinché l'agente funzioni correttamente.
È possibile trovare i profili MDM per impostare la maggior parte di queste autorizzazioni in anticipo sulla Community Ivanti, nell'articolo della KB [Profili MDM per Ivanti Neurons](https://forums.ivanti.com/s/article/MDM-Profiles-for-Ivanti-Neurons).
:::

::::ExpandableHeading
## Linux

:::hint{type="info"}
Prima di installare Ubuntu 24, gli utenti devono installare un pacchetto dipendente `libltdl-dev`, utilizzando il comando
`sudo apt install -y libltdl-dev`
:::

Selezionare il riquadro **Linux** per installare un agente Ivanti Neurons su un endpoint Linux, quindi scegliere la versione di Linux:

1. Dal menu a discesa **Versione**, selezionare la distribuzione Linux applicabile.
2. Fare clic su **Download**.
3. Sull'endpoint, aprire una shell come root e navigare nel file di installazione scaricato (`.sh`).
4. Rendere il file di installazione eseguibile.
5. Eseguire il file di installazione:
   `bash <filename>.sh`

### Registrazione debug

I super amministratori hanno la possibilità di abilitare o disabilitare i log di debug del motore P2Z tramite la riga di comando. Il super amministratore deve stabilire una connessione SSH alla macchina dell'agente ed eseguire i seguenti comandi con privilegi di super utente.

- Per abilitare i registri di debug utilizzare il comando sul terminale: `touch /opt/ivanti/isec/data/agentPatchP2ZEnableDebugLog`
- Per disabilitare i log di debug utilizzare il comando sul terminale: `rm -f /opt/ivanti/isec/data/agentPatchP2ZEnableDebugLog`

### Note importanti per il processo di installazione di Linux e le modifiche al sistema

**Creazione utente**

- Il processo di installazione crea un solo utente: '**ivanticloudagent**'.
- Questo utente viene rimosso quando l'agente viene disinstallato.
- L'agente Ivanti Cloud non crea altri utenti in nessun caso.
- L'utente 'ivanticloudagent':
  - Presenta la propria home directory dove è installato l'agente
  - Questa cartella è di proprietà di root con 755 autorizzazioni
  - L'utente può cercare in questa directory, ma non può apportare modifiche
  - Impossibile accedere (nessuna password o shell di accesso predefinita)

**Modifiche al sistema**: l'installazione di Ivanti Cloud Agent NON apporta alcuna modifica a:

- Configurazione Sudoers
- Parametri di controllo del sistema (sysctl)
- Definizioni dei servizi (ad eccezione del proprio servizio)
- Autorizzazioni di sistema
- Qualsiasi altra impostazione a livello di sistema

**Configurazione servizio**

- Un file di servizio viene creato in '/lib/systemd/system/ivanticloudagent.service'
- Il servizio rimane inattivo fino a quando l'agente non viene registrato con successo
- Una volta registrato, il servizio:
  - Attiverà e avvierà l'agente
  - Riavvierà l'agente se si arresta a causa di un errore
- Il servizio non ha dipendenze da altri servizi di sistema
- Si avvia solo quando il sistema si avvia in modalità multiutente
- Il servizio utilizza '/opt/ivanti/cloudagent/run/agent' come directory di lavoro
- Il programma di avvio per questo servizio è 'stagentd'
::::

Dopo che l'agente è stato installato sull'endpoint, i dettagli del dispositivo sono elencati nel menu principale > **Dispositivi**.

:::hint{type="success"}
Se si utilizza un software di distribuzione (come Ivanti Endpoint Manager) che invia gli argomenti separatamente, ricordarsi di rimuovere il nome del file dell'agente dal testo copiato prima di incollarlo nel software di distribuzione. Per i dettagli su come utilizzare Ivanti Endpoint Manager per distribuire l'Ivanti Neurons Agent, vedere [Come distribuire un agente Ivanti Neurons mediante Endpoint Manager](https://forums.ivanti.com/s/article/How-to-deploy-an-Ivanti-Cloud-agent-using-Ivanti-Endpoint-Manager).
:::

## Distribuzione dell'agente con installazione push Neurons

:::hint{type="info"}
Assicurarsi che il nome del dispositivo, l'indirizzo IP e le informazioni sul sistema operativo siano disponibili per il dispositivo, in modo che possano essere selezionati o visualizzati dall'elenco durante un'installazione push.
:::

Per distribuire e installare un agente Ivanti Neurons su un endpoint con Ivanti Neurons, procedere come segue:

1. Andare su **Agenti** > **Distribuzione agenti**, sul riquadro **Installazione push di Neurons**, fare clic su **Per iniziare**.
   Viene visualizzata la pagina **Distribuisci con Ivanti Neurons**.

### Impostazioni di distribuzione

**Criterio agente**: dal menu a discesa, selezionare il **Criterio agente** che si desidera assegnare all'agente, oppure iniziare a digitare il nome del criterio per filtrare l'elenco a discesa. In alternativa, selezionare l'opzione **Usa assegnazione criteri automatica** dall'elenco a discesa per utilizzare la distribuzione basata su APA.
I Criteri agente sono creati in **Agenti&#x20;**> **Criteri agente**.

3. **Chiave di registrazione (attivazioni rimanenti)**: dal menu a discesa, selezionare la **Chiave di registrazione** che si desidera assegnare all'agente, oppure iniziare a digitare il nome della chiave di registrazione per filtrare l'elenco a discesa. Assicurarsi di disporre di un numero di attivazioni sufficiente per il numero di dispositivi che si desidera distribuire.
   In alternativa, per utilizzare una nuova chiave, selezionare **Crea nuova chiave**. Viene visualizzato il pannello [Crea chiave di registrazione](https://docs.ivanti.com/help/neurons/it_it/chiavi-di-registrazione#create-enrollment-key).
   Le chiavi di registrazione vengono create in **Agenti&#x20;**> **Chiavi di registrazione**.


:::hint{type="info"}
Se si utilizza la funzione di assegnazione automatica dei criteri per la distribuzione dell'agente, verrà utilizzata una chiave generata automaticamente incorporata per registrare l'agente con il tenant. La chiave di registrazione è impostata su **Autogenerata** per impostazione predefinita. È inoltre possibile utilizzare il proprio codice di registrazione cliente, se necessario.
:::

4. **Distribuisci da**: selezionare l'endpoint da utilizzare per la distribuzione. Se esiste almeno uno, ma meno di 500 endpoint agente con la funzionalità Distribuzione abilitata, l'opzione **Automatica** è la selezione predefinita. È possibile selezionare un endpoint specifico dall'elenco a discesa, oppure iniziare a digitare il nome dell'endpoint per filtrare l'elenco a discesa. Solo gli endpoint in cui è installato l'agente e in cui è abilitata la funzionalità di Distribuzione sono disponibili per la selezione.

### Elenca dispositivi

La sezione **Elenca dispositivi** elenca tutti i dispositivi che hanno un nome, un indirizzo IP e un sistema operativo nella vista principale **Dispositivi** di Neurons.

:::hint{type="info"}
Gli endpoint VDI non persistenti non sono attualmente disponibili per la selezione. Per applicare le modifiche, questi endpoint devono essere desigillati, aggiornati e quindi risigillati. Invece, distribuire il criterio agente direttamente nell'immagine NP-VDI. Per maggiori informazioni sulla VDI, vedere [Infrastruttura dispositivo virtuale non persistente (NP-VDI)](https://docs.ivanti.com/help/neurons/it_it/infrastruttura-dispositivo-virtuale-non-persistente-np-vdi) e [Interfaccia dispositivo virtuale persistente (VDI) e Dispositivi clonati con immagine Gold](https://docs.ivanti.com/help/neurons/it_it/infrastruttura-dispositivo-virtuale-persistente-vdi-e-dispositivi-clonati-con-immagine-gold).
:::

L'impostazione predefinita è **Tutti i dispositivi**. È possibile filtrare l'elenco in base ai seguenti criteri o utilizzare la funzione di ricerca per individuare un dispositivo specifico:

:::Paragraph{listStyleType="disc" indent="2"}
**Tutti i dispositivi** (predefinito), Gruppi di dispositivi predefiniti: **Gestione EPM**, **Gestione cloud**, **Portatile**, gruppi di dispositivi pubblici o gruppi di dispositivi privati (creati in **Dispositivi**).
:::

:::Paragraph{listStyleType="disc" indent="2"}
**Con** o **Senza agenti**.
:::

6. **Selezionare** la casella di controllo per ogni dispositivo su cui si desidera distribuire l'agente.
7. Fare clic su **Aggiungi** per aggiungere i dispositivi sorgente selezionati alla sezione **Dispositivi di destinazione**.

### Dispositivi di destinazione

La sezione **Dispositivi di destinazione** elenca tutti i dispositivi aggiunti dalla sezione **Dispositivi di origine**. Questi sono i dispositivi selezionati per la distribuzione dell'agente.
Vengono visualizzati il nome del dispositivo, l'indirizzo IP e il sistema operativo del record **Dispositivi**.
Fare clic su **Distribuisci** per avviare la distribuzione su tutti i dispositivi di destinazione.
Lo stato di distribuzione è visibile nella colonna [Stato](https://docs.ivanti.com/help/neurons/it_it/gestione-agenti#status) della pagina **Gestione agenti**.

9. Per rimuovere un dispositivo dall'elenco di destinazione, selezionare la casella di controllo accanto al dispositivo e fare clic su **Rimuovi**. In alternativa, fare clic su **Rimuovi tutto** per rimuovere tutti i dispositivi dall'elenco di destinazione.

### Credenziali

Le credenziali dispositivo sono necessarie all'agente per eseguire azioni su un dispositivo che richiedono privilegi elevati o per eseguire la scansione di altri dispositivi sulla rete. Non è possibile procedere con la distribuzione finché non sono state aggiunte le credenziali per il sistema operativo in questione. La scheda **Credenziali&#x20;**&#xE8; evidenziata in rosso finché non si risolve il problema.
Impostare le credenziali per il sistema operativo in questione: **Windows**, **macOS**, **Linux**. Dall'elenco a discesa, selezionare una credenziale. Per creare nuove credenziali, selezionare **Crea nuova credenziale**. Viene visualizzato il pannello **Nuova credenziale**.

:::ExpandableHeading{customAnchorSlug="Create-credential"}
## Crea nuova credenziale

1. Inserire il **Nome** per le nuove credenziali. È possibile fornire una descrizione opzionale.
2. Inserire il **Nome utente**.
3. Inserire la **Password**.
4. Fare clic su **Invia** per salvare i dettagli delle credenziali. Queste vengono salvate in **Amministratore** > **Credenziali**.
:::

:::ExpandableHeading
## Come installare le funzionalità sui dispositivi senza specificare le credenziali del dispositivo

1. [Installazione manuale dell'agente](https://docs.ivanti.com/help/neurons/it_it/distribuzione-agente#ManuallyInstall).
2. Navigare in **Agenti** > **Criteri agente**.
   Viene visualizzata la pagina **Criteri agente**.
3. Selezionare **Azioni** > **Modifica&#x20;**&#x70;er il criterio installato durante l'installazione manuale.
   Viene visualizzata la pagina **Modifica criterio agente**.
4. Nella sezione **Funzionalità**, selezionare per abilitare le funzionalità richieste.
5. Fare clic su **Salva** per salvare le modifiche.
   Le modifiche al criterio avranno effetto al successivo check-in dell'agente.
:::
