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 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.

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.

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 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.

È 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. Utilizzando il comando schema, potrà selezionare la versione precedente.

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.

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.

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

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.