> 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/cli/it/riferimento/commands/workspaces-vaults-variables.md).

# Comandi di spazio di lavoro, di cassaforte e di variabile

Ogni comando devo workspace, devo vault e devo variable, con ogni opzione, il suo valore predefinito, i valori consentiti e i tipi di spazio di lavoro che la accettano.

Questa pagina descrive ogni comando `devo workspace`, `devo vault` e `devo variable` e ogni opzione che può digitare con esso. Per l’elenco breve di tutti i comandi, consulti [Comandi](/cli/it/riferimento/commands.md). Per un aiuto passo dopo passo, consulti [Gestire casseforti e voci](/cli/it/per-devops-e-amministratori/manage/vaults-and-entries.md) e [Usare variabili personalizzate](/cli/it/per-devops-e-amministratori/manage/custom-variables.md). Le opzioni che ogni comando accetta, come `--context`, `--output json` o `--non-interactive`, sono descritte in [Opzioni globali](/cli/it/riferimento/global-options.md) e non sono ripetute qui. Per i comandi delle voci, consulti [Comandi delle voci](/cli/it/riferimento/commands/entries.md).

{% hint style="info" %}
Per vedere la guida di un comando, con la formulazione esatta, esegua `devo <command> --help`, per esempio `devo vault list --help`.
{% endhint %}

## Come funzionano questi comandi

* **Selezione di uno spazio di lavoro o di una cassaforte**: i comandi prendono il **nome** per impostazione predefinita, confrontato esattamente, senza distinzione tra maiuscole e minuscole. Per passare un ID, scriva `id:<value>` o aggiunga `--id`. `name:<value>` impone un nome. Le eccezioni sono elencate sotto ogni comando, come `devo workspace delete`, che richiede l’ID esatto dello spazio di lavoro.
* **Spazio di lavoro corrente e cassaforte corrente**: la maggior parte dei comandi lavora nello spazio di lavoro corrente e nella cassaforte corrente. Li imposti con `devo workspace use` e `devo vault use`. Per usare un altro contesto per un comando, aggiunga `--context <name>`. Consulti [Passare da uno spazio di lavoro all’altro](/cli/it/guide/connect/switch-workspaces.md).
* **Conferma di una modifica**: ogni comando che crea, modifica o elimina qualcosa rifiuta di essere eseguito senza `--yes` (alias `-y` e `--confirmed`) e si ferma con `confirmationRequired`. Non viene modificato nulla.
* **Tipi di spazio di lavoro**: un comando che lo spazio di lavoro selezionato non supporta si ferma con `operationNotSupportedBySource` (Devolutions Cloud, Devolutions Server) o con un codice che dice che il profilo locale non può farlo. Consulti [Un comando indica che lo spazio di lavoro non lo supporta](/cli/it/aiuto/troubleshooting/not-supported.md).

## Gruppi di comandi

<table><thead><tr><th width="300">GRUPPO</th><th>COMANDI</th></tr></thead><tbody><tr><td><code>devo workspace</code></td><td><code>list</code> (<code>ls</code>), <code>current</code>, <code>use</code>, <code>create</code>, <code>delete</code> (<code>rm</code>)</td></tr><tr><td><code>devo workspace variable</code></td><td><code>list</code> (<code>ls</code>), <code>set</code>, <code>delete</code> (<code>rm</code>)</td></tr><tr><td><code>devo vault</code></td><td><code>list</code> (<code>ls</code>), <code>get</code>, <code>current</code>, <code>use</code>, <code>create</code>, <code>create-many</code>, <code>update</code>, <code>delete</code> (<code>rm</code>)</td></tr><tr><td><code>devo vault settings</code></td><td><code>get</code></td></tr><tr><td><code>devo vault template</code></td><td><code>list</code> (<code>ls</code>)</td></tr><tr><td><code>devo vault access</code></td><td><code>list</code> (<code>ls</code>), <code>grant</code>, <code>revoke</code> (<code>rm</code>)</td></tr><tr><td><code>devo vault variable</code></td><td><code>list</code> (<code>ls</code>), <code>set</code>, <code>delete</code> (<code>rm</code>)</td></tr><tr><td><code>devo variable</code></td><td><code>export</code></td></tr></tbody></table>

