> 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/it/riferimento/cli.md).

# Interfaccia della riga di comando

Tutti i comandi della riga di comando, le opzioni, i parametri di avvio, le variabili d'ambiente, i collegamenti diretti e le opzioni del programma di installazione di UniGetUI.

Il comando `unigetui` controlla una sessione di UniGetUI in esecuzione da un terminale o da uno script: cercare, installare, aggiornare e rimuovere pacchetti, gestire le impostazioni, le origini, le raccolte e i backup, e leggere i registri. La CLI comunica con la sessione tramite l'[API di automazione](/unigetui/it/riferimento/ipc-api.md) locale.

{% hint style="info" %}
Se `unigetui` non viene riconosciuto nella shell, esegua invece l'eseguibile di UniGetUI dalla cartella di installazione, per esempio `UniGetUI.exe` in Windows.
{% endhint %}

## Requisiti

La CLI ha bisogno di una sessione di UniGetUI a cui connettersi:

* **Sessione desktop**: UniGetUI è aperto oppure è in esecuzione nell'area di notifica, e ***Abilita API in background (widget e condivisione UniGetUI, porta 7058)*** è attivato in ***Impostazioni*** – ***Impostazioni sperimentali e opzioni sviluppatore***.
* **Sessione senza interfaccia**: UniGetUI è stato avviato con `--headless`. Veda [Sessioni senza interfaccia](#headless-sessions).

Se nessuna sessione è raggiungibile, il comando termina con il codice `3`.

## Avvio rapido

```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
```

## Sintassi

* I nomi accettano il singolare o il plurale: `operation`/`operations`, `package`/`packages`, `manager`/`managers`, `source`/`sources`, `shortcut`/`shortcuts`, `log`/`logs`, `backup`/`backups`, `bundle`/`bundles`.
* `startmenu` è accettato per `start-menu`, e `folders` per `folder`.
* Le opzioni booleane richiedono un valore esplicito: `--enabled true`, `--wait false`.
* `--detach` è l'abbreviazione di `--wait false` sulle operazioni dei pacchetti. Il comando restituisce subito un ID operazione.
* Alias:
  * `--id` corrisponde a `--package-id` oppure a `--operation-id`, a seconda del comando.
  * `--source` corrisponde a `--package-source`.
  * `--source-name` e `--source-url` corrispondono a `--name` e `--url` in `source add` e `source remove`.
  * `--name` corrisponde a `--key` in `backup cloud download` e `backup cloud restore`.
* `--manager` accetta un ID gestore stabile, non il nome mostrato nell'applicazione: `apt`, `bun`, `cargo`, `chocolatey`, `dnf`, `dotnet-tool`, `flatpak`, `homebrew`, `npm`, `pacman`, `pip`, `pwsh`, `scoop`, `snap`, `vcpkg`, `winget`, `winps`. Funzionano solo i gestori della piattaforma corrente. Veda [Gestori di pacchetti supportati](/unigetui/it/riferimento/package-managers.md).

## Opzioni di connessione

Per impostazione predefinita, la CLI trova da sola la sessione in esecuzione. Usi queste opzioni per puntare a una sessione specifica.

<table><thead><tr><th width="250">OPZIONE</th><th>VARIABILE D'AMBIENTE</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Trasporto usato per raggiungere la sessione. Predefinito: <code>named-pipe</code>.</td></tr><tr><td><code>--tcp-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>Porta TCP della sessione. 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>Named pipe della sessione. In Windows, un nome di pipe. Su macOS e Linux, un nome relativo viene risolto sotto <code>/tmp</code> e un percorso assoluto viene usato come percorso esatto del socket Unix.</td></tr></tbody></table>

## Codici di uscita

<table><thead><tr><th width="250">CODICE</th><th>SIGNIFICATO</th></tr></thead><tbody><tr><td><code>0</code></td><td>Esito positivo.</td></tr><tr><td><code>1</code></td><td>Il comando non è riuscito.</td></tr><tr><td><code>2</code></td><td>Un parametro non è valido.</td></tr><tr><td><code>3</code></td><td>L'API di automazione non è disponibile (nessuna sessione raggiunta).</td></tr><tr><td><code>4</code></td><td>Comando sconosciuto.</td></tr></tbody></table>

## Comandi

### Sessione

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>status</code></td><td></td><td></td><td>Restituisce il trasporto, l'endpoint e le informazioni di build della sessione.</td></tr><tr><td><code>version</code></td><td></td><td></td><td>Restituisce il numero di build di UniGetUI.</td></tr></tbody></table>

### Applicazione

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>app status</code></td><td></td><td></td><td>Restituisce lo stato della sessione: senza interfaccia o no, pagina corrente, azioni dell'interfaccia supportate.</td></tr><tr><td><code>app show</code></td><td></td><td></td><td>Mostra la finestra di UniGetUI e le assegna lo stato attivo.</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>Apre una pagina: <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>Chiude la sessione in modo ordinato, compresa una senza interfaccia.</td></tr></tbody></table>

### Operazioni

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>operation list</code></td><td></td><td></td><td>Elenca le operazioni in esecuzione, in coda e completate.</td></tr><tr><td><code>operation get</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Restituisce tutto su un'operazione.</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>Restituisce le righe di output di un'operazione.</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>Attende che l'operazione finisca.</td></tr><tr><td><code>operation cancel</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Annulla un'operazione in coda o in esecuzione.</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>Esegue di nuovo l'operazione. Le modalità disponibili sono elencate nelle informazioni dell'operazione.</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>Sposta un'operazione in coda all'interno della coda.</td></tr><tr><td><code>operation forget</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Rimuove un'operazione completata dall'elenco.</td></tr></tbody></table>

### Gestori di pacchetti

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>manager list</code></td><td></td><td></td><td>Elenca i gestori di pacchetti e le loro capacità.</td></tr><tr><td><code>manager maintenance</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Restituisce le informazioni di manutenzione di un gestore.</td></tr><tr><td><code>manager reload</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Ricarica un gestore.</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 eseguibile personalizzato, poi ricarica il gestore.</td></tr><tr><td><code>manager clear-executable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Rimuove l'eseguibile personalizzato, poi ricarica il gestore.</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>Esegue un'azione di manutenzione specifica del gestore.</td></tr><tr><td><code>manager enable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Abilita il gestore.</td></tr><tr><td><code>manager disable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Disabilita il gestore.</td></tr><tr><td><code>manager notifications enable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Attiva le notifiche di aggiornamento per il gestore.</td></tr><tr><td><code>manager notifications disable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Disattiva le notifiche di aggiornamento per il gestore.</td></tr></tbody></table>

### Sorgenti

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>source list</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Elenca le origini, facoltativamente per un solo gestore.</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>Aggiunge un'origine.</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>Rimuove un'origine.</td></tr></tbody></table>

### Impostazioni

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>settings list</code></td><td></td><td></td><td>Elenca le impostazioni normali e le relative chiavi.</td></tr><tr><td><code>settings get</code></td><td><code>--key &#x3C;key></code></td><td></td><td>Legge un'impostazione normale.</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>Imposta un'impostazione, come valore booleano o come testo.</td></tr><tr><td><code>settings clear</code></td><td><code>--key &#x3C;key></code></td><td></td><td>Cancella un'impostazione di testo.</td></tr><tr><td><code>settings reset</code></td><td></td><td></td><td>Reimposta le impostazioni normali.</td></tr><tr><td><code>settings secure list</code></td><td></td><td><code>--user &#x3C;name></code></td><td>Elenca le impostazioni sicure (protette dall'amministratore) dell'utente corrente o indicato.</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>Legge un'impostazione sicura.</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>Attiva o disattiva un'impostazione sicura.</td></tr></tbody></table>

{% hint style="info" %}
Esegua `unigetui settings list` e `unigetui settings secure list` per vedere le chiavi disponibili. La funzione di ogni impostazione è descritta in [Tutte le impostazioni](/unigetui/it/riferimento/settings.md).
{% endhint %}

### Collegamenti sul desktop

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>shortcut list</code></td><td></td><td></td><td>Elenca i collegamenti sul desktop tracciati e se ognuno viene conservato o eliminato.</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>Contrassegna un collegamento da conservare o eliminare.</td></tr><tr><td><code>shortcut reset</code></td><td><code>--path &#x3C;path></code></td><td></td><td>Cancella la scelta archiviata per un collegamento.</td></tr><tr><td><code>shortcut reset-all</code></td><td></td><td></td><td>Cancella le scelte archiviate per tutti i collegamenti.</td></tr></tbody></table>

### Collegamenti del menu Start

Solo per Windows. La scelta viene archiviata in base al percorso del collegamento e applicata di nuovo ogni volta che un aggiornamento ricrea il collegamento. I percorsi fuori da una cartella `Programs` del menu Start e i file che non sono collegamenti `.lnk` o `.url` vengono rifiutati.

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>start-menu shortcut list</code></td><td></td><td></td><td>Elenca i collegamenti del menu Start tracciati e se ognuno viene conservato o eliminato.</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>Contrassegna un collegamento del menu Start da conservare o eliminare.</td></tr><tr><td><code>start-menu shortcut reset</code></td><td><code>--path &#x3C;path></code></td><td></td><td>Cancella la scelta archiviata per un collegamento.</td></tr><tr><td><code>start-menu shortcut reset-all</code></td><td></td><td></td><td>Cancella tutte le scelte archiviate. Le regole delle cartelle e i collegamenti che hanno spostato non sono interessati.</td></tr></tbody></table>

### Cartelle del menu Start

Solo per Windows. Una regola di cartella imposta la sottocartella della cartella `Programs` del menu Start dell'utente corrente in cui un pacchetto conserva i collegamenti. UniGetUI la applica dopo ogni installazione e aggiornamento, ed elimina i collegamenti spostati quando il pacchetto viene disinstallato.

* `--package` usa il formato `manager\PackageId`, per esempio `winget\Python.Python.3.13`. La parte del gestore è in minuscolo. La regola ignora l'origine, quindi due pacchetti con lo stesso gestore e lo stesso ID, da origini diverse, condividono una sola regola.
* `--folder` deve essere una sottocartella della cartella `Programs` del menu Start. I percorsi assoluti, i segmenti `..` e la cartella del menu Start di tutti gli utenti vengono rifiutati.

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>start-menu folder list</code></td><td></td><td></td><td>Elenca le regole delle cartelle. Anche i pacchetti che hanno solo collegamenti in sospeso vengono elencati, con una cartella vuota.</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 regola di cartella. <code>--relocate-existing</code> sposta anche i collegamenti esistenti del pacchetto.</td></tr><tr><td><code>start-menu folder remove</code></td><td><code>--package &#x3C;manager\id></code></td><td></td><td>Rimuove la regola di cartella di un pacchetto.</td></tr></tbody></table>

### Registri

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>log app</code></td><td></td><td><code>--level &#x3C;n></code></td><td>Restituisce il registro dell'applicazione di UniGetUI.</td></tr><tr><td><code>log operations</code></td><td></td><td></td><td>Restituisce la cronologia delle operazioni.</td></tr><tr><td><code>log manager</code></td><td></td><td><code>--manager &#x3C;id></code>, <code>--verbose</code></td><td>Restituisce i registri del gestore di pacchetti.</td></tr></tbody></table>

### Backup

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>backup status</code></td><td></td><td></td><td>Restituisce le impostazioni di backup e lo stato di accesso a GitHub.</td></tr><tr><td><code>backup local create</code></td><td></td><td></td><td>Crea un backup locale.</td></tr><tr><td><code>backup github login start</code></td><td></td><td><code>--launch-browser</code></td><td>Avvia l'accesso a GitHub (flusso del dispositivo).</td></tr><tr><td><code>backup github login complete</code></td><td></td><td></td><td>Completa l'accesso a GitHub in sospeso.</td></tr><tr><td><code>backup github logout</code></td><td></td><td></td><td>Disconnette da GitHub e rimuove il token archiviato.</td></tr><tr><td><code>backup cloud list</code></td><td></td><td></td><td>Elenca i backup nel cloud.</td></tr><tr><td><code>backup cloud create</code></td><td></td><td></td><td>Carica un backup nel cloud.</td></tr><tr><td><code>backup cloud download</code></td><td><code>--key &#x3C;name></code></td><td></td><td>Scarica un backup nel cloud come contenuto della raccolta.</td></tr><tr><td><code>backup cloud restore</code></td><td><code>--key &#x3C;name></code></td><td><code>--append</code></td><td>Importa un backup nel cloud nella raccolta corrente.</td></tr></tbody></table>

### Raccolte

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>bundle get</code></td><td></td><td></td><td>Restituisce la raccolta corrente.</td></tr><tr><td><code>bundle reset</code></td><td></td><td></td><td>Svuota la raccolta corrente.</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 una raccolta da un file o da contenuto non elaborato.</td></tr><tr><td><code>bundle export</code></td><td></td><td><code>--path &#x3C;path></code></td><td>Esporta la raccolta corrente, facoltativamente in un file.</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>Trova un pacchetto e lo aggiunge alla raccolta.</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>Rimuove i pacchetti corrispondenti dalla raccolta.</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>Installa i pacchetti della raccolta.</td></tr></tbody></table>

### Pacchetti

<table><thead><tr><th width="250">COMANDO</th><th>OBBLIGATORIO</th><th>FACOLTATIVO</th><th>CHE COSA FA</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>Cerca pacchetti.</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>Restituisce i dettagli di un pacchetto.</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>Restituisce le versioni installabili, quando il gestore lo supporta.</td></tr><tr><td><code>package installed</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Elenca i pacchetti installati.</td></tr><tr><td><code>package updates</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Elenca gli aggiornamenti disponibili.</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>Installa un pacchetto. La modalità asincrona restituisce subito un ID operazione.</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>Scarica il programma di installazione di un pacchetto.</td></tr><tr><td><code>package reinstall</code></td><td><code>--id &#x3C;package-id></code></td><td>Come <code>package install</code></td><td>Installa di nuovo un pacchetto già installato.</td></tr><tr><td><code>package repair</code></td><td><code>--id &#x3C;package-id></code></td><td>Come <code>package install</code>, più <code>--remove-data true|false</code></td><td>Disinstalla e poi reinstalla il pacchetto.</td></tr><tr><td><code>package update</code></td><td><code>--id &#x3C;package-id></code></td><td>Come <code>package install</code></td><td>Aggiorna un pacchetto.</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>Disinstalla un pacchetto.</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>Apre i dettagli del pacchetto nella finestra di UniGetUI.</td></tr><tr><td><code>package ignored list</code></td><td></td><td></td><td>Elenca gli aggiornamenti ignorati.</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 gli aggiornamenti di un pacchetto.</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>Smette di ignorare gli aggiornamenti di un pacchetto.</td></tr><tr><td><code>package update-all</code></td><td></td><td></td><td>Mette in coda gli aggiornamenti di ogni pacchetto che può essere aggiornato.</td></tr><tr><td><code>package update-manager</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Mette in coda gli aggiornamenti di ogni pacchetto di un gestore.</td></tr></tbody></table>

## Sessioni senza interfaccia

Avvii UniGetUI con `--headless` per eseguire l'API di automazione senza una finestra, per esempio su un agente di build o in uno script.

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

<table><thead><tr><th width="250">PARAMETRO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--ipc-api-transport {named-pipe|tcp}</code></td><td>Trasporto dell'API. Predefinito: <code>named-pipe</code>.</td></tr><tr><td><code>--ipc-api-port &#x3C;port></code></td><td>Porta TCP, con il trasporto <code>tcp</code>.</td></tr><tr><td><code>--ipc-api-pipe-name &#x3C;name-or-path></code></td><td>Nome della pipe, o percorso del socket Unix su macOS e Linux.</td></tr></tbody></table>

Alcuni comandi dipendono dalla finestra e si comportano diversamente senza interfaccia:

<table><thead><tr><th width="250">COMANDO</th><th>IN UNA SESSIONE SENZA INTERFACCIA</th></tr></thead><tbody><tr><td><code>status</code>, <code>app status</code>, <code>app quit</code></td><td>Completamente supportato.</td></tr><tr><td><code>app show</code>, <code>app navigate</code></td><td>Errore: non c'è nessuna finestra.</td></tr><tr><td><code>package show</code></td><td>Apre un flusso dell'interfaccia, quindi può non riuscire o non fare nulla.</td></tr><tr><td><code>package update-all</code>, <code>package update-manager</code></td><td>Possono non riuscire: si affidano alla finestra per avviare gli aggiornamenti.</td></tr></tbody></table>

## Parametri di avvio

L'eseguibile di UniGetUI accetta anche questi parametri.

<table><thead><tr><th width="250">PARAMETRO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--daemon</code></td><td>Avvia UniGetUI ridotto a icona nell'area di notifica.</td></tr><tr><td><code>--updateapps</code></td><td>Forza l'installazione degli aggiornamenti disponibili. Conservato per compatibilità.</td></tr><tr><td><code>--help</code>, <code>-h</code></td><td>Mostra la guida della CLI.</td></tr><tr><td><code>--import-settings &#x3C;file></code></td><td>Importa le impostazioni da un file JSON. Le impostazioni esistenti vengono sostituite.</td></tr><tr><td><code>--export-settings &#x3C;file></code></td><td>Esporta le impostazioni in un file JSON, creandolo o sovrascrivendolo.</td></tr><tr><td><code>--enable-setting &#x3C;key></code>, <code>--disable-setting &#x3C;key></code></td><td>Attiva o disattiva un'impostazione booleana.</td></tr><tr><td><code>--set-setting-value &#x3C;key> &#x3C;value></code></td><td>Imposta un'impostazione di testo.</td></tr><tr><td><code>--enable-secure-setting &#x3C;key></code>, <code>--disable-secure-setting &#x3C;key></code></td><td>Attiva o disattiva un'impostazione sicura per l'utente corrente. Può richiedere diritti di amministratore.</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>Attiva o disattiva un'impostazione sicura per l'utente indicato. Può richiedere diritti di amministratore.</td></tr><tr><td><code>--no-corrupt-dialog</code></td><td>Mostra il report di arresto anomalo dettagliato invece della finestra di dialogo semplificata.</td></tr><tr><td><code>--delete-shortcuts &#x3C;path> [&#x3C;path>...]</code></td><td>Elimina i collegamenti del desktop o del menu Start e poi si chiude. Viene usato internamente per rimuovere collegamenti che l'utente corrente non può eliminare. Sono accettati solo i file <code>.lnk</code> e <code>.url</code> in una cartella del desktop o del menu Start.</td></tr><tr><td><code>--migrate-wingetui-to-unigetui</code></td><td>Migra i dati e i collegamenti di un'installazione precedente di WingetUI e poi si chiude.</td></tr><tr><td><code>--uninstall-wingetui</code></td><td>Rimuove il precedente WingetUI dal pannello di notifica e si chiude. Viene usato dal programma di disinstallazione di WingetUI.</td></tr><tr><td><code>&#x3C;bundle-file></code></td><td>Apre una raccolta in <em><strong>Raccolte pacchetti</strong></em>. Le estensioni supportate includono <code>.ubundle</code>, <code>.json</code>, <code>.yaml</code> e <code>.xml</code>.</td></tr></tbody></table>

## Variabili d'ambiente

Lette da UniGetUI all'avvio.

<table><thead><tr><th width="250">VARIABILE</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>UNIGETUI_WINGET_CLI</code></td><td>Strumento usato dal gestore WinGet: <code>default</code>, <code>winget</code> o <code>pinget</code>. Sostituisce l'impostazione <em><strong>Strumento da riga di comando WinGet</strong></em>.</td></tr><tr><td><code>UNIGETUI_WINGET_COM</code></td><td>Uso dell'API COM di WinGet: <code>default</code>, <code>enabled</code> o <code>disabled</code> (<code>on</code>/<code>off</code>, <code>true</code>/<code>false</code> e <code>1</code>/<code>0</code> funzionano anch'essi). Sostituisce l'impostazione <em><strong>API COM di WinGet</strong></em>.</td></tr><tr><td><code>UNIGETUI_FONT_FAMILY</code></td><td>Solo per Windows. Famiglia di caratteri aggiunta all'inizio dell'elenco dei caratteri dell'interfaccia. Viene ignorata quando UniGetUI usa il carattere di sistema di Windows.</td></tr><tr><td><code>UNIGETUI_FORCE_NATIVE_LINUX_DECORATIONS</code></td><td>Solo per Linux. Forza la barra del titolo del gestore di finestre attivata (<code>1</code>, <code>true</code>, <code>on</code>, <code>yes</code>, <code>enabled</code>) o disattivata (<code>0</code>, <code>false</code>, <code>off</code>, <code>no</code>, <code>disabled</code>), invece di rilevarla.</td></tr><tr><td><code>UNIGETUI_GITHUB_TOKEN_NAMESPACE</code></td><td>Suffisso aggiunto alla voce delle credenziali del token di backup di GitHub, così più istanze di UniGetUI sullo stesso computer possono usare account GitHub diversi.</td></tr><tr><td><code>WEBVIEW2_BROWSER_EXECUTABLE_FOLDER</code></td><td>Solo per Windows. Cartella di un runtime WebView2 a versione fissa, da usare al posto di quello installato.</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>Veda <a href="#connection-options">Opzioni di connessione</a>.</td></tr></tbody></table>

## Collegamenti diretti

In Windows, un'installazione normale registra il protocollo `unigetui://`. Le installazioni portatili no.

<table><thead><tr><th width="250">COLLEGAMENTO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>unigetui://openUniGetUI</code></td><td>Mostra la finestra di UniGetUI.</td></tr><tr><td><code>unigetui://openUniGetUIOnUpdatesTab</code></td><td>Mostra UniGetUI in <em><strong>Aggiorna pacchetti</strong></em>.</td></tr><tr><td><code>unigetui://updateAll</code></td><td>Aggiorna ogni pacchetto che ha un aggiornamento.</td></tr><tr><td><code>unigetui://releaseSelfUpdateLock</code></td><td>Consente a un aggiornamento in sospeso di UniGetUI di proseguire.</td></tr></tbody></table>

{% hint style="warning" %}
Un collegamento diretto agisce solo quando UniGetUI è già in esecuzione. Se il collegamento avvia UniGetUI, l'applicazione si apre normalmente e l'azione viene ignorata. Per automatizzare UniGetUI, usi i comandi precedenti o l'[API di automazione](/unigetui/it/riferimento/ipc-api.md).
{% endhint %}

## Opzioni del programma di installazione

Le opzioni del programma di installazione di Windows (installazione invisibile all'utente, tutti gli utenti, portatile, salto delle dipendenze) sono elencate in [Installare UniGetUI](/unigetui/it/riferimento/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/it/riferimento/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.