> 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/unigetui/de/referenz/cli.md).

# Befehlszeilenschnittstelle

Alle Befehlszeilenbefehle, Optionen, Startparameter, Umgebungsvariablen, Deep Links und Installationsschalter von UniGetUI.

Der Befehl `unigetui` steuert eine laufende UniGetUI-Sitzung aus einem Terminal oder einem Skript: Pakete suchen, installieren, aktualisieren und entfernen, Einstellungen, Quellen, Bündel und Sicherungen verwalten und Protokolle lesen. Die CLI spricht mit der Sitzung über die lokale [Automatisierungs-API](/unigetui/de/referenz/ipc-api.md).

{% hint style="info" %}
Wenn `unigetui` in Ihrer Shell nicht erkannt wird, führen Sie stattdessen die ausführbare Datei von UniGetUI aus dem Installationsordner aus, zum Beispiel `UniGetUI.exe` unter Windows.
{% endhint %}

## Voraussetzungen

Die CLI braucht eine UniGetUI-Sitzung, mit der sie sich verbinden kann:

* **Desktopsitzung**: UniGetUI ist geöffnet oder läuft im Infobereich, und ***Hintergrund-API aktivieren (UniGetUI-Widgets und -Zugriff, Port 7058)*** ist unter ***Einstellungen*** – ***Experimentelle und Entwickleroptionen*** aktiviert.
* **Sitzung ohne Benutzeroberfläche**: UniGetUI wurde mit `--headless` gestartet. Siehe [Sitzungen ohne Benutzeroberfläche](#headless-sessions).

Wenn keine Sitzung erreichbar ist, endet der Befehl mit dem Code `3`.

## Schnellstart

```powershell
unigetui status
unigetui app status
unigetui package search --manager dotnet-tool --query dotnetsay
unigetui package install --manager dotnet-tool --id dotnetsay --version 2.1.4 --scope Global
unigetui operation wait --id 123 --timeout 300
```

## Syntax

* Nomen akzeptieren die Einzahl oder die Mehrzahl: `operation`/`operations`, `package`/`packages`, `manager`/`managers`, `source`/`sources`, `shortcut`/`shortcuts`, `log`/`logs`, `backup`/`backups`, `bundle`/`bundles`.
* `startmenu` wird für `start-menu` akzeptiert, und `folders` für `folder`.
* Boolesche Optionen benötigen einen ausdrücklichen Wert: `--enabled true`, `--wait false`.
* `--detach` ist die Kurzform von `--wait false` bei Paketvorgängen. Der Befehl gibt sofort eine Vorgangs-ID zurück.
* Aliase:
  * `--id` entspricht `--package-id` oder `--operation-id`, je nach Befehl.
  * `--source` entspricht `--package-source`.
  * `--source-name` und `--source-url` entsprechen `--name` und `--url` bei `source add` und `source remove`.
  * `--name` entspricht `--key` bei `backup cloud download` und `backup cloud restore`.
* `--manager` erwartet eine stabile Manager-ID, nicht den in der App angezeigten Namen: `apt`, `bun`, `cargo`, `chocolatey`, `dnf`, `dotnet-tool`, `flatpak`, `homebrew`, `npm`, `pacman`, `pip`, `pwsh`, `scoop`, `snap`, `vcpkg`, `winget`, `winps`. Nur die Manager der aktuellen Plattform funktionieren. Siehe [Unterstützte Paketmanager](/unigetui/de/referenz/package-managers.md).

## Verbindungsoptionen

Standardmäßig findet die CLI die laufende Sitzung selbst. Verwenden Sie diese Optionen, um eine bestimmte Sitzung anzusteuern.

<table><thead><tr><th width="250">OPTION</th><th>UMGEBUNGSVARIABLE</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>--transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Transport zum Erreichen der Sitzung. Standard: <code>named-pipe</code>.</td></tr><tr><td><code>--tcp-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>TCP-Port der Sitzung. Nur mit <code>tcp</code>.</td></tr><tr><td><code>--pipe-name &#x3C;name-or-path></code></td><td><code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Named Pipe der Sitzung. Unter Windows ein Pipename. Unter macOS und Linux wird ein relativer Name unter <code>/tmp</code> aufgelöst, und ein absoluter Pfad wird als genauer Unix-Socket-Pfad verwendet.</td></tr></tbody></table>

## Exitcodes

<table><thead><tr><th width="250">CODE</th><th>BEDEUTUNG</th></tr></thead><tbody><tr><td><code>0</code></td><td>Erfolg.</td></tr><tr><td><code>1</code></td><td>Der Befehl ist fehlgeschlagen.</td></tr><tr><td><code>2</code></td><td>Ein Parameter ist ungültig.</td></tr><tr><td><code>3</code></td><td>Die Automatisierungs-API ist nicht verfügbar (keine Sitzung erreicht).</td></tr><tr><td><code>4</code></td><td>Unbekannter Befehl.</td></tr></tbody></table>

## Befehle

### Sitzung

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>status</code></td><td></td><td></td><td>Gibt Transport, Endpunkt und Buildinformationen der Sitzung zurück.</td></tr><tr><td><code>version</code></td><td></td><td></td><td>Gibt die Buildnummer von UniGetUI zurück.</td></tr></tbody></table>

### Anwendung

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>app status</code></td><td></td><td></td><td>Gibt den Sitzungsstatus zurück: ohne Benutzeroberfläche oder nicht, aktuelle Seite, unterstützte UI-Aktionen.</td></tr><tr><td><code>app show</code></td><td></td><td></td><td>Zeigt das UniGetUI-Fenster an und setzt den Fokus darauf.</td></tr><tr><td><code>app navigate</code></td><td><code>--page &#x3C;page></code></td><td><code>--manager &#x3C;id></code>, <code>--help-attachment &#x3C;path></code></td><td>Öffnet eine Seite: <code>discover</code>, <code>updates</code>, <code>installed</code>, <code>bundles</code>, <code>settings</code>, <code>managers</code>, <code>own-log</code>, <code>manager-log</code>, <code>operation-history</code>, <code>help</code>, <code>release-notes</code>, <code>about</code>.</td></tr><tr><td><code>app quit</code></td><td></td><td></td><td>Schließt die Sitzung ordnungsgemäß, auch eine ohne Benutzeroberfläche.</td></tr></tbody></table>

### Vorgänge

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>operation list</code></td><td></td><td></td><td>Listet laufende, eingereihte und abgeschlossene Vorgänge auf.</td></tr><tr><td><code>operation get</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Gibt alles zu einem Vorgang zurück.</td></tr><tr><td><code>operation output</code></td><td><code>--id &#x3C;operation-id></code></td><td><code>--tail &#x3C;n></code></td><td>Gibt die Ausgabezeilen eines Vorgangs zurück.</td></tr><tr><td><code>operation wait</code></td><td><code>--id &#x3C;operation-id></code></td><td><code>--timeout &#x3C;seconds></code>, <code>--delay &#x3C;seconds></code></td><td>Wartet, bis der Vorgang abgeschlossen ist.</td></tr><tr><td><code>operation cancel</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Bricht einen eingereihten oder laufenden Vorgang ab.</td></tr><tr><td><code>operation retry</code></td><td><code>--id &#x3C;operation-id></code></td><td><code>--mode &#x3C;mode></code></td><td>Führt den Vorgang erneut aus. Die verfügbaren Modi stehen in den Vorgangsinformationen.</td></tr><tr><td><code>operation reorder</code></td><td><code>--id &#x3C;operation-id></code>, <code>--action &#x3C;run-now|run-next|run-last></code></td><td></td><td>Verschiebt einen eingereihten Vorgang in der Warteschlange.</td></tr><tr><td><code>operation forget</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Entfernt einen abgeschlossenen Vorgang aus der Liste.</td></tr></tbody></table>

### Paketmanager

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>manager list</code></td><td></td><td></td><td>Listet die Paketmanager und ihre Funktionen auf.</td></tr><tr><td><code>manager maintenance</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Gibt Wartungsinformationen für einen Manager zurück.</td></tr><tr><td><code>manager reload</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Lädt einen Manager neu.</td></tr><tr><td><code>manager set-executable</code></td><td><code>--manager &#x3C;id></code>, <code>--path &#x3C;path></code></td><td></td><td>Verwendet eine benutzerdefinierte ausführbare Datei und lädt dann den Manager neu.</td></tr><tr><td><code>manager clear-executable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Entfernt die benutzerdefinierte ausführbare Datei und lädt dann den Manager neu.</td></tr><tr><td><code>manager action</code></td><td><code>--manager &#x3C;id></code>, <code>--action &#x3C;action></code></td><td><code>--confirm</code></td><td>Führt eine für den Manager spezifische Wartungsaktion aus.</td></tr><tr><td><code>manager enable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Aktiviert den Manager.</td></tr><tr><td><code>manager disable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Deaktiviert den Manager.</td></tr><tr><td><code>manager notifications enable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Schaltet Updatebenachrichtigungen für den Manager ein.</td></tr><tr><td><code>manager notifications disable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Schaltet Updatebenachrichtigungen für den Manager aus.</td></tr></tbody></table>

### Quellen

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>source list</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Listet Quellen auf, optional für einen Manager.</td></tr><tr><td><code>source add</code></td><td><code>--manager &#x3C;id></code>, <code>--name &#x3C;source-name></code></td><td><code>--url &#x3C;source-url></code></td><td>Fügt eine Quelle hinzu.</td></tr><tr><td><code>source remove</code></td><td><code>--manager &#x3C;id></code>, <code>--name &#x3C;source-name></code></td><td><code>--url &#x3C;source-url></code></td><td>Entfernt eine Quelle.</td></tr></tbody></table>

### Einstellungen

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>settings list</code></td><td></td><td></td><td>Listet die regulären Einstellungen und ihre Schlüssel auf.</td></tr><tr><td><code>settings get</code></td><td><code>--key &#x3C;key></code></td><td></td><td>Liest eine reguläre Einstellung.</td></tr><tr><td><code>settings set</code></td><td><code>--key &#x3C;key></code></td><td><code>--enabled true|false</code>, <code>--value &#x3C;text></code></td><td>Legt eine Einstellung als booleschen Wert oder als Text fest.</td></tr><tr><td><code>settings clear</code></td><td><code>--key &#x3C;key></code></td><td></td><td>Löscht eine Texteinstellung.</td></tr><tr><td><code>settings reset</code></td><td></td><td></td><td>Setzt die regulären Einstellungen zurück.</td></tr><tr><td><code>settings secure list</code></td><td></td><td><code>--user &#x3C;name></code></td><td>Listet die sicheren (durch den Administrator geschützten) Einstellungen des aktuellen oder angegebenen Benutzers auf.</td></tr><tr><td><code>settings secure get</code></td><td><code>--key &#x3C;key></code></td><td><code>--user &#x3C;name></code></td><td>Liest eine sichere Einstellung.</td></tr><tr><td><code>settings secure set</code></td><td><code>--key &#x3C;key></code>, <code>--enabled true|false</code></td><td><code>--user &#x3C;name></code></td><td>Schaltet eine sichere Einstellung ein oder aus.</td></tr></tbody></table>

{% hint style="info" %}
Führen Sie `unigetui settings list` und `unigetui settings secure list` aus, um die verfügbaren Schlüssel zu sehen. Was jede Einstellung bewirkt, steht unter [Alle Einstellungen](/unigetui/de/referenz/settings.md).
{% endhint %}

### Desktopverknüpfungen

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>shortcut list</code></td><td></td><td></td><td>Listet verfolgte Desktopverknüpfungen auf und ob jede behalten oder gelöscht wird.</td></tr><tr><td><code>shortcut set</code></td><td><code>--path &#x3C;path></code>, <code>--status &#x3C;keep|delete></code></td><td></td><td>Markiert eine Verknüpfung zum Behalten oder Löschen.</td></tr><tr><td><code>shortcut reset</code></td><td><code>--path &#x3C;path></code></td><td></td><td>Löscht die gespeicherte Auswahl für eine Verknüpfung.</td></tr><tr><td><code>shortcut reset-all</code></td><td></td><td></td><td>Löscht die gespeicherten Auswahlen für alle Verknüpfungen.</td></tr></tbody></table>

### Startmenü-Verknüpfungen

Nur unter Windows. Die Auswahl wird anhand des Verknüpfungspfads gespeichert und jedes Mal erneut angewendet, wenn ein Update die Verknüpfung neu erstellt. Pfade außerhalb eines Startmenü-Ordners `Programs` sowie Dateien, die keine `.lnk`- oder `.url`-Verknüpfungen sind, werden abgelehnt.

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>start-menu shortcut list</code></td><td></td><td></td><td>Listet verfolgte Startmenü-Verknüpfungen auf und ob jede behalten oder gelöscht wird.</td></tr><tr><td><code>start-menu shortcut set</code></td><td><code>--path &#x3C;path></code>, <code>--status &#x3C;keep|delete></code></td><td></td><td>Markiert eine Startmenü-Verknüpfung zum Behalten oder Löschen.</td></tr><tr><td><code>start-menu shortcut reset</code></td><td><code>--path &#x3C;path></code></td><td></td><td>Löscht die gespeicherte Auswahl für eine Verknüpfung.</td></tr><tr><td><code>start-menu shortcut reset-all</code></td><td></td><td></td><td>Löscht alle gespeicherten Auswahlen. Ordnerregeln und die von ihnen verschobenen Verknüpfungen bleiben unberührt.</td></tr></tbody></table>

### Startmenü-Ordner

Nur unter Windows. Eine Ordnerregel legt den Unterordner des Startmenü-Ordners `Programs` des aktuellen Benutzers fest, in dem ein Paket seine Verknüpfungen behält. UniGetUI wendet sie nach jeder Installation und jedem Update an und löscht die verschobenen Verknüpfungen, wenn das Paket deinstalliert wird.

* `--package` verwendet das Format `manager\PackageId`, zum Beispiel `winget\Python.Python.3.13`. Der Managerteil wird kleingeschrieben. Die Regel ignoriert die Quelle, daher teilen sich zwei Pakete mit demselben Manager und derselben ID aus verschiedenen Quellen eine Regel.
* `--folder` muss ein Unterordner des Startmenü-Ordners `Programs` sein. Absolute Pfade, Segmente `..` und der Startmenü-Ordner für alle Benutzer werden abgelehnt.

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>start-menu folder list</code></td><td></td><td></td><td>Listet Ordnerregeln auf. Pakete, die nur ausstehende Verknüpfungen haben, werden ebenfalls aufgelistet, mit einem leeren Ordner.</td></tr><tr><td><code>start-menu folder set</code></td><td><code>--package &#x3C;manager\id></code>, <code>--folder &#x3C;name></code></td><td><code>--relocate-existing</code></td><td>Erstellt eine Ordnerregel. <code>--relocate-existing</code> verschiebt auch die vorhandenen Verknüpfungen des Pakets.</td></tr><tr><td><code>start-menu folder remove</code></td><td><code>--package &#x3C;manager\id></code></td><td></td><td>Entfernt die Ordnerregel eines Pakets.</td></tr></tbody></table>

### Protokolle

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>log app</code></td><td></td><td><code>--level &#x3C;n></code></td><td>Gibt das Anwendungsprotokoll von UniGetUI zurück.</td></tr><tr><td><code>log operations</code></td><td></td><td></td><td>Gibt den Vorgangsverlauf zurück.</td></tr><tr><td><code>log manager</code></td><td></td><td><code>--manager &#x3C;id></code>, <code>--verbose</code></td><td>Gibt die Paketmanagerprotokolle zurück.</td></tr></tbody></table>

### Sicherungen

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>backup status</code></td><td></td><td></td><td>Gibt die Sicherungseinstellungen und den GitHub-Anmeldestatus zurück.</td></tr><tr><td><code>backup local create</code></td><td></td><td></td><td>Erstellt eine lokale Sicherung.</td></tr><tr><td><code>backup github login start</code></td><td></td><td><code>--launch-browser</code></td><td>Startet die GitHub-Anmeldung (Geräteflow).</td></tr><tr><td><code>backup github login complete</code></td><td></td><td></td><td>Schließt die ausstehende GitHub-Anmeldung ab.</td></tr><tr><td><code>backup github logout</code></td><td></td><td></td><td>Meldet sich von GitHub ab und entfernt das gespeicherte Token.</td></tr><tr><td><code>backup cloud list</code></td><td></td><td></td><td>Listet Cloud-Sicherungen auf.</td></tr><tr><td><code>backup cloud create</code></td><td></td><td></td><td>Lädt eine Sicherung in die Cloud hoch.</td></tr><tr><td><code>backup cloud download</code></td><td><code>--key &#x3C;name></code></td><td></td><td>Lädt eine Cloud-Sicherung als Bündelinhalt herunter.</td></tr><tr><td><code>backup cloud restore</code></td><td><code>--key &#x3C;name></code></td><td><code>--append</code></td><td>Importiert eine Cloud-Sicherung in das aktuelle Bündel.</td></tr></tbody></table>

### Bündel

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>bundle get</code></td><td></td><td></td><td>Gibt das aktuelle Bündel zurück.</td></tr><tr><td><code>bundle reset</code></td><td></td><td></td><td>Leert das aktuelle Bündel.</td></tr><tr><td><code>bundle import</code></td><td></td><td><code>--path &#x3C;path></code>, <code>--content &#x3C;text></code>, <code>--format &#x3C;ubundle|json|yaml|xml></code>, <code>--append</code></td><td>Importiert ein Bündel aus einer Datei oder aus Rohinhalt.</td></tr><tr><td><code>bundle export</code></td><td></td><td><code>--path &#x3C;path></code></td><td>Exportiert das aktuelle Bündel, optional in eine Datei.</td></tr><tr><td><code>bundle add</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--pre-release</code>, <code>--selection &#x3C;search|installed|updates|auto></code></td><td>Findet ein Paket und fügt es dem Bündel hinzu.</td></tr><tr><td><code>bundle remove</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--pre-release</code>, <code>--selection &#x3C;mode></code></td><td>Entfernt die passenden Pakete aus dem Bündel.</td></tr><tr><td><code>bundle install</code></td><td></td><td><code>--include-installed true|false</code>, <code>--elevated true|false</code>, <code>--interactive true|false</code>, <code>--skip-hash true|false</code></td><td>Installiert die Pakete des Bündels.</td></tr></tbody></table>

### Pakete

<table><thead><tr><th width="250">BEFEHL</th><th>ERFORDERLICH</th><th>OPTIONAL</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>package search</code></td><td><code>--query &#x3C;text></code></td><td><code>--manager &#x3C;id></code>, <code>--max-results &#x3C;n></code></td><td>Sucht nach Paketen.</td></tr><tr><td><code>package details</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code></td><td>Gibt die Details eines Pakets zurück.</td></tr><tr><td><code>package versions</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code></td><td>Gibt die installierbaren Versionen zurück, wenn der Manager das unterstützt.</td></tr><tr><td><code>package installed</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Listet installierte Pakete auf.</td></tr><tr><td><code>package updates</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Listet verfügbare Updates auf.</td></tr><tr><td><code>package install</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--pre-release</code>, <code>--elevated true|false</code>, <code>--interactive true|false</code>, <code>--skip-hash true|false</code>, <code>--architecture &#x3C;value></code>, <code>--location &#x3C;path></code>, <code>--wait true|false</code>, <code>--detach</code></td><td>Installiert ein Paket. Der asynchrone Modus gibt sofort eine Vorgangs-ID zurück.</td></tr><tr><td><code>package download</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--wait true|false</code>, <code>--detach</code>, <code>--output &#x3C;path></code></td><td>Lädt das Installationsprogramm eines Pakets herunter.</td></tr><tr><td><code>package reinstall</code></td><td><code>--id &#x3C;package-id></code></td><td>Wie <code>package install</code></td><td>Installiert ein installiertes Paket erneut.</td></tr><tr><td><code>package repair</code></td><td><code>--id &#x3C;package-id></code></td><td>Wie <code>package install</code>, plus <code>--remove-data true|false</code></td><td>Deinstalliert das Paket und installiert es dann erneut.</td></tr><tr><td><code>package update</code></td><td><code>--id &#x3C;package-id></code></td><td>Wie <code>package install</code></td><td>Aktualisiert ein Paket.</td></tr><tr><td><code>package uninstall</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--scope &#x3C;scope></code>, <code>--remove-data true|false</code>, <code>--elevated true|false</code>, <code>--interactive true|false</code>, <code>--wait true|false</code>, <code>--detach</code></td><td>Deinstalliert ein Paket.</td></tr><tr><td><code>package show</code></td><td><code>--id &#x3C;package-id></code>, <code>--source &#x3C;source></code></td><td></td><td>Öffnet die Paketdetails im UniGetUI-Fenster.</td></tr><tr><td><code>package ignored list</code></td><td></td><td></td><td>Listet ignorierte Updates auf.</td></tr><tr><td><code>package ignored add</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--version &#x3C;version></code>, <code>--source &#x3C;source></code></td><td>Ignoriert die Updates eines Pakets.</td></tr><tr><td><code>package ignored remove</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--version &#x3C;version></code>, <code>--source &#x3C;source></code></td><td>Ignoriert die Updates eines Pakets nicht mehr.</td></tr><tr><td><code>package update-all</code></td><td></td><td></td><td>Reiht Updates für jedes Paket ein, das aktualisiert werden kann.</td></tr><tr><td><code>package update-manager</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Reiht Updates für jedes Paket eines Managers ein.</td></tr></tbody></table>

## Sitzungen ohne Benutzeroberfläche

Starten Sie UniGetUI mit `--headless`, um die Automatisierungs-API ohne Fenster auszuführen, zum Beispiel auf einem Build-Agent oder in einem Skript.

```powershell
UniGetUI.exe --headless
```

<table><thead><tr><th width="250">PARAMETER</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>--ipc-api-transport {named-pipe|tcp}</code></td><td>Transport der API. Standard: <code>named-pipe</code>.</td></tr><tr><td><code>--ipc-api-port &#x3C;port></code></td><td>TCP-Port, mit dem Transport <code>tcp</code>.</td></tr><tr><td><code>--ipc-api-pipe-name &#x3C;name-or-path></code></td><td>Pipename oder Unix-Socket-Pfad unter macOS und Linux.</td></tr></tbody></table>

Einige Befehle hängen vom Fenster ab und verhalten sich ohne Benutzeroberfläche anders:

<table><thead><tr><th width="250">BEFEHL</th><th>IN EINER SITZUNG OHNE BENUTZEROBERFLÄCHE</th></tr></thead><tbody><tr><td><code>status</code>, <code>app status</code>, <code>app quit</code></td><td>Vollständig unterstützt.</td></tr><tr><td><code>app show</code>, <code>app navigate</code></td><td>Fehler: Es gibt kein Fenster.</td></tr><tr><td><code>package show</code></td><td>Öffnet einen UI-Ablauf und kann daher fehlschlagen oder nichts tun.</td></tr><tr><td><code>package update-all</code>, <code>package update-manager</code></td><td>Können fehlschlagen: Sie sind auf das Fenster angewiesen, um die Updates zu starten.</td></tr></tbody></table>

## Startparameter

Die ausführbare Datei von UniGetUI akzeptiert auch diese Parameter.

<table><thead><tr><th width="250">PARAMETER</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>--daemon</code></td><td>Startet UniGetUI minimiert im Infobereich.</td></tr><tr><td><code>--updateapps</code></td><td>Erzwingt die Installation verfügbarer Updates. Aus Kompatibilitätsgründen beibehalten.</td></tr><tr><td><code>--help</code>, <code>-h</code></td><td>Zeigt die CLI-Hilfe an.</td></tr><tr><td><code>--import-settings &#x3C;file></code></td><td>Importiert Einstellungen aus einer JSON-Datei. Vorhandene Einstellungen werden ersetzt.</td></tr><tr><td><code>--export-settings &#x3C;file></code></td><td>Exportiert Einstellungen in eine JSON-Datei und erstellt oder überschreibt sie dabei.</td></tr><tr><td><code>--enable-setting &#x3C;key></code>, <code>--disable-setting &#x3C;key></code></td><td>Schaltet eine boolesche Einstellung ein oder aus.</td></tr><tr><td><code>--set-setting-value &#x3C;key> &#x3C;value></code></td><td>Legt eine Texteinstellung fest.</td></tr><tr><td><code>--enable-secure-setting &#x3C;key></code>, <code>--disable-secure-setting &#x3C;key></code></td><td>Schaltet eine sichere Einstellung für den aktuellen Benutzer ein oder aus. Kann Administratorrechte erfordern.</td></tr><tr><td><code>--enable-secure-setting-for-user &#x3C;user> &#x3C;key></code>, <code>--disable-secure-setting-for-user &#x3C;user> &#x3C;key></code></td><td>Schaltet eine sichere Einstellung für den angegebenen Benutzer ein oder aus. Kann Administratorrechte erfordern.</td></tr><tr><td><code>--no-corrupt-dialog</code></td><td>Zeigt den detaillierten Absturzbericht anstelle des vereinfachten Dialogs an.</td></tr><tr><td><code>--delete-shortcuts &#x3C;path> [&#x3C;path>...]</code></td><td>Löscht Desktop- oder Startmenü-Verknüpfungen und beendet sich dann. Wird intern verwendet, um Verknüpfungen zu entfernen, die der aktuelle Benutzer nicht löschen kann. Nur Dateien <code>.lnk</code> und <code>.url</code> in einem Desktop- oder Startmenü-Ordner werden akzeptiert.</td></tr><tr><td><code>--migrate-wingetui-to-unigetui</code></td><td>Migriert die Daten und Verknüpfungen einer älteren WingetUI-Installation und beendet sich dann.</td></tr><tr><td><code>--uninstall-wingetui</code></td><td>Entfernt das ältere WingetUI aus dem Infobereich und beendet sich. Wird vom WingetUI-Deinstallationsprogramm verwendet.</td></tr><tr><td><code>&#x3C;bundle-file></code></td><td>Öffnet ein Bündel in <em><strong>Paketbündel</strong></em>. Zu den unterstützten Erweiterungen gehören <code>.ubundle</code>, <code>.json</code>, <code>.yaml</code> und <code>.xml</code>.</td></tr></tbody></table>

## Umgebungsvariablen

Werden beim Start von UniGetUI gelesen.

<table><thead><tr><th width="250">VARIABLE</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>UNIGETUI_WINGET_CLI</code></td><td>Tool des WinGet-Managers: <code>default</code>, <code>winget</code> oder <code>pinget</code>. Überschreibt die Einstellung <em><strong>WinGet-Befehlszeilentool</strong></em>.</td></tr><tr><td><code>UNIGETUI_WINGET_COM</code></td><td>Verwendung der WinGet-COM-API: <code>default</code>, <code>enabled</code> oder <code>disabled</code> (<code>on</code>/<code>off</code>, <code>true</code>/<code>false</code> und <code>1</code>/<code>0</code> funktionieren ebenfalls). Überschreibt die Einstellung <em><strong>WinGet COM API</strong></em>.</td></tr><tr><td><code>UNIGETUI_FONT_FAMILY</code></td><td>Nur unter Windows. Schriftfamilie, die am Anfang der Schriftliste der Oberfläche eingefügt wird. Wird ignoriert, wenn UniGetUI die Windows-Systemschrift verwendet.</td></tr><tr><td><code>UNIGETUI_FORCE_NATIVE_LINUX_DECORATIONS</code></td><td>Nur unter Linux. Erzwingt die Titelleiste des Fenstermanagers ein (<code>1</code>, <code>true</code>, <code>on</code>, <code>yes</code>, <code>enabled</code>) oder aus (<code>0</code>, <code>false</code>, <code>off</code>, <code>no</code>, <code>disabled</code>), statt sie zu erkennen.</td></tr><tr><td><code>UNIGETUI_GITHUB_TOKEN_NAMESPACE</code></td><td>Suffix, der dem Anmeldedateneintrag des GitHub-Sicherungstokens angefügt wird, damit mehrere UniGetUI-Instanzen auf einem Computer unterschiedliche GitHub-Konten verwenden können.</td></tr><tr><td><code>WEBVIEW2_BROWSER_EXECUTABLE_FOLDER</code></td><td>Nur unter Windows. Ordner einer WebView2-Runtime mit fester Version, die anstelle der installierten verwendet wird.</td></tr><tr><td><code>UNIGETUI_IPC_API_TRANSPORT</code>, <code>UNIGETUI_IPC_API_PORT</code>, <code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Siehe <a href="#connection-options">Verbindungsoptionen</a>.</td></tr></tbody></table>

## Deep Links

Unter Windows registriert eine reguläre Installation das Protokoll `unigetui://`. Portable Installationen tun das nicht.

<table><thead><tr><th width="250">LINK</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>unigetui://openUniGetUI</code></td><td>Zeigt das UniGetUI-Fenster an.</td></tr><tr><td><code>unigetui://openUniGetUIOnUpdatesTab</code></td><td>Zeigt UniGetUI in <em><strong>Software-Updates</strong></em> an.</td></tr><tr><td><code>unigetui://updateAll</code></td><td>Aktualisiert jedes Paket, für das ein Update vorliegt.</td></tr><tr><td><code>unigetui://releaseSelfUpdateLock</code></td><td>Lässt ein ausstehendes Update von UniGetUI fortfahren.</td></tr></tbody></table>

{% hint style="warning" %}
Ein Deep Link wirkt nur, wenn UniGetUI bereits ausgeführt wird. Wenn der Link UniGetUI startet, öffnet sich die App normal und die Aktion wird ignoriert. Um UniGetUI zu automatisieren, verwenden Sie die obigen Befehle oder die [Automatisierungs-API](/unigetui/de/referenz/ipc-api.md).
{% endhint %}

## Installationsschalter

Die Installationsschalter von Windows (stille Installation, alle Benutzer, portabel, Überspringen von Abhängigkeiten) sind unter [UniGetUI installieren](/unigetui/de/referenz/installation.md#installer-switches) aufgeführt.


---

# 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/unigetui/de/referenz/cli.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.