## devo workspace list

Elenca gli spazi di lavoro che può usare, con nome, ID, tipo e se ciascuno è disponibile, è quello corrente ed è quello predefinito. Lo spazio di lavoro corrente è contrassegnato con `*`. Un nuovo profilo locale senza alcuno spazio di lavoro restituisce un elenco vuoto. Alias: `devo workspace ls`.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo workspace list
```

Questo comando non ha opzioni proprie.

## devo workspace current

Mostra lo spazio di lavoro corrente.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo workspace current
```

Questo comando non ha opzioni proprie.

## devo workspace use

Rende uno spazio di lavoro quello corrente.

**Spazio di lavoro:** Profilo locale

```bash
devo workspace use <workspace> [--id] [--password-env <variable>]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;workspace></code></td><td></td><td>Obbligatorio. Nome dello spazio di lavoro, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>. Uno spazio di lavoro sconosciuto si ferma con <code>workspaceNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;workspace></code> come un ID.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Variabile d’ambiente che contiene la password dello spazio di lavoro. Quando la passa, la variabile deve esistere, altrimenti il comando si ferma con <code>invalidParameterValue</code>. Un profilo locale non ha bisogno di una password per selezionare uno spazio di lavoro.</td></tr></tbody></table>

Su Devolutions Cloud e Devolutions Server il comando si ferma con `operationNotSupportedBySource`: selezioni un altro spazio di lavoro con `--context` o `devo context use`.

## devo workspace create

Crea uno spazio di lavoro SQLite nella cartella del profilo locale e, a meno che non aggiunga `--no-set-current`, lo rende quello corrente. La passphrase che indica protegge il nuovo spazio di lavoro.

**Spazio di lavoro:** Profilo locale

```bash
devo workspace create <name> (--passphrase-file <file> | --passphrase-env <variable>) [--path <file-name>] [--no-set-current] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obbligatorio. Nome dello spazio di lavoro. Senza <code>--path</code>, è anche il nome del file del database.</td></tr><tr><td><code>--kind &#x3C;kind></code></td><td><code>sqlite</code></td><td>Tipo di spazio di lavoro. Un profilo locale crea solo spazi di lavoro <code>sqlite</code>; qualsiasi altro tipo si ferma con <code>operationNotSupportedBySource</code>.</td></tr><tr><td><code>--path &#x3C;file-name></code></td><td><code>&#x3C;name>.db</code></td><td>Nome del file del database, creato nella cartella del profilo. Passi un nome di file, non un percorso con cartelle: un percorso si ferma con <code>invalidParameterValue</code>. <code>.db</code> è aggiunto se il nome non termina con esso.</td></tr><tr><td><code>--passphrase-file &#x3C;file></code></td><td></td><td>File privato che contiene la passphrase che protegge il nuovo spazio di lavoro. Devolutions Cloud e Devolutions Server rifiutano questa opzione.</td></tr><tr><td><code>--passphrase-env &#x3C;variable></code></td><td></td><td>Variabile d’ambiente che contiene la passphrase che protegge il nuovo spazio di lavoro. Devolutions Cloud e Devolutions Server rifiutano questa opzione.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Variabile d’ambiente che contiene il materiale della password dello spazio di lavoro. Un profilo locale la rifiuta: usi <code>--passphrase-file</code> o <code>--passphrase-env</code>.</td></tr><tr><td><code>--no-set-current</code></td><td>Disattivato</td><td>Crea lo spazio di lavoro senza renderlo quello corrente.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma la creazione. Obbligatorio.</td></tr></tbody></table>

Su un profilo locale, passi esattamente uno tra `--passphrase-file` e `--passphrase-env`. Senza nessuno dei due, o con entrambi, il comando si ferma con `invalidParameterValue`. Su Devolutions Cloud e Devolutions Server il comando si ferma con `operationNotSupportedBySource`, con o senza `--password-env`.

## devo workspace delete

Elimina uno spazio di lavoro SQLite del profilo locale: il file del database e i file temporanei sono eliminati dalla cartella del profilo. Non si può annullare. Alias: `devo workspace rm`.

Disponibile solo su Windows. Su macOS e Linux, il comando si arresta con `sqliteWorkspaceDeleteUnsupported` (codice di uscita `3`).

