---
title: Impostazioni distribuzione
slug: help/neurons/it_it/impostazioni-distribuzione
createdAt: 2026-09-08T06:59:25.680Z
---

Utilizzare la pagina **Distribuzione > Impostazioni** per configurare i mapping dei codici restituiti delle app. Le azioni dei pacchetti eseguibili e di script possono restituire un codice numerico positivo o negativo all'uscita che indica vari risultati. Questi codici restituiti influenzano lo stato dell'app e determinano se un'azione ha successo, non riesce o richiede un riavvio.

Utilizzare le mappature personalizzate dei codici restituiti per personalizzare il risultato delle azioni EXE, MSI e script. Ad esempio, l'utilità Robocopy di Microsoft ha diversi codici restituiti che indicano il successo. Per impostazione predefinita, un codice restituito dell'eseguibile non zero indica una mancata riuscita. È possibile creare un mapping personalizzato dei codici restituiti per Robocopy, in modo che questi codici restituiti non zero vengano convertiti in un successo, consentendo così di continuare l'elaborazione del pacchetto.

I codici restituiti vengono memorizzati in un registro sul dispositivo come parte di ciascuna distribuzione. Per maggiori informazioni sui registri e su come accedervi, vedere [Registrazione delle regole di rilevamento e delle azioni](https://docs.ivanti.com/help/neurons/it_it/azioni-e-regole-di-rilevamento-dei-pacchetti-di-distribuzione#Detection_rule_logs).

Oltre ad avere codici restituiti numerici memorizzati nel registro, è possibile mappare tali codici restituiti in stringhe informative. Queste stringhe che descrivono i codici restituiti appariranno anche nel registro.

Esistono tre tipi di modelli di codici restituiti:

- Nuovi modelli creati dall'utente.
- Copie clonate di un modello esistente. Per clonare un modello esistente, utilizzare il menu opzioni ( :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/rGC1lmr-E7TAm-TOP1LZQ_general-options-menu.png" alt caption size="10" width="4" height="12"} ) a destra del modello.
- Modelli predefiniti che non possono essere modificati o eliminati, se non per contrassegnarne uno come modello predefinito. È possibile modificare una copia clonata.

Questi sono i modelli di codice restituito predefiniti. Il comportamento predefinito per i codici restituiti non mappati in questi modelli è la mancata riuscita.

- **Modello di sistema - MSI predefinito**: contiene l'insieme standardizzato di codici restituiti MSI. Sono preconfigurati per l'utente.
- **Modello di sistema - EXE predefinito**: contiene un mapping del codice restituito per il numero zero, che indica il successo.
- **Modello di sistema - PowerShell predefinito**: contiene due mapping del codice restituito. Il numero zero indica il successo e il numero uno la mancata riuscita.

È possibile contrassegnare un modello di ciascun tipo, MSI, EXE e PowerShell, come predefinito. L'elenco **Mapping codici restituiti** ha una colonna che mostra quali modelli sono predefiniti. Per modificare un'impostazione predefinita, modificare il modello e selezionare l'opzione.

Quando si crea un'azione del pacchetto che supporta un modello di codice restituito, il valore predefinito viene preselezionato per l'utente. Se non si desidera utilizzare il modello predefinito, è possibile scegliere tra altri modelli per quel tipo di azione. Le modifiche apportate ai modelli diventano effettive la volta successiva in cui l'engine di distribuzione viene eseguito sul client.

I modelli di codice restituito MSI includono un mapping del codice restituito per 3010, Operazione riuscita - Riavvio richiesto. Il risultato è lo stesso di Operazione riuscita, ma con una nota nel registro del dispositivo per la distribuzione che richiede un riavvio a un certo punto. Lo stato di distribuzione mostrerà anche "Operazione riuscita (riavvio richiesto)" per quel pacchetto.

**Per creare o modificare un modello di codice restituito**

1. Selezionare **Crea nuovo** e il tipo di modello desiderato, oppure selezionare un modello esistente. I modelli di sistema preconfigurati sono di sola lettura.
2. Inserire un **Nome modello** e una **Descrizione**.
3. In **Rendi questo modello il predefinito**, selezionare **True** se si desidera che questo modello sia il predefinito per il tipo di modello selezionato (ad esempio EXE o PowerShell).
4. Selezionare l'opzione **Risultato predefinito** per i codici restituiti non mappati. L'impostazione predefinita è **Operazione non riuscita**. Il risultato selezionato è quello che si verificherà per qualsiasi codice restituito dall'azione e che non è elencato nell'elenco dei codici restituiti. Ad esempio, se si sceglie **Operazione non riuscita** (consigliato), tutti i codici restituiti non presenti nell'elenco faranno sì che l'azione venga restituita come non riuscita. Se si sceglie **Operazione riuscita**, tutti gli altri codici verranno restituiti come operazione riuscita.
5. Specificare il testo **Messaggio predefinito** che appare per il risultato del codice restituito predefinito non mappato selezionato.
6. Selezionare **+ Aggiungi codice restituito**.
7. Immettere il numero o intervallo di numeri **Codice restituito** in formato intero (senza decimali), il **Risultato** (**Operazione non riuscita** o **Operazione riuscita**) e il testo **Messaggio** che si desidera registrare insieme al codice restituito. Per inserire un intervallo di numeri, separare i numeri con due punti, come ad esempio 15..30.
8. Selezionare **Salva**.
9. Ripetere i punti 7 e 8 per ogni codice restituito desiderato.
10. Al termine, chiudere il pannello **Aggiungi nuovo mapping** e selezionare **Salva**.
