Rétrogradation

Apprenez à revenir à une version antérieure de PowerShell Universal.

Dans certains scénarios, il peut être nécessaire de revenir à une version antérieure de PowerShell Universal. Cela peut être dû à un changement de fonctionnalité ou à un bogue qui affecte le système de manière trop importante pour continuer avec la version actuelle. Nous recommandons toujours de valider une version dans un environnement de développement ou d'assurance qualité avant de mettre à niveau en production, afin d'éviter d'avoir à effectuer une rétrogradation.

La rétrogradation peut être complexe et source d'erreurs. Nous recommandons de restaurer à partir d'une sauvegarde ou d'un instantané plutôt que de rétrograder.

Fichiers de configuration

La rétrogradation des fichiers de configuration nécessite de supprimer ou de modifier les fichiers du référentiel .universal afin de retirer ou de renommer les nouveaux paramètres. Les nouvelles applets de commande seront ignorées par PowerShell Universal. Si une applet de commande a été renommée, il peut être nécessaire de la mettre à jour également. Vous devrez consulter le journal des modifications pour voir quelles applets de commande ont été modifiées dans chaque version.

Les versions majeures peuvent inclure des changements non rétrocompatibles. Les versions mineures peuvent comporter des applets de commande ou des paramètres supplémentaires, mais ne comporteront aucun changement non rétrocompatible.

Vous pouvez trouver des informations sur chaque fichier de configuration dans la page Référentiel.

Il est beaucoup plus facile de restaurer à partir d'une sauvegarde des fichiers de configuration effectuée avant la mise à niveau plutôt que de mettre à jour manuellement les fichiers.

Base de données

La restauration de la base de données vers une version antérieure nécessite la rétrogradation du schéma. Cela peut être accompli avec PSU CLI. En utilisant la commande schema, vous pourrez sélectionner la version antérieure.

La rétrogradation du schéma de base de données peut être une opération destructrice. Vous risquez de supprimer des tables et des colonnes contenant des données. Effectuez toujours une sauvegarde de la base de données avant d'effectuer ces opérations.

Voici un exemple de rétrogradation du schéma d'une base de données SQLite vers la version 5.3.0. Vous devrez arrêter les services PowerShell Universal avant de procéder.

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

Fichiers d'application

La rétrogradation des fichiers d'application est généralement un processus simple et dépend de la manière dont vous avez installé le produit. Vous devrez effectuer la rétrogradation des fichiers de configuration et de la base de données avant de procéder à la rétrogradation de l'application.

MSI

Pour rétrograder une installation MSI, vous devez d'abord désinstaller la version actuelle. PowerShell Universal ne vous permettra pas d'exécuter une rétrogradation directe. Une fois la désinstallation terminée, effectuez l'installation de la version cible.

Si vous avez configuré un compte de service, vous devrez définir à nouveau le compte de service après l'installation. Cela nécessitera les informations d'identification du compte de service.

ZIP

Pour rétrograder une installation ZIP, supprimez simplement les fichiers d'application de PowerShell Universal. Une fois le répertoire vidé, décompressez le fichier ZIP de la version cible dans le répertoire d'installation. Assurez-vous d'exécuter Get-ChildItem -Recurse | Unblock-File après cette opération.

IIS

De manière similaire à l'installation ZIP, supprimez les fichiers de l'ancienne version, puis décompressez et débloquez les fichiers de la version cible. Assurez-vous que le site web et le pool d'applications sont arrêtés avant de procéder.