**Spazio di lavoro:** Profilo locale

```bash
devo workspace delete <workspace-id> --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;workspace></code></td><td></td><td>Obbligatorio. L’ID esatto dello spazio di lavoro che <code>devo workspace list</code> mostra, come <code>sqlite:Connections.db</code>, con o senza il prefisso <code>id:</code>. Un nome di spazio di lavoro non è accettato.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;workspace></code> come un ID. Non serve quando passa l’ID <code>sqlite:</code>.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma l’eliminazione. Obbligatorio.</td></tr></tbody></table>

## devo workspace variable list

Elenca le variabili personalizzate dello spazio di lavoro corrente, con nome, valore, ambito, origine e descrizione. I valori sono mostrati in testo in chiaro, tranne per le variabili il cui nome, o uno dei cui campi memorizzati, contiene `password`, `secret`, `token`, `encrypt`, `protected` o `safevalue`: il valore torna vuoto e sono contrassegnate `redacted`. Alias: `devo workspace variable ls`.

**Spazio di lavoro:** Profilo locale

```bash
devo workspace variable list [<name>]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Tutte le variabili</td><td>Filtro del nome facoltativo, senza distinzione tra maiuscole e minuscole. <code>*</code> corrisponde a qualsiasi testo e <code>?</code> a un carattere. Senza un carattere jolly, il nome deve corrispondere esattamente. I delimitatori <code>$</code> sono facoltativi.</td></tr></tbody></table>

## devo workspace variable set

Crea una variabile personalizzata dello spazio di lavoro corrente, oppure la aggiorna se esiste. Il valore proviene da una variabile d’ambiente o da un file, mai dalla riga di comando.

**Spazio di lavoro:** Profilo locale

```bash
devo workspace variable set <name> (--value-env <variable> | --value-file <file>) [--description <text>] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obbligatorio. Nome della variabile: solo lettere, numeri e trattini bassi. I delimitatori <code>$</code> sono facoltativi; il nome è salvato in maiuscolo, tra segni <code>$</code>.</td></tr><tr><td><code>--value-env &#x3C;variable></code></td><td></td><td>Variabile d’ambiente che contiene il valore. La variabile deve esistere.</td></tr><tr><td><code>--value-file &#x3C;file></code></td><td></td><td>File che contiene il valore. Viene usato tutto il contenuto così com’è, inclusa un’interruzione di riga finale.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Invariato</td><td>Descrizione della variabile. Senza di essa, una descrizione esistente viene conservata.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma la modifica. Obbligatorio.</td></tr></tbody></table>

Passi esattamente uno tra `--value-env` e `--value-file`: entrambi fermano il comando con `conflictingOptions`, nessuno dei due con `missingParameter`. Impostare di nuovo lo stesso valore e la stessa descrizione ferma il comando con `sqliteVariableUpdateNoChanges`. Le modifiche richiedono un database locale non crittografato.

## devo workspace variable delete

Elimina le variabili personalizzate dello spazio di lavoro corrente. Alias: `devo workspace variable rm`.

**Spazio di lavoro:** Profilo locale

```bash
devo workspace variable delete <name> [<name>…] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Obbligatorio. Uno o più nomi di variabile. Se un nome non esiste, o compare due volte, il comando fallisce e non elimina nulla.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma l’eliminazione. Obbligatorio.</td></tr></tbody></table>

## devo vault list

Elenca le casseforti dello spazio di lavoro corrente, con nome, ID e tipo. La cassaforte corrente è contrassegnata. Alias: `devo vault ls`.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo vault list [<vault>] [--id]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td>Tutte le casseforti</td><td>Facoltativo. Tiene solo la cassaforte con questo nome, o con questo ID con <code>id:&#x3C;value></code> o <code>--id</code>. Il nome viene confrontato esattamente, senza distinzione tra maiuscole e minuscole, su ogni tipo di spazio di lavoro. Su Devolutions Cloud e Devolutions Server le casseforti sono ordinate per nome.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;vault></code> come un ID.</td></tr></tbody></table>

## devo vault get

