> 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/powershell-universal/it/getting-started/downgrade.md).

# Downgrade

In alcuni scenari può essere necessario ripristinare una versione precedente di PowerShell Universal. Ciò può essere dovuto a una modifica di una funzionalità o a un bug che influisce sul sistema in modo troppo impattante per continuare con quella versione. [Consigliamo sempre](/powershell-universal/it/getting-started/upgrading.md) di convalidare una versione in un ambiente di sviluppo o di controllo qualità prima di eseguire l'aggiornamento in produzione, per evitare di dover eseguire un downgrade.

{% hint style="danger" %}
Il downgrade può essere complicato e soggetto a errori. Consigliamo di eseguire un ripristino da un backup o da uno snapshot anziché eseguire un downgrade.
{% endhint %}

## File di configurazione

Il downgrade dei file di configurazione richiederà la rimozione o la modifica dei file del repository `.universal` per rimuovere o rinominare i nuovi parametri. I nuovi cmdlet verranno ignorati da PowerShell Universal. Se un cmdlet è stato rinominato, potrebbe essere necessario aggiornarlo. Dovrà consultare le [note di rilascio](https://devolutions.net/powershell-universal/release-notes/) per vedere quali cmdlet sono cambiati in ciascuna versione.

Le versioni principali possono includere modifiche che comportano interruzioni. Le versioni secondarie possono contenere cmdlet o parametri aggiuntivi, ma non conterranno modifiche che comportano interruzioni.

Può trovare informazioni su ciascun file di configurazione nella [pagina Repository](/powershell-universal/it/config/repository.md).

È molto più semplice eseguire un ripristino da un backup dei file di configurazione precedente all'aggiornamento anziché aggiornare manualmente i file.

## Database

Il ripristino del database a una versione precedente richiede il downgrade dello schema. Questo può essere eseguito con [PSU CLI](/powershell-universal/it/config/psucli.md). Utilizzando il comando `schema`, potrà selezionare la versione precedente.

{% hint style="danger" %}
Il downgrade dello schema del database può essere un'operazione distruttiva. Potrebbe rimuovere tabelle e colonne che contengono dati. Esegua sempre il backup di un database prima di eseguire queste operazioni.
{% endhint %}

Di seguito è riportato un esempio di downgrade dello schema di un database SQLite alla versione 5.3.0. Dovrà arrestare i servizi di PowerShell Universal prima di procedere.

{% code overflow="wrap" %}

```powershell
.\psu.exe schema --target-version '5.3.0' --connection-string "Data Source=C:\ProgramData\UniversalAutomation\database.db" --database-type "SQLite"
```

{% endcode %}

## File dell'applicazione

Il downgrade dei file dell'applicazione è in genere un processo semplice e dipende da come ha installato il prodotto. Dovrà eseguire il downgrade dei file di configurazione e del database prima di eseguire il downgrade dell'applicazione.

### MSI

Per eseguire il downgrade di un'installazione MSI, dovrà prima disinstallare la versione corrente. PowerShell Universal non le consentirà di eseguire un downgrade. Al termine della disinstallazione, esegua l'installazione della versione di destinazione.

Se ha configurato un account di servizio, dovrà impostare nuovamente l'account di servizio dopo l'installazione. Ciò richiederà le credenziali dell'account di servizio.

### ZIP

Per eseguire il downgrade di un'installazione ZIP, elimini semplicemente i file dell'applicazione PowerShell Universal. Una volta svuotata la directory, decomprima il file ZIP della versione di destinazione nella directory di installazione. Si assicuri di eseguire `Get-ChildItem -Recurse | Unblock-File` dopo averlo fatto.

### IIS

Analogamente all'installazione ZIP, rimuova i file della versione precedente e decomprima e sblocchi i file della versione di destinazione. Si assicuri che il sito web e l'App Pool siano arrestati prima di procedere.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/it/getting-started/downgrade.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.