> 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/es/referencia/cli.md).

# Interfaz de línea de comandos

Todos los comandos de la línea de comandos, opciones, parámetros de inicio, variables de entorno, vínculos profundos y modificadores del instalador de Devolutions UniGetUI.

El comando `uniget` controla una sesión de Devolutions UniGetUI en ejecución desde un terminal o un script: buscar, instalar, actualizar y quitar paquetes, administrar la configuración, los orígenes, los lotes y las copias de seguridad, y leer los registros. La CLI se comunica con la sesión a través de la [API de automatización](https://docs.devolutions.net/unigetui/es/referencia/ipc-api.md) local.

Para administrar las aplicaciones de forma interactiva en un terminal, utilice en su lugar la [interfaz de terminal](https://github.com/Devolutions/RDM/tree/master/docs-products/translations/es/unigetui/reference/terminal-ui.md) (`uniget tui`).

{% hint style="info" %}
En Windows, seleccione ***Add the uniget command to PATH (reopen terminals after installation)*** durante la instalación para ejecutar `uniget` desde cualquier carpeta y luego abra un terminal nuevo. De lo contrario, ejecute `.\uniget.exe` desde la carpeta de instalación de Devolutions UniGetUI. En macOS, ejecute `/Applications/UniGetUI.app/Contents/MacOS/uniget`. En Linux, los paquetes `.deb` y `.rpm` añaden `uniget` al `PATH`; desde un archivo extraído, ejecute `./uniget`.
{% endhint %}

## Requisitos

La CLI necesita una sesión de Devolutions UniGetUI a la que conectarse:

* **Sesión de escritorio**: Devolutions UniGetUI está abierto o en ejecución en el área de notificación, y ***Habilitar API en segundo plano (Widgets de UniGetUI y Compartir, puerto 7058)*** está activado en ***Configuración*** – ***Ajustes experimentales y opciones de desarrollador***.
* **Sesión sin interfaz**: Devolutions UniGetUI se inició con `--headless`. En ese modo, `package show`, `package update-all` y `package update-manager` no están disponibles.

Si no se puede alcanzar ninguna sesión, el comando sale con el código `3`. `uniget status` es la excepción: devuelve `"running": false` en su lugar.

Cada comando escribe su resultado como JSON en la salida estándar. Un comando fallido escribe `{"status": "error", "message": "..."}`.

## Inicio rápido

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

## Sintaxis

* Los nombres aceptan el singular o el plural: `operation`/`operations`, `package`/`packages`, `manager`/`managers`, `source`/`sources`, `shortcut`/`shortcuts`, `log`/`logs`, `backup`/`backups`, `bundle`/`bundles`.
* `startmenu` se acepta para `start-menu`, `folders` para `folder` y `log operation` para `log operations`.
* Un comando que no está en esta página no se trata como un comando de la CLI: Devolutions UniGetUI se inicia con normalidad en su lugar.
* Las opciones booleanas toman un valor explícito: `--enabled true`, `--wait false`. Estas opciones son indicadores sin valor: `--detach`, `--pre-release`, `--confirm`, `--verbose`, `--append`, `--launch-browser`, `--relocate-existing`.
* `--detach` es la forma abreviada de `--wait false` en las operaciones de paquetes. El comando devuelve de inmediato un identificador de operación.
* Alias:
  * `--id` corresponde a `--package-id` o a `--operation-id`, según el comando.
  * `--source` corresponde a `--package-source`.
  * `--source-name` y `--source-url` corresponden a `--name` y `--url` en `source add` y `source remove`.
  * `--name` corresponde a `--key` en `backup cloud download` y `backup cloud restore`.
* `--manager` toma un identificador de gestor estable, no el nombre que se muestra en la aplicación: `apt`, `bun`, `cargo`, `chocolatey`, `dnf`, `dotnet-tool`, `flatpak`, `homebrew`, `npm`, `pacman`, `pip`, `pwsh`, `scoop`, `snap`, `vcpkg`, `winget`, `winps`. Solo funcionan los gestores de la plataforma actual. Consulte [Gestores de paquetes compatibles](https://docs.devolutions.net/unigetui/es/referencia/package-managers.md).

## Opciones de conexión

De forma predeterminada, la CLI encuentra por sí sola la sesión en ejecución. Use estas opciones para dirigirse a una en concreto.

<table><thead><tr><th width="250">OPCIÓN</th><th>VARIABLE DE ENTORNO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Transporte usado para llegar a la sesión. Predeterminado: <code>named-pipe</code> (<code>pipe</code> y <code>namedpipe</code> también funcionan).</td></tr><tr><td><code>--tcp-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>Puerto TCP de la sesión, de 1 a 65535. Solo con <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>Canalización con nombre de la sesión. En Windows, un nombre de canalización. En macOS y Linux, un nombre relativo se resuelve bajo <code>/tmp</code> y una ruta absoluta se usa como ruta exacta del socket Unix, hasta 104 caracteres.</td></tr></tbody></table>

Los parámetros del servidor `--ipc-api-transport`, `--ipc-api-port` y `--ipc-api-pipe-name` también se aceptan aquí. Con una de estas opciones o variables de entorno, la CLI espera hasta 5 segundos a una sesión coincidente.

## Códigos de salida

<table><thead><tr><th width="250">CÓDIGO</th><th>SIGNIFICADO</th></tr></thead><tbody><tr><td><code>0</code></td><td>Éxito.</td></tr><tr><td><code>1</code></td><td>El comando ha fallado.</td></tr><tr><td><code>2</code></td><td>Un parámetro no es válido.</td></tr><tr><td><code>3</code></td><td>La API de automatización no está disponible (no se alcanzó ninguna sesión).</td></tr><tr><td><code>4</code></td><td>Comando desconocido.</td></tr></tbody></table>

Una opción obligatoria que falta, un valor no válido o un tiempo de espera de `operation wait` sale con el código `2`.

## Comandos

### Sesión

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>status</code></td><td></td><td></td><td>Devuelve el transporte, el punto de conexión y la información de compilación de la sesión.</td></tr><tr><td><code>version</code></td><td></td><td></td><td>Devuelve el número de compilación de Devolutions UniGetUI.</td></tr></tbody></table>

### Aplicación

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>app status</code></td><td></td><td></td><td>Devuelve el estado de la sesión: sin interfaz o no, página actual, acciones de interfaz admitidas.</td></tr><tr><td><code>app show</code></td><td></td><td></td><td>Muestra la ventana de Devolutions UniGetUI y le da el foco.</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>Abre una página: <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> y, con el Catálogo de software activado, <code>catalog</code> y <code>catalog-editor</code>.</td></tr><tr><td><code>app quit</code></td><td></td><td></td><td>Cierra la sesión de forma ordenada, incluida una sin interfaz.</td></tr></tbody></table>

### Operaciones

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>operation list</code></td><td></td><td></td><td>Enumera las operaciones en ejecución, en cola y finalizadas.</td></tr><tr><td><code>operation get</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Devuelve todo sobre una operación.</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>Devuelve las líneas de salida de una operación.</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>Espera hasta que la operación tenga éxito, falle o se cancele. <code>--timeout</code>: 300 segundos de forma predeterminada, de 1 a 3600. <code>--delay</code> entre dos comprobaciones: 1 segundo de forma predeterminada, hasta 10.</td></tr><tr><td><code>operation cancel</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Cancela una operación en cola o en ejecución.</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>Vuelve a ejecutar la operación. Modos: <code>retry</code> (predeterminado), <code>retry-as-admin</code>, <code>retry-interactive</code>, <code>retry-no-hash-check</code>, <code>retry-close-running-app</code>. Los modos disponibles para una operación se enumeran en su información.</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>Mueve una operación en cola dentro de la cola.</td></tr><tr><td><code>operation forget</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Quita una operación finalizada de la lista.</td></tr></tbody></table>

### Gestores de paquetes

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>manager list</code></td><td></td><td></td><td>Enumera los gestores de paquetes y sus capacidades.</td></tr><tr><td><code>manager maintenance</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Devuelve la información de mantenimiento de un gestor.</td></tr><tr><td><code>manager reload</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Vuelve a cargar un gestor.</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>Usa un ejecutable personalizado y luego vuelve a cargar el gestor. Solo funciona cuando el ajuste seguro <code>AllowCustomManagerPaths</code> está activado.</td></tr><tr><td><code>manager clear-executable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Quita el ejecutable personalizado y luego vuelve a cargar el gestor.</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>Ejecuta una acción de mantenimiento específica del gestor y necesita <code>--confirm</code>: <code>repair-winget</code> (WinGet), <code>install-scoop</code>, <code>uninstall-scoop</code> y <code>cleanup-scoop</code> (Scoop). <code>manager maintenance</code> enumera las acciones de un gestor.</td></tr><tr><td><code>manager enable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Habilita el gestor.</td></tr><tr><td><code>manager disable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Deshabilita el gestor.</td></tr><tr><td><code>manager notifications enable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Activa las notificaciones de actualización para el gestor.</td></tr><tr><td><code>manager notifications disable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Desactiva las notificaciones de actualización para el gestor.</td></tr></tbody></table>

### Fuentes

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>source list</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Enumera los orígenes, opcionalmente para un gestor.</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>Agrega un origen.</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>Quita un origen.</td></tr></tbody></table>

### Configuración

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>settings list</code></td><td></td><td></td><td>Enumera la configuración normal y sus claves.</td></tr><tr><td><code>settings get</code></td><td><code>--key &#x3C;key></code></td><td></td><td>Lee un ajuste normal.</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>Establece un ajuste. Indique exactamente uno de <code>--enabled</code> (booleano) o <code>--value</code> (texto).</td></tr><tr><td><code>settings clear</code></td><td><code>--key &#x3C;key></code></td><td></td><td>Borra un ajuste de texto.</td></tr><tr><td><code>settings reset</code></td><td></td><td></td><td>Restablece la configuración normal.</td></tr><tr><td><code>settings secure list</code></td><td></td><td><code>--user &#x3C;name></code></td><td>Enumera la configuración segura (protegida por el administrador) del usuario actual o indicado.</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>Lee un ajuste seguro.</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>Activa o desactiva un ajuste seguro. En Windows, cambiarlo para el usuario actual muestra una solicitud de UAC; cambiarlo para otro usuario necesita una sesión en ejecución como administrador.</td></tr></tbody></table>

{% hint style="info" %}
Ejecute `uniget settings list` y `uniget settings secure list` para ver las claves disponibles. Cada clave, su valor predeterminado y lo que hace se describen en [Toda la configuración](https://docs.devolutions.net/unigetui/es/referencia/settings.md).
{% endhint %}

### Accesos directos del escritorio

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>shortcut list</code></td><td></td><td></td><td>Enumera los accesos directos del escritorio de los que se hace un seguimiento y si cada uno se conserva o se elimina. Solo se hace un seguimiento de los accesos directos <code>.lnk</code> de Windows.</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>Marca un acceso directo para conservarlo o eliminarlo.</td></tr><tr><td><code>shortcut reset</code></td><td><code>--path &#x3C;path></code></td><td></td><td>Borra la elección almacenada para un acceso directo.</td></tr><tr><td><code>shortcut reset-all</code></td><td></td><td></td><td>Borra las elecciones almacenadas para todos los accesos directos.</td></tr></tbody></table>

### Accesos directos del menú Inicio

Solo para Windows. La elección se almacena según la ruta del acceso directo y se vuelve a aplicar cada vez que una actualización vuelve a crear el acceso directo. Las rutas fuera de una carpeta `Programs` del menú Inicio, y los archivos que no son accesos directos `.lnk` o `.url`, se rechazan.

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>start-menu shortcut list</code></td><td></td><td></td><td>Enumera los accesos directos del menú Inicio de los que se hace seguimiento y si cada uno se conserva o se elimina.</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>Marca un acceso directo del menú Inicio para conservarlo o eliminarlo.</td></tr><tr><td><code>start-menu shortcut reset</code></td><td><code>--path &#x3C;path></code></td><td></td><td>Borra la elección almacenada para un acceso directo.</td></tr><tr><td><code>start-menu shortcut reset-all</code></td><td></td><td></td><td>Borra todas las elecciones almacenadas. Las reglas de carpeta y los accesos directos que movieron no se ven afectados.</td></tr></tbody></table>

### Carpetas del menú Inicio

Solo para Windows. Una regla de carpeta establece la subcarpeta de la carpeta `Programs` del menú Inicio del usuario actual en la que un paquete guarda sus accesos directos. Devolutions UniGetUI la aplica después de cada instalación y actualización, y elimina los accesos directos movidos cuando se desinstala el paquete.

* `--package` usa el formato `manager\PackageId`, por ejemplo `winget\Python.Python.3.13`. La parte del gestor va en minúsculas. La regla ignora el origen, así que dos paquetes con el mismo gestor y el mismo identificador, de orígenes distintos, comparten una sola regla.
* `--folder` debe ser una subcarpeta de la carpeta `Programs` del menú Inicio. Las rutas absolutas, los segmentos `..` y la carpeta del menú Inicio de todos los usuarios se rechazan.

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>start-menu folder list</code></td><td></td><td></td><td>Enumera las reglas de carpeta. Los paquetes que solo tienen accesos directos pendientes también se enumeran, con una carpeta vacía.</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>Crea una regla de carpeta. <code>--relocate-existing</code> también mueve los accesos directos existentes del paquete.</td></tr><tr><td><code>start-menu folder remove</code></td><td><code>--package &#x3C;manager\id></code></td><td></td><td>Quita la regla de carpeta de un paquete.</td></tr></tbody></table>

### Registros

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>log app</code></td><td></td><td><code>--level &#x3C;n></code></td><td>Devuelve el registro de la aplicación Devolutions UniGetUI. <code>--level</code>: <code>1</code> solo errores, <code>2</code> añade advertencias, <code>3</code> añade aciertos, <code>4</code> añade información (predeterminado), <code>5</code> añade entradas de depuración.</td></tr><tr><td><code>log operations</code></td><td></td><td></td><td>Devuelve el historial de operaciones.</td></tr><tr><td><code>log manager</code></td><td></td><td><code>--manager &#x3C;id></code>, <code>--verbose</code></td><td>Devuelve los registros del gestor de paquetes.</td></tr></tbody></table>

### Copias de seguridad

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>backup status</code></td><td></td><td></td><td>Devuelve la configuración de la copia de seguridad y el estado de inicio de sesión en GitHub.</td></tr><tr><td><code>backup local create</code></td><td></td><td></td><td>Crea una copia de seguridad local.</td></tr><tr><td><code>backup github login start</code></td><td></td><td><code>--launch-browser</code></td><td>Inicia el inicio de sesión en GitHub (flujo de dispositivo).</td></tr><tr><td><code>backup github login complete</code></td><td></td><td></td><td>Completa el inicio de sesión pendiente en GitHub.</td></tr><tr><td><code>backup github logout</code></td><td></td><td></td><td>Cierra la sesión de GitHub y quita el token almacenado.</td></tr><tr><td><code>backup cloud list</code></td><td></td><td></td><td>Enumera las copias de seguridad en la nube.</td></tr><tr><td><code>backup cloud create</code></td><td></td><td></td><td>Carga una copia de seguridad en la nube.</td></tr><tr><td><code>backup cloud download</code></td><td><code>--key &#x3C;name></code></td><td></td><td>Descarga una copia de seguridad en la nube como contenido de lote.</td></tr><tr><td><code>backup cloud restore</code></td><td><code>--key &#x3C;name></code></td><td><code>--append</code></td><td>Importa una copia de seguridad en la nube en el lote actual.</td></tr></tbody></table>

### Lotes

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>bundle get</code></td><td></td><td></td><td>Devuelve el lote actual.</td></tr><tr><td><code>bundle reset</code></td><td></td><td></td><td>Vacía el lote actual.</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>Importa un lote desde un archivo o desde contenido sin procesar.</td></tr><tr><td><code>bundle export</code></td><td></td><td><code>--path &#x3C;path></code></td><td>Exporta el lote actual, opcionalmente a un archivo.</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>Encuentra un paquete y lo añade al lote.</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>Quita los paquetes coincidentes del lote.</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>Instala los paquetes del lote.</td></tr></tbody></table>

### Paquetes

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</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>Busca paquetes. <code>--max-results</code>: 50 de forma predeterminada, hasta 500.</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>Devuelve los detalles de un paquete.</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>Devuelve las versiones instalables, cuando el gestor lo admite.</td></tr><tr><td><code>package installed</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Enumera los paquetes instalados.</td></tr><tr><td><code>package updates</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Enumera las actualizaciones disponibles.</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>Instala un paquete. De forma predeterminada, el comando espera a que termine la operación; con <code>--wait false</code> o <code>--detach</code>, devuelve un ID de operación de inmediato.</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>Descarga el instalador de un paquete. Sin <code>--output</code>, se guarda en la carpeta establecida en <em><strong>Ubicación predeterminada de los instaladores descargados</strong></em>, o en su carpeta <code>Downloads</code>.</td></tr><tr><td><code>package reinstall</code></td><td><code>--id &#x3C;package-id></code></td><td>Igual que <code>package install</code></td><td>Vuelve a instalar un paquete ya instalado.</td></tr><tr><td><code>package repair</code></td><td><code>--id &#x3C;package-id></code></td><td>Igual que <code>package install</code>, más <code>--remove-data true|false</code></td><td>Desinstala y luego vuelve a instalar el paquete.</td></tr><tr><td><code>package update</code></td><td><code>--id &#x3C;package-id></code></td><td>Igual que <code>package install</code></td><td>Actualiza un paquete.</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>Desinstala un paquete.</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>Abre los detalles del paquete en la ventana de Devolutions UniGetUI.</td></tr><tr><td><code>package ignored list</code></td><td></td><td></td><td>Enumera las actualizaciones ignoradas.</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>Ignora las actualizaciones de un paquete.</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>Deja de ignorar las actualizaciones de un paquete.</td></tr><tr><td><code>package update-all</code></td><td></td><td></td><td>Pone en cola las actualizaciones de cada paquete que se puede actualizar.</td></tr><tr><td><code>package update-manager</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Pone en cola las actualizaciones de cada paquete de un gestor.</td></tr></tbody></table>

## Sesiones sin interfaz

Inicie Devolutions UniGetUI con `--headless` para ejecutar la API de automatización sin ventana, por ejemplo en un agente de compilación o en un script. La sesión carga los gestores de paquetes y se ejecuta hasta `uniget app quit` o <kbd>Ctrl</kbd>+<kbd>C</kbd>. De las tareas del [mantenimiento programado](https://docs.devolutions.net/unigetui/es/referencia/settings.md#scheduled-maintenance), solo ejecuta la comprobación de actualizaciones.

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

<table><thead><tr><th width="250">PARÁMETRO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--ipc-api-transport {named-pipe|tcp}</code></td><td>Transporte de la API. Predeterminado: <code>named-pipe</code>.</td></tr><tr><td><code>--ipc-api-port &#x3C;port></code></td><td>Puerto TCP, con el transporte <code>tcp</code>.</td></tr><tr><td><code>--ipc-api-pipe-name &#x3C;name-or-path></code></td><td>Nombre de la canalización, o ruta del socket Unix en macOS y Linux.</td></tr></tbody></table>

Algunos comandos dependen de la ventana y se comportan de otra forma sin interfaz:

<table><thead><tr><th width="250">COMANDO</th><th>EN UNA SESIÓN SIN INTERFAZ</th></tr></thead><tbody><tr><td><code>status</code>, <code>app status</code>, <code>app quit</code></td><td>Totalmente admitido.</td></tr><tr><td><code>app show</code>, <code>app navigate</code></td><td>Error: no hay ninguna ventana.</td></tr><tr><td><code>package show</code>, <code>package update-all</code>, <code>package update-manager</code></td><td>Fallan: dependen de la ventana. Para actualizar paquetes sin interfaz, ejecute <code>package update</code> para cada paquete.</td></tr></tbody></table>

## Parámetros de inicio

El ejecutable de Devolutions UniGetUI también acepta estos parámetros.

<table><thead><tr><th width="250">PARÁMETRO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--daemon</code></td><td>Inicia Devolutions UniGetUI minimizado en el área de notificación. Un archivo de lote que se le pase se ignora.</td></tr><tr><td><code>--updateapps</code></td><td>Instala cada actualización disponible en cuanto la comprobación de actualizaciones las encuentra, con independencia de la configuración.</td></tr><tr><td><code>--help</code>, <code>-h</code></td><td>Muestra la ayuda de la CLI.</td></tr><tr><td><code>--import-settings &#x3C;file></code></td><td>Importa la configuración desde un archivo JSON y luego sale. La configuración existente se elimina primero.</td></tr><tr><td><code>--export-settings &#x3C;file></code></td><td>Exporta la configuración a un archivo JSON, creándolo o sobrescribiéndolo, y luego sale.</td></tr><tr><td><code>--enable-setting &#x3C;key></code>, <code>--disable-setting &#x3C;key></code></td><td>Establece una clave de ajuste en <code>true</code> o <code>false</code> y luego sale. Tenga en cuenta las claves marcadas como <em>(invertido)</em> en <a href="https://docs.devolutions.net/unigetui/es/referencia/settings.md">Toda la configuración</a>.</td></tr><tr><td><code>--set-setting-value &#x3C;key> &#x3C;value></code></td><td>Establece un ajuste de texto y luego sale.</td></tr><tr><td><code>--enable-secure-setting &#x3C;key></code>, <code>--disable-secure-setting &#x3C;key></code></td><td>Activa o desactiva un ajuste seguro para el usuario actual y luego sale. En Windows, muestra una solicitud de UAC.</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>Activa o desactiva un ajuste seguro para el usuario indicado y luego sale. Toma el nombre almacenado del ajuste tal como lo enumera <code>uniget settings secure list</code>, por ejemplo <code>AllowPrePostInstallCommands</code> en lugar de <code>AllowPrePostOpCommand</code>. En Windows, necesita derechos de administrador.</td></tr><tr><td><code>--no-corrupt-dialog</code></td><td>Solo Windows. Cuando faltan archivos de la instalación, muestra el informe detallado del bloqueo en lugar del cuadro de diálogo simplificado.</td></tr><tr><td><code>--delete-shortcuts &#x3C;path> [&#x3C;path>...]</code></td><td>Elimina accesos directos del escritorio o del menú Inicio y luego se cierra. Se usa internamente para quitar accesos directos que el usuario actual no puede eliminar. Solo se aceptan los archivos <code>.lnk</code> y <code>.url</code> de una carpeta del escritorio o del menú Inicio.</td></tr><tr><td><code>--migrate-wingetui-to-unigetui</code></td><td>Migra los datos y los accesos directos de una instalación heredada de WingetUI y luego se cierra.</td></tr><tr><td><code>--uninstall-wingetui</code>, <code>--uninstall-unigetui</code></td><td>Sale de inmediato sin abrir Devolutions UniGetUI. Se conserva para los desinstaladores de versiones anteriores.</td></tr><tr><td><code>&#x3C;bundle-file></code></td><td>Abre un lote en <em><strong>Lotes de paquetes</strong></em>. Extensiones admitidas: <code>.ubundle</code>, <code>.json</code>, <code>.yaml</code> y <code>.xml</code>. Si se indican varios lotes, solo se abre el primero.</td></tr></tbody></table>

Los parámetros de ajuste esperan la clave con sus mayúsculas exactas. Devuelven estos códigos de salida, que `uniget` transmite:

<table><thead><tr><th width="250">RESULTADO</th><th>WINDOWS</th><th>MACOS, LINUX E INTERFAZ DE TERMINAL</th></tr></thead><tbody><tr><td>Correcto</td><td><code>0</code></td><td><code>0</code></td></tr><tr><td>Error</td><td><code>-1</code></td><td><code>1</code></td></tr><tr><td>Falta el valor del parámetro</td><td><code>-1073741811</code></td><td><code>2</code></td></tr><tr><td>Archivo no encontrado (<code>--import-settings</code>)</td><td><code>-1073741809</code></td><td><code>3</code></td></tr><tr><td>Clave de ajuste desconocida</td><td><code>-2</code></td><td><code>4</code></td></tr></tbody></table>

## Variables de entorno

Devolutions UniGetUI las lee al iniciarse.

<table><thead><tr><th width="250">VARIABLE</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>UNIGETUI_WINGET_CLI</code></td><td>Herramienta que usa el gestor WinGet: <code>default</code>, <code>winget</code> o <code>pinget</code>. Reemplaza el ajuste <em><strong>Herramienta de línea de comandos de WinGet</strong></em>.</td></tr><tr><td><code>UNIGETUI_WINGET_COM</code></td><td>Uso de la API COM de WinGet: <code>default</code>, <code>enabled</code> o <code>disabled</code> (<code>on</code>/<code>off</code>, <code>true</code>/<code>false</code> y <code>1</code>/<code>0</code> también funcionan). Reemplaza el ajuste <em><strong>API COM de WinGet</strong></em>.</td></tr><tr><td><code>UNIGETUI_FONT_FAMILY</code></td><td>Familia de fuentes añadida al principio de la lista de fuentes de la interfaz, en todas las plataformas. Se ignora en Windows y Linux cuando el ajuste de fuente del sistema de <em><strong>Preferencias de la interfaz de usuario</strong></em> está activado.</td></tr><tr><td><code>UNIGETUI_FORCE_NATIVE_LINUX_DECORATIONS</code></td><td>Solo para Linux. Fuerza la barra de título del gestor de ventanas activada (<code>1</code>, <code>true</code>, <code>on</code>, <code>yes</code>, <code>enabled</code>) o desactivada (<code>0</code>, <code>false</code>, <code>off</code>, <code>no</code>, <code>disabled</code>), en lugar de detectarla.</td></tr><tr><td><code>UNIGETUI_GITHUB_TOKEN_NAMESPACE</code></td><td>Sufijo añadido a la entrada de credenciales del token de copia de seguridad de GitHub, para que varias instancias de Devolutions UniGetUI en un mismo ordenador puedan usar cuentas de GitHub distintas.</td></tr><tr><td><code>UNIGETUI_TUI_FAKE_DATA</code></td><td><code>1</code> o <code>true</code> inicia la <a href="https://github.com/Devolutions/RDM/tree/master/docs-products/translations/es/unigetui/reference/terminal-ui.md">interfaz de terminal</a> en modo de demostración, como <code>--fake-data</code>.</td></tr><tr><td><code>WEBVIEW2_BROWSER_EXECUTABLE_FOLDER</code></td><td>Solo para Windows. Carpeta de un runtime de WebView2 de versión fija, para usarla en lugar del instalado.</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>Consulte <a href="#connection-options">Opciones de conexión</a>.</td></tr></tbody></table>

## Vínculos profundos

En Windows, una instalación normal registra el protocolo `unigetui://`. Las instalaciones portátiles no lo hacen, y macOS y Linux no tienen el protocolo `unigetui://`. Las acciones de notificación usan estos enlaces para llegar a la aplicación en ejecución.

<table><thead><tr><th width="250">VÍNCULO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>unigetui://openUniGetUI</code></td><td>Muestra la ventana de Devolutions UniGetUI.</td></tr><tr><td><code>unigetui://openUniGetUIOnUpdatesTab</code></td><td>Muestra Devolutions UniGetUI en <em><strong>Actualizaciones de software</strong></em>.</td></tr><tr><td><code>unigetui://updateAll</code></td><td>Actualiza cada paquete que tiene una actualización.</td></tr><tr><td><code>unigetui://releaseSelfUpdateLock</code></td><td>Permite que continúe una actualización pendiente de Devolutions UniGetUI.</td></tr></tbody></table>

{% hint style="warning" %}
Un vínculo profundo solo actúa cuando Devolutions UniGetUI ya se está ejecutando. Si el vínculo inicia Devolutions UniGetUI, la aplicación se abre con normalidad y la acción se ignora. Para automatizar Devolutions UniGetUI, use los comandos anteriores o la [API de automatización](https://docs.devolutions.net/unigetui/es/referencia/ipc-api.md).
{% endhint %}

## Modificadores del instalador

Los modificadores del instalador de Windows (instalación silenciosa, todos los usuarios, portátil, omisión de dependencias) se enumeran en [Instalar Devolutions UniGetUI](https://docs.devolutions.net/unigetui/es/referencia/installation.md#installer-switches).


---

# 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/es/referencia/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.