Mostra una cassaforte.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo vault get <vault> [--id]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obbligatorio. Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>. Il nome viene confrontato esattamente, senza distinzione tra maiuscole e minuscole, su ogni tipo di spazio di lavoro. Quando nessuna cassaforte corrisponde, il comando si ferma con <code>vaultNotFound</code>; quando più casseforti condividono il nome, con <code>vaultSelectorAmbiguous</code>: usi l’ID.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;vault></code> come un ID.</td></tr></tbody></table>

## devo vault current

Mostra la cassaforte corrente.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo vault current
```

Questo comando non ha opzioni proprie.

## devo vault use

Rende una cassaforte quella corrente. I comandi delle voci lavorano poi in questa cassaforte, a meno che non passi `--vault-name` o `--vault-id`.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo vault use <vault> [--id]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obbligatorio. Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>. Il nome viene confrontato esattamente, senza distinzione tra maiuscole e minuscole, su ogni tipo di spazio di lavoro. Quando più casseforti condividono il nome, la prima trovata diventa la cassaforte corrente: usi l’ID per essere certo. Una cassaforte sconosciuta ferma il comando con <code>vaultNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;vault></code> come un ID.</td></tr></tbody></table>

## devo vault create

Crea una cassaforte.

**Spazio di lavoro:** Devolutions Cloud, Devolutions Server

```bash
devo vault create <name> [--description <text>] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obbligatorio. Nome della nuova cassaforte. Un nome vuoto si arresta con <code>missingParameter</code>.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Descrizione della nuova cassaforte.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma la creazione. Obbligatorio.</td></tr></tbody></table>

## devo vault create-many

Crea più casseforti in un solo comando, una dopo l’altra, e segnala per ogni nome se è stata creata o se non è riuscita.

**Spazio di lavoro:** Devolutions Cloud, Devolutions Server

```bash
devo vault create-many <name> [<name>…] [--description <text>] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Obbligatorio. Uno o più nomi di cassaforte.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Descrizione assegnata a ogni cassaforte creata.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma la creazione. Obbligatorio.</td></tr></tbody></table>

Un errore non ferma gli altri. Quando alcune casseforti sono state create e altre no, il risultato dice `partialFailure`; quando nessuna è stata creata, `vaultCreateFailed`.

## devo vault update

Rinomina una cassaforte o ne cambia la descrizione.

**Spazio di lavoro:** Devolutions Cloud, Devolutions Server

```bash
devo vault update <vault> [--new-name <name>] [--description <text>] [--id] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obbligatorio. Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;vault></code> come un ID.</td></tr><tr><td><code>--new-name &#x3C;name></code></td><td>Invariato</td><td>Nuovo nome di cassaforte.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Invariato</td><td>Nuova descrizione della cassaforte. Un valore vuoto viene ignorato, quindi questo comando non può cancellare una descrizione.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma la modifica. Obbligatorio.</td></tr></tbody></table>

Passi almeno uno tra `--new-name` e `--description`, altrimenti il comando si arresta con `missingParameter`.

## devo vault delete

Elimina una cassaforte. Alias: `devo vault rm`.

**Spazio di lavoro:** Devolutions Cloud, Devolutions Server

```bash
devo vault delete id:<vault-id> [--permanently] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obbligatorio. Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>. Su Devolutions Cloud è accettato solo l’ID: un nome si ferma con <code>cloudVaultCanonicalIdRequired</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;vault></code> come un ID.</td></tr><tr><td><code>--permanently</code></td><td>Disattivato</td><td>Devolutions Cloud: elimina la cassaforte in modo permanente invece di spostarla nel cestino. Ignorato da Devolutions Server.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma l’eliminazione. Obbligatorio.</td></tr></tbody></table>

## devo vault settings get

Mostra le impostazioni radice della cassaforte corrente, o della cassaforte che nomina: descrizione, voce radice e modalità di configurazione dei tag. Il risultato è di sola lettura.

**Spazio di lavoro:** Profilo locale

```bash
devo vault settings get [<vault>] [--id]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td>Cassaforte corrente</td><td>Facoltativo. Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;vault></code> come un ID.</td></tr></tbody></table>

Questo comando funziona solo quando il profilo lo consente.

## devo vault template list

Elenca i modelli di cassaforte del profilo, con il loro nome e ID. Alias: `devo vault template ls`.

