Downgrade

In manchen Szenarien kann es erforderlich sein, die Version von PowerShell Universal zurückzusetzen. Dies kann auf eine Funktionsänderung oder einen Fehler zurückzuführen sein, der das System so stark beeinträchtigt, dass eine Fortsetzung mit dieser Version nicht möglich ist. Wir empfehlen immer, eine Version in einer Entwicklungs- oder Qualitätssicherungsumgebung zu validieren, bevor Sie in der Produktion aktualisieren, um ein Downgrade zu vermeiden.

Ein Downgrade kann kompliziert und fehleranfällig sein. Wir empfehlen, aus einem Backup oder Snapshot wiederherzustellen, anstatt ein Downgrade durchzuführen.

Konfigurationsdateien

Für das Downgrade der Konfigurationsdateien müssen die .universal-Repository-Dateien entfernt oder geändert werden, um neue Parameter zu entfernen oder umzubenennen. Neue Cmdlets werden von PowerShell Universal ignoriert. Wenn ein Cmdlet umbenannt wurde, muss es möglicherweise ebenfalls aktualisiert werden. Im Changelog können Sie nachlesen, welche Cmdlets in jeder Version geändert wurden.

Hauptversionen können Breaking Changes enthalten. Nebenversionen können zusätzliche Cmdlets oder Parameter enthalten, weisen aber keine Breaking Changes auf.

Informationen zu jeder Konfigurationsdatei finden Sie auf der Repository-Seite.

Es ist viel einfacher, aus einem Backup der Konfigurationsdateien von vor dem Upgrade wiederherzustellen, als die Dateien manuell zu aktualisieren.

Datenbank

Das Wiederherstellen der Datenbank auf eine frühere Version erfordert ein Downgrade des Schemas. Dies kann mit der PSU CLI durchgeführt werden. Mit dem Befehl schema können Sie die niedrigere Version auswählen.

Das Downgrade des Datenbankschemas kann ein destruktiver Vorgang sein. Möglicherweise entfernen Sie Tabellen und Spalten, die Daten enthalten. Erstellen Sie immer ein Backup der Datenbank, bevor Sie diese Vorgänge durchführen.

Nachfolgend finden Sie ein Beispiel für das Downgrade des Schemas einer SQLite-Datenbank auf Version 5.3.0. Sie müssen die PowerShell Universal-Dienste zuvor beenden.

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

Anwendungsdateien

Das Downgrade der Anwendungsdateien ist in der Regel ein einfacher Vorgang und hängt davon ab, wie Sie das Produkt installiert haben. Sie müssen die Downgrades der Konfigurationsdateien und der Datenbank durchführen, bevor Sie das Anwendungs-Downgrade vornehmen.

MSI

Um ein Downgrade einer MSI-Installation durchzuführen, müssen Sie zunächst die aktuelle Version deinstallieren. PowerShell Universal lässt die Ausführung eines Downgrades nicht zu. Nach Abschluss der Deinstallation führen Sie eine Installation der Zielversion durch.

Wenn Sie ein Dienstkonto konfiguriert haben, müssen Sie das Dienstkonto nach der Installation erneut festlegen. Dafür sind die Anmeldeinformationen des Dienstkontos erforderlich.

ZIP

Um ein Downgrade einer ZIP-Installation durchzuführen, löschen Sie einfach die PowerShell Universal-Anwendungsdateien. Sobald das Verzeichnis leer ist, entpacken Sie die ZIP-Datei der Zielversion in das Installationsverzeichnis. Stellen Sie sicher, dass Sie anschließend Get-ChildItem -Recurse | Unblock-File ausführen.

IIS

Ähnlich wie bei der ZIP-Installation entfernen Sie die Dateien der alten Version und entpacken und entsperren die Dateien der Zielversion. Stellen Sie sicher, dass die Website und der App Pool beendet sind, bevor Sie dies versuchen.