> 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/de/getting-started/downgrade.md).

# Downgrade

Setzen Sie PowerShell Universal auf eine frühere Version zurück – einschließlich Änderungen an Konfigurationsdateien, Downgrades des Datenbankschemas und Wiederherstellung der Anwendungsdateien.

In einigen Szenarien kann es erforderlich sein, die Version von PowerShell Universal zurückzusetzen. Dies könnte auf eine Funktionsänderung oder einen Fehler zurückzuführen sein, der das System so stark beeinträchtigt, dass eine Weiterverwendung der Version nicht möglich ist. Wir [empfehlen immer](https://docs.devolutions.net/powershell-universal/de/getting-started/upgrading.md), eine Version in einer Entwicklungs- oder Qualitätssicherungsumgebung zu validieren, bevor Sie ein Upgrade in der Produktion durchführen, um ein Downgrade zu vermeiden.

{% hint style="danger" %}
Ein Downgrade kann kompliziert und fehleranfällig sein. Wir empfehlen, anstelle eines Downgrades eine Wiederherstellung aus einem Backup oder Snapshot durchzuführen.
{% endhint %}

## Konfigurationsdateien

Für ein 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. Sie müssen die [Versionshinweise](https://devolutions.net/powershell-universal/release-notes/) heranziehen, um zu sehen, welche Cmdlets sich in jeder Version geändert haben.

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](https://docs.devolutions.net/powershell-universal/de/config/repository.md).

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

## Datenbank

Upgrades des Datenbankschemas sind additiv, können jedoch während der Schemamigration Änderungen am Dateninhalt vornehmen. Wir unterstützen keine Downgrades des Datenbankschemas.

## Passwörter lokaler Konten

Ab PowerShell Universal 2026.3.0 werden Passwörter lokaler Konten als Einweg-Hashes anstelle von verschlüsselten Werten gespeichert. Frühere Versionen können diese Hashes nicht zur Authentifizierung lokaler Konten verwenden. Daher erfordert ein Downgrade von 2026.3.0 oder höher auf eine frühere Version das Zurücksetzen der Passwörter lokaler Konten.

Halten Sie nach der Installation oder dem Extrahieren der Zielversion den PowerShell Universal-Dienst weiterhin gestoppt und verwenden Sie das in dieser Version enthaltene [psu-Befehlszeilentool](https://docs.devolutions.net/powershell-universal/de/config/psucli.md), um ein Administratorpasswort zurückzusetzen. Sie können auch eine andere von der Zielversion unterstützte Methode zur Passwortwiederherstellung verwenden.

{% code overflow="wrap" %}

```powershell
.\psu.exe admin reset --connection-string 'Data Source=C:\ProgramData\UniversalAutomation\database.db'
```

{% endcode %}

Der Standardbefehl setzt das Passwort des Kontos `admin` auf `admin` zurück. Geben Sie den Datenbanktyp und die Optionen zur Tresorverschlüsselung an, wenn dies für Ihre Installation erforderlich ist. Nachdem Sie den herabgestuften Server gestartet haben, melden Sie sich mit dem zurückgesetzten Administratorkonto an, ändern Sie sein Passwort sofort und setzen Sie die Passwörter aller übrigen lokalen Konten zurück.

## 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 Downgrade der Anwendung durchführen.

### 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. Führen Sie nach Abschluss der Deinstallation eine Installation der Zielversion durch.

Wenn Sie ein Dienstkonto konfiguriert haben, müssen Sie das Dienstkonto nach der Installation erneut festlegen. Dazu 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 danach `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 gestoppt sind, bevor Sie dies versuchen.


---

# 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/powershell-universal/de/getting-started/downgrade.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.