**Spazio di lavoro:** Profilo locale

```bash
devo vault template list [--vault-name <template-name> | --vault-id <template-id>]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--vault-id &#x3C;id></code></td><td>Tutti i modelli</td><td>Mantiene il modello di cassaforte con questo ID. Il valore viene confrontato con i modelli, non con le casseforti.</td></tr><tr><td><code>--vault-name &#x3C;name></code></td><td>Tutti i modelli</td><td>Mantiene il modello di cassaforte con questo nome, senza distinzione tra maiuscole e minuscole. Ignorato quando è indicato <code>--vault-id</code>.</td></tr></tbody></table>

## devo vault access list

Elenca gli utenti e i gruppi che hanno accesso a una cassaforte, con il loro ruolo. Alias: `devo vault access ls`.

**Spazio di lavoro:** Devolutions Cloud

```bash
devo vault access list <vault> [--id] [--user <user> | --group <group>] [--case-sensitive]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obbligatorio. Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;vault></code> come un ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td>Tutti</td><td>Mantiene un solo utente: il nome per impostazione predefinita, oppure <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> o <code>email:&#x3C;value></code>. Un GUID da solo è letto come un ID.</td></tr><tr><td><code>--group &#x3C;group></code></td><td>Tutti</td><td>Mantiene un gruppo di utenti: il nome per impostazione predefinita, oppure <code>id:&#x3C;value></code> o <code>name:&#x3C;value></code>. Un GUID isolato viene letto come ID.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Mantiene un’identità dell’applicazione. Devolutions Cloud la rifiuta con <code>cloudVaultAccessApplicationUnsupported</code>.</td></tr><tr><td><code>--case-sensitive</code></td><td>Disattivato</td><td>Confronta nomi e messaggi di posta elettronica tenendo conto delle maiuscole. Per impostazione predefinita, le maiuscole non contano. Un nome utente corrisponde al nome utente o al nome visualizzato; un indirizzo di posta elettronica corrisponde all’indirizzo o all’indirizzo di accesso; un nome di gruppo corrisponde al nome del gruppo.</td></tr></tbody></table>

Usi al massimo uno tra `--user`, `--group` e `--application`, altrimenti il comando si arresta con `conflictingOptions`.

## devo vault access grant

Assegna a un utente o a un gruppo un ruolo su una cassaforte.

**Spazio di lavoro:** Devolutions Cloud

