> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/unigetui/it/aiuto/troubleshooting/update-or-install-fails.md).

# Un aggiornamento o un'installazione non riesce

Corregga un'installazione, un aggiornamento o una disinstallazione che non riesce in UniGetUI, a partire dalle cause più comuni.

Un'operazione è contrassegnata come non riuscita nella parte inferiore della finestra, riceve una notifica di errore, oppure un'applicazione resta sulla versione precedente dopo un aggiornamento.

## Perché succede

UniGetUI chiede a un gestore di pacchetti di fare il lavoro, e il gestore di pacchetti esegue il programma di installazione dell'editore. La maggior parte degli insuccessi viene da quella catena:

* Il programma di installazione richiede diritti di amministratore, oppure l'elevazione è bloccata.
* L'applicazione è in esecuzione, quindi i suoi file non possono essere sostituiti.
* Il gestore di pacchetti è obsoleto o non funziona.
* Manca una dipendenza, oppure l'hash del programma di installazione non corrisponde a ciò che il gestore di pacchetti si aspetta.
* Il pacchetto stesso è danneggiato nel suo repository.

## Correggere

{% stepper %}
{% step %}

### Leggere l'errore e riprovare

1. Nella parte inferiore della finestra, faccia clic sulla riga di output dell'operazione non riuscita.
2. Legga le ultime righe: il gestore di pacchetti di solito dice che cosa è andato storto.
3. Usi ***Riprova***, o il menu accanto:

<table><thead><tr><th width="280">OPZIONE</th><th>USARLO QUANDO</th></tr></thead><tbody><tr><td><strong>Riprova come amministratore</strong></td><td>L'errore menziona access denied o diritti di amministratore (Windows).</td></tr><tr><td><strong>Forzare la chiusura dell'applicazione e riprovare</strong></td><td>L'applicazione era in esecuzione. Offerto solo in quel caso.</td></tr><tr><td><strong>Riprova in modo interattivo</strong></td><td>Vuole vedere i messaggi del programma di installazione e rispondere alle sue domande.</td></tr><tr><td><strong>Riprova saltando i controlli di integrità</strong></td><td>L'hash non corrisponde. Solo se si fida dell'editore, veda più sotto.</td></tr></tbody></table>

{% hint style="danger" %}
Una mancata corrispondenza dell'hash spesso significa solo che l'editore ha sostituito il file, ma può anche significare che il programma di installazione è stato manomesso. Salti i controlli di integrità solo per gli editori di cui si fida.
{% endhint %}
{% endstep %}

{% step %}

### Chiudere l'applicazione prima dell'aggiornamento

Se l'applicazione continua a bloccare il proprio aggiornamento, dica a UniGetUI di chiuderla prima:

1. Faccia clic con il pulsante destro sul pacchetto e scelga ***Opzioni di aggiornamento*** (o ***Opzioni di installazione***).
2. Apra la scheda ***Close apps before installing***.
3. Immetta i nomi dei processi da chiudere, separati da virgole. Attivi ***Prova a fermare i processi che rifiutano di chiudersi quando richiesto*** se serve.
4. Faccia clic su ***Salva e chiudi***.
   {% endstep %}

{% step %}

### Controllare le impostazioni di amministratore

In ***Impostazioni*** – ***Diritti di amministratore e altre impostazioni pericolose***:

* Se ***Vieta qualsiasi tipo di elevazione tramite UniGetUI Elevator o GSudo*** è attivo, le operazioni che richiedono diritti di amministratore non riescono sempre. Lo disattivi, oppure chieda all'amministratore.
* Se ***Delega le operazioni sui pacchetti al broker Devolutions Agent*** è attivo, l'agent deve essere in esecuzione e il criterio deve consentire l'applicazione. ***Agent broker unavailable*** o ***Operation denied by policy*** lo indicano. Veda [Installare applicazioni approvate senza diritti di amministratore](/unigetui/it/per-i-team-it/organization/devolutions-agent.md).
  {% endstep %}

{% step %}

### Provare il gestore di pacchetti da solo

Esegua la stessa operazione in un terminale, per esempio con WinGet:

```powershell
winget install --id <PackageId> --exact
```

Se non riesce anche lì, il problema è il pacchetto o il gestore di pacchetti, non UniGetUI. Aggiorni il gestore di pacchetti, installi ogni dipendenza mancante citata dall'output, o segnali il pacchetto ai responsabili. Per WinGet, veda [WinGet manca o non funziona](/unigetui/it/aiuto/troubleshooting/winget-missing-or-broken.md).
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Tutte le operazioni passate, con l'output completo, sono in ***Altro*** – ***Cronologia operazioni***. Faccia clic con il pulsante destro su un'operazione non riuscita per ***Visualizza log completo***, ***Copia dettagli*** e le opzioni di nuovo tentativo.
{% endhint %}

## Non riesce ancora?

[Inviare i registri al supporto](/unigetui/it/aiuto/troubleshooting/send-logs-to-support.md) con l'output completo dell'operazione.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/unigetui/it/aiuto/troubleshooting/update-or-install-fails.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.