Impostazioni distribuzione
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.
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 (
) 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
- Selezionare Crea nuovo e il tipo di modello desiderato, oppure selezionare un modello esistente. I modelli di sistema preconfigurati sono di sola lettura.
- Inserire un Nome modello e una Descrizione.
- 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).
- 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.
- Specificare il testo Messaggio predefinito che appare per il risultato del codice restituito predefinito non mappato selezionato.
- Selezionare + Aggiungi codice restituito.
- 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.
- Selezionare Salva.
- Ripetere i punti 7 e 8 per ogni codice restituito desiderato.
- Al termine, chiudere il pannello Aggiungi nuovo mapping e selezionare Salva.