```bash
devo vault access grant <vault> (--user <user> | --group <group>) --role <role> [--id] [--case-sensitive] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obbligatorio. Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;vault></code> come un ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td></td><td>Utente che riceve il ruolo: il nome per impostazione predefinita, oppure <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> o <code>email:&#x3C;value></code>. Un GUID da solo è letto come un ID.</td></tr><tr><td><code>--group &#x3C;group></code></td><td></td><td>Gruppo di utenti che riceve il ruolo: il nome per impostazione predefinita, oppure <code>id:&#x3C;value></code> o <code>name:&#x3C;value></code>. Un GUID isolato viene letto come ID.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Identità dell’applicazione che riceve il ruolo. Devolutions Cloud la rifiuta con <code>cloudVaultAccessPrincipalUnsupported</code>.</td></tr><tr><td><code>--role &#x3C;role></code></td><td></td><td>Ruolo della cassaforte, per nome o ID, senza distinzione tra maiuscole e minuscole: <code>Restricted</code>, <code>Readers</code>, <code>PrivilegedReaders</code>, <code>Operators</code>, <code>PrivilegedOperators</code>, <code>Contributors</code> o <code>VaultOwners</code>. Un ruolo sconosciuto ferma il comando con <code>cloudVaultRoleNotFound</code>.</td></tr><tr><td><code>--case-sensitive</code></td><td>Disattivato</td><td>Confronta nomi e messaggi di posta elettronica tenendo conto delle maiuscole. Per impostazione predefinita, le maiuscole non contano. Un nome utente corrisponde al nome utente o al nome visualizzato; un indirizzo di posta elettronica corrisponde all’indirizzo o all’indirizzo di accesso; un nome di gruppo corrisponde al nome del gruppo.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma la modifica. Obbligatorio.</td></tr></tbody></table>

Passi esattamente uno tra `--user` e `--group`: nessuno si ferma con `missingParameter`, più di uno con `conflictingOptions`. Quando il nome corrisponde a più utenti o gruppi, il comando si ferma con `principalAmbiguous`: usi l’ID.

## devo vault access revoke

Rimuove l’accesso di un utente o di un gruppo a una cassaforte. Alias: `devo vault access rm`.

**Spazio di lavoro:** Devolutions Cloud

```bash
devo vault access revoke <vault> (--user <user> | --group <group>) [--id] [--case-sensitive] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obbligatorio. Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;vault></code> come un ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td></td><td>Utente il cui accesso viene rimosso: il nome per impostazione predefinita, oppure <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> o <code>email:&#x3C;value></code>.</td></tr><tr><td><code>--group &#x3C;group></code></td><td></td><td>Gruppo di utenti il cui accesso viene rimosso: il nome per impostazione predefinita, oppure <code>id:&#x3C;value></code> o <code>name:&#x3C;value></code>.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Identità dell’applicazione il cui accesso viene rimosso. Devolutions Cloud la rifiuta con <code>cloudVaultAccessPrincipalUnsupported</code>.</td></tr><tr><td><code>--all</code></td><td>Disattivato</td><td>Rimuove ogni assegnazione di accesso della cassaforte. Non può essere combinata con <code>--user</code>, <code>--group</code> o <code>--application</code>. Devolutions Cloud la rifiuta con <code>cloudVaultAccessPrincipalUnsupported</code>: revochi un utente o un gruppo alla volta.</td></tr><tr><td><code>--case-sensitive</code></td><td>Disattivato</td><td>Confronta nomi e messaggi di posta elettronica tenendo conto delle maiuscole. Per impostazione predefinita, le maiuscole non contano. Un nome utente corrisponde al nome utente o al nome visualizzato; un indirizzo di posta elettronica corrisponde all’indirizzo o all’indirizzo di accesso; un nome di gruppo corrisponde al nome del gruppo.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma la rimozione. Obbligatorio.</td></tr></tbody></table>

## devo vault variable list

Elenca le variabili personalizzate della cassaforte corrente, o della cassaforte che nomina, con nome, valore, ambito, origine e descrizione. I valori sono mostrati in testo in chiaro, tranne per le variabili il cui nome, o uno dei cui campi memorizzati, contiene `password`, `secret`, `token`, `encrypt`, `protected` o `safevalue`: il valore torna vuoto e sono contrassegnate `redacted`. Alias: `devo vault variable ls`.

**Spazio di lavoro:** Profilo locale

```bash
devo vault variable list [<name>] [--vault <vault>] [--id]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Tutte le variabili</td><td>Filtro del nome facoltativo, senza distinzione tra maiuscole e minuscole. <code>*</code> corrisponde a qualsiasi testo e <code>?</code> a un carattere. Senza un carattere jolly, il nome deve corrispondere esattamente. I delimitatori <code>$</code> sono facoltativi.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Cassaforte corrente</td><td>Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>. Una cassaforte sconosciuta si arresta con <code>vaultNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>--vault</code> come un ID.</td></tr></tbody></table>

## devo vault variable set

Crea una variabile personalizzata della cassaforte corrente, o della cassaforte indicata, oppure la aggiorna se esiste. Il valore proviene da una variabile d’ambiente o da un file, mai dalla riga di comando.

**Spazio di lavoro:** Profilo locale

```bash
devo vault variable set <name> (--value-env <variable> | --value-file <file>) [--description <text>] [--vault <vault>] [--id] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obbligatorio. Nome della variabile: solo lettere, numeri e trattini bassi. I delimitatori <code>$</code> sono facoltativi; il nome è salvato in maiuscolo, tra segni <code>$</code>.</td></tr><tr><td><code>--value-env &#x3C;variable></code></td><td></td><td>Variabile d’ambiente che contiene il valore. La variabile deve esistere.</td></tr><tr><td><code>--value-file &#x3C;file></code></td><td></td><td>File che contiene il valore. Viene usato tutto il contenuto così com’è, inclusa un’interruzione di riga finale.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Invariato</td><td>Descrizione della variabile. Senza di essa, una descrizione esistente viene conservata.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Cassaforte corrente</td><td>Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>--vault</code> come un ID.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma la modifica. Obbligatorio.</td></tr></tbody></table>

Passi esattamente uno tra `--value-env` e `--value-file`: entrambi fermano il comando con `conflictingOptions`, nessuno dei due con `missingParameter`. Impostare di nuovo lo stesso valore e la stessa descrizione ferma il comando con `sqliteVariableUpdateNoChanges`. Le modifiche richiedono un database locale non crittografato.

## devo vault variable delete

Elimina le variabili personalizzate della cassaforte corrente o della cassaforte che indica. Alias: `devo vault variable rm`.

**Spazio di lavoro:** Profilo locale

```bash
devo vault variable delete <name> [<name>…] [--vault <vault>] [--id] --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Obbligatorio. Uno o più nomi di variabile. Se un nome non esiste, o compare due volte, il comando fallisce e non elimina nulla.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Cassaforte corrente</td><td>Nome della cassaforte, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>--vault</code> come un ID.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma l’eliminazione. Obbligatorio.</td></tr></tbody></table>

## devo variable export

Scrive le variabili personalizzate di un ambito in un file JSON. Ogni variabile viene scritta con nome, valore, descrizione, ambito e origine. Come con `list`, una variabile il cui nome, o uno dei cui campi memorizzati, contiene `password`, `secret`, `token`, `encrypt`, `protected` o `safevalue` viene scritta con un valore vuoto. L’esportazione legge soltanto le variabili: non richiede `--yes` e funziona per ogni ambito, compresi quelli che non può modificare da Devolutions CLI. `variable export` è l’unico comando `devo variable`.

**Spazio di lavoro:** Profilo locale

```bash
devo variable export --scope <scope> --out-file <file> [--vault <vault>] [--id] [--name <filter>] [--force]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--scope &#x3C;scope></code></td><td></td><td>Obbligatorio. Quali variabili esportare, senza distinzione tra maiuscole e minuscole: <code>workspace</code> (le variabili dello spazio di lavoro corrente), <code>vault</code> (le variabili di una cassaforte), <code>option</code> (scritto anche <code>options</code>: le variabili salvate nel file delle opzioni di Devolutions Remote Desktop Manager del profilo; un valore salvato in forma offuscata torna vuoto ed è contrassegnato <code>unavailable</code>), oppure <code>user-vault</code> (scritto anche <code>uservault</code>: accettato, ma un profilo locale non ha variabili della cassaforte utente, quindi il file contiene un elenco vuoto). Qualsiasi altro valore ferma il comando con <code>invalidVariableScope</code>.</td></tr><tr><td><code>--out-file &#x3C;file></code></td><td></td><td>Obbligatorio. File JSON da scrivere. La sua cartella deve esistere (altrimenti <code>directoryNotFound</code>) e il percorso non può essere una cartella.</td></tr><tr><td><code>--force</code></td><td>Disattivato</td><td>Sostituisce il file se esiste. Senza di essa, un file esistente arresta il comando con <code>fileExists</code>.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Cassaforte corrente</td><td>Per gli ambiti <code>vault</code> e <code>user-vault</code>, la cassaforte da esportare: nome, o ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>--vault</code> come un ID.</td></tr><tr><td><code>--name &#x3C;filter></code></td><td>Tutte le variabili</td><td>Mantiene solo le variabili il cui nome corrisponde, senza distinzione tra maiuscole e minuscole. <code>*</code> corrisponde a qualsiasi testo e <code>?</code> a un carattere.</td></tr></tbody></table>

{% hint style="warning" %}
Il file esportato contiene i valori in testo in chiaro, e Devolutions CLI non lo rende privato. Non lo committi, e lo elimini quando non le serve più.
{% endhint %}

## Pagine correlate

* [Manage vaults and entries](/cli/it/per-devops-e-amministratori/manage/vaults-and-entries.md)
* [Use custom variables](/cli/it/per-devops-e-amministratori/manage/custom-variables.md)
* [Manage users, groups, and access](/cli/it/per-devops-e-amministratori/manage/users-and-access.md)
* [Entry commands](/cli/it/riferimento/commands/entries.md)


---

# 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/cli/it/riferimento/commands/workspaces-vaults-variables.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.