> 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/per-devops-e-amministratori/manage/vaults-and-entries.md).

# Gestire casseforti e voci

Selezionare spazi di lavoro e casseforti, trovare voci, leggerne i dettagli e creare, aggiornare, organizzare ed eliminare casseforti e voci con Devolutions CLI.

Usi `devo vault` e `devo entry` per scorrere lo spazio di lavoro e tenerlo ordinato da un terminale o da uno script: scelga la cassaforte in cui lavora, trovi una voce, ne crei una, la aggiorni, la sposti o la elimini. I comandi sono gli stessi per ogni tipo di spazio di lavoro, ma ogni tipo consente modifiche diverse. La tabella alla fine di questa pagina li riassume.

Questi comandi lavorano sul contesto corrente. Per verificare quale spazio di lavoro sia, esegua `devo status`. Per usarne un altro per un solo comando, aggiunga `--context <context-name>`. Consulti [Passare da uno spazio di lavoro all’altro](/cli/it/guide/connect/switch-workspaces.md).

## Vedere e selezionare spazi di lavoro

`devo workspace list` mostra gli spazi di lavoro che può usare, con nome, ID, tipo e se sono disponibili. Quello corrente è contrassegnato con `*`. `devo workspace current` mostra solo quello corrente.

In un profilo locale di Devolutions Remote Desktop Manager può anche selezionare, creare ed eliminare spazi di lavoro:

<table><thead><tr><th width="240">TO</th><th>ESECUZIONE</th></tr></thead><tbody><tr><td>Selezionare lo spazio di lavoro in cui lavora</td><td><code>devo workspace use "&#x3C;workspace-name>"</code><br><br>Usi <code>id:&#x3C;workspace-id></code> per selezionarlo per ID.</td></tr><tr><td>Creare uno spazio di lavoro SQLite</td><td><code>devo workspace create "&#x3C;workspace-name>" --passphrase-file &#x3C;passphrase-file> --yes</code><br><br>Il file di database è <code>&#x3C;workspace-name>.db</code> nella cartella del profilo, a meno che non indichi un altro nome di file con <code>--path</code>. La passphrase protegge il nuovo spazio di lavoro; può anche provenire da una variabile d’ambiente con <code>--passphrase-env</code>. Il nuovo spazio di lavoro diventa quello corrente, a meno che non aggiunga <code>--no-set-current</code>.</td></tr><tr><td>Eliminare uno spazio di lavoro</td><td><code>devo workspace delete id:&#x3C;workspace-id> --yes</code><br><br>Usi l’ID esatto che <code>devo workspace list</code> mostra. Questo elimina il file di database dello spazio di lavoro, e i suoi file temporanei, dalla cartella del profilo: non si può annullare. Disponibile solo su Windows; su macOS e Linux il comando si ferma con <code>sqliteWorkspaceDeleteUnsupported</code>.</td></tr></tbody></table>

## Selezionare la cassaforte in cui lavora

La maggior parte dei comandi delle voci usa la **cassaforte corrente**. Su Devolutions Cloud e Devolutions Server, un comando che legge le voci ne ha bisogno di una: una cassaforte corrente, oppure `--vault-name` o `--vault-id` sul comando.

1. Elenchi le casseforti che può vedere:

   ```bash
   devo vault list
   ```
2. Ne renda una quella corrente:

   ```bash
   devo vault use "<vault-name>"
   ```
3. Verifichi quale cassaforte è quella corrente:

   ```bash
   devo vault current
   ```

Per lavorare in un’altra cassaforte per un solo comando senza cambiare quella corrente, aggiunga `--vault-name "<vault-name>"` o `--vault-id <vault-id>` a quel comando.

Per vedere i dettagli di una cassaforte, esegua `devo vault get "<vault-name>"`. Su un profilo locale, `devo vault settings get` mostra le impostazioni radice della cassaforte corrente (o della cassaforte che nomina), e `devo vault template list` elenca i modelli di cassaforte.

{% hint style="info" %}
I comandi selezionano una cassaforte, una voce, un utente o un gruppo per **nome** per impostazione predefinita. Quando due elementi condividono un nome, o un nome è difficile da digitare, selezioni per ID: scriva `id:<value>` o aggiunga `--id`. Per esempio, `devo vault use id:<vault-id>`.
{% endhint %}

## Trovare voci

Cerchi nella cassaforte corrente, o in un’altra, per testo, tipo o cartella:

```bash
devo entry list "<search-text>" --vault-name "<vault-name>"
```

<table><thead><tr><th width="240">OPZIONE</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--type</code></td><td>Mantiene un solo tipo di voce. <code>devo entry types</code> elenca gli identificatori di tipo.</td></tr><tr><td><code>--group</code></td><td>Mantiene solo le voci sotto un percorso di cartella.</td></tr><tr><td><code>--limit</code></td><td>Numero massimo di voci restituite. Il valore predefinito è <code>100</code>.</td></tr><tr><td><code>--smart-folder</code></td><td>Pensato per elencare le voci di una cartella intelligente, ma nessun tipo di spazio di lavoro valuta le cartelle intelligenti: il comando si ferma con <code>smartFolderUnavailable</code>. Filtri invece con <code>--group</code> o <code>--type</code>.</td></tr></tbody></table>

Per vedere una voce, usi `devo entry get "<entry-name>"`. Nessuno dei due comandi mostra valori segreti. Per usare un segreto, trovi il riferimento con `devo entry references` e consulti [Trovare il riferimento a un segreto](/cli/it/guide/secrets/find-a-reference.md).

Su un profilo locale, `devo entry sealed list` elenca le voci sigillate, con lo stesso tipo di filtri (`--name`, `--type`, `--group`, `--limit`), e `devo entry template list` elenca i modelli di voce.

## Leggere e modificare i dettagli di una voce

Oltre ai segreti, una voce contiene dettagli che non sono segreti: host, nome utente o dominio, allegati, pagine di documentazione o parametri del comando. Questi comandi li leggono e li modificano. Nessuno mostra un valore segreto.

**Leggere o modificare un campo.** `devo entry field get` restituisce un solo valore, il che è comodo in uno script:

```bash
devo entry field get "<entry-name>" host
```

Legge `name`, `type`, `group`, `host`, `username`, `domain`, `port` o un’altra proprietà della voce, come una proprietà di metadati. Su Devolutions Server tornano solo l’ID, il nome, il tipo, la cartella e la cassaforte: `host` e `username` sono vuoti. Consulti [Comandi delle voci](/cli/it/riferimento/commands/entries.md#devo-entry-field-get). Per modificare un campo, usi `devo entry field set` con il nuovo valore in `--value`, oppure da `--value-env` o `--value-file`:

```bash
devo entry field set "<entry-name>" host --value <new-host> --yes
```

`devo entry field set` modifica gli stessi campi di `devo entry update`: `host`, `username` e `domain` su Devolutions Server e un profilo locale, e `name` solo su un profilo locale. Rifiuta `password`: per cambiare una password, usi `devo secret set`. Consulti [Aggiornare un segreto da uno script](/cli/it/guide/secrets/update-a-secret.md).

**Altri dettagli di una voce**, su un profilo locale:

<table><thead><tr><th width="240">TO</th><th>ESECUZIONE</th></tr></thead><tbody><tr><td>Elencare i campi di metadati</td><td><code>devo entry metadata list "&#x3C;entry-name>"</code><br><br>Può anche selezionare la voce dal suo percorso: <code>path:&#x3C;entry-path></code>.</td></tr><tr><td>Elencare gli allegati</td><td><code>devo entry attachment list "&#x3C;entry-name>"</code></td></tr><tr><td>Leggere una pagina di documentazione</td><td><code>devo entry documentation list &#x3C;entry-id></code><br><code>devo entry documentation get &#x3C;entry-id> --title "&#x3C;page-title>"</code><br><br>Questi comandi prendono l’ID della voce.</td></tr><tr><td>Rinominare una pagina di documentazione</td><td><code>devo entry documentation update &#x3C;entry-id> --title "&#x3C;page-title>" --new-title "&#x3C;new-title>" --yes</code><br><br>Un profilo locale non può modificare il contenuto di una pagina.</td></tr><tr><td>Elencare e modificare i parametri di comando</td><td><code>devo entry parameter list "&#x3C;entry-name>"</code><br><code>devo entry parameter set "&#x3C;entry-name>" --label "&#x3C;label>" --new-label "&#x3C;new-label>" --yes</code><br><br>Selezioni il parametro con <code>--label</code> o <code>--position</code>. Può cambiarne l’etichetta (<code>--new-label</code>), il tipo (<code>--type</code>: <code>Text</code>, <code>Secured</code>, <code>EnvironmentVariable</code> o <code>Unused</code>) o il valore predefinito (<code>--value</code>, <code>--value-env</code> o <code>--value-file</code>). <code>--include-unused</code> elenca anche gli slot di parametro inutilizzati.</td></tr><tr><td>Elencare gli elementi di una voce Elenco di password</td><td><code>devo entry password-list list "&#x3C;entry-name>" --name "&#x3C;item-name>"</code><br><br><code>--name</code> filtra gli elementi per nome. Le password e i campi personalizzati sensibili tornano vuoti.</td></tr></tbody></table>

## Creare e aggiornare casseforti

Creare, rinominare ed eliminare casseforti è disponibile su Devolutions Cloud e Devolutions Server.

1. Creare una cassaforte:

   ```bash
   devo vault create "<vault-name>" --description "<description>" --yes
   ```

   Per creare più casseforti insieme, usi `devo vault create-many "<name-1>" "<name-2>" --yes`. Devolutions CLI indica quali sono state create e quali non sono riuscite.
2. Rinomini una cassaforte o ne cambi la descrizione:

   ```bash
   devo vault update "<vault-name>" --new-name "<new-name>" --description "<description>" --yes
   ```

## Creare e aggiornare voci

La creazione di voci è disponibile su un profilo locale di Devolutions Remote Desktop Manager.

Entrambi i comandi sotto scrivono nello spazio di lavoro locale, quindi hanno bisogno della sua passphrase: passi `--passphrase-file <file>` o `--passphrase-env <VARIABLE_NAME>`, oppure la tenga in un file `<workspace file>.passphrase` nella cartella del profilo. Senza una delle due, si fermano con `missingParameter`.

1. Crei la voce. Un profilo locale crea solo voci RDP:

   ```bash
   devo entry create "<entry-name>" --host <host> --username <username> --group "<folder>" --passphrase-file <passphrase-file> --yes
   ```

   La voce va nella cassaforte predefinita: un profilo locale crea voci solo lì, e un altro `--vault-id` si ferma con `sqliteEntryCreateVaultUnsupported`.
2. Imposti la sua password da una variabile d’ambiente o da un file, così il valore non compare mai sulla riga di comando:

   ```bash
   devo secret set password "<entry-name>" --value-env <VARIABLE_NAME> --passphrase-file <passphrase-file> --yes
   ```

   Consulti [Aggiornare un segreto da uno script](/cli/it/guide/secrets/update-a-secret.md).

Per modificare una voce esistente, usi `devo entry update` con i campi da modificare:

```bash
devo entry update "<entry-name>" --host <new-host> --username <new-username> --yes
```

Ciò che può modificare dipende dal tipo di spazio di lavoro:

* **Profilo locale**: `--new-name`, `--host`, `--username` e `--domain`. `--host-port` e `--password-secret-reference` vengono rifiutati.
* **Devolutions Server**: `--host`, `--username` e `--domain`.
* **Devolutions Cloud**: solo la password, con `devo secret set`.

## Organizzare le voci

Questi comandi sono disponibili su un profilo locale.

<table><thead><tr><th width="240">TO</th><th>ESECUZIONE</th></tr></thead><tbody><tr><td>Spostare le voci in un’altra cartella</td><td><code>devo entry move --entry-id &#x3C;entry-id> --destination-group "&#x3C;folder>" --yes</code><br><br>Ripeta <code>--entry-id</code> per spostare più voci. Un profilo locale sposta le voci solo dentro la loro cassaforte: un <code>--to-vault</code> diverso si ferma con <code>entryMoveCrossVaultUnsupported</code>. Un <code>--destination-group</code> vuoto le sposta nella radice della cassaforte.</td></tr><tr><td>Rinominare una cartella</td><td><code>devo entry folder rename "&#x3C;folder-path>" --new-name "&#x3C;new-name>" --yes</code><br><br>Anche i percorsi delle voci all’interno della cartella vengono aggiornati.</td></tr><tr><td>Impostare lo stato di una voce</td><td><code>devo entry status set "&#x3C;entry-name>" --status Locked --message "&#x3C;reason>" --yes</code><br><br>Valori di stato: <code>Archived</code>, <code>Broken</code>, <code>Default</code>, <code>Disabled</code>, <code>Expired</code>, <code>Locked</code> o <code>Warning</code>.<br><br>Per selezionare la voce per ID con questo comando e <code>devo entry tag set</code>, aggiunga <code>--id</code>: questi due comandi non riconoscono il prefisso <code>id:</code>.</td></tr><tr><td>Sostituire i tag di una voce</td><td><code>devo entry tag set "&#x3C;entry-name>" --tag &#x3C;tag-1> --tag &#x3C;tag-2> --yes</code><br><br>I tag che passa sostituiscono quelli esistenti. Usi <code>--clear</code> per rimuoverli tutti.</td></tr></tbody></table>

Per rileggerli, usi `devo entry status get` e `devo entry tag list`. Questi due comandi si fermano con `entryFieldNotFound` quando la voce non ha uno stato o non ha tag, e sempre su Devolutions Cloud e Devolutions Server, che non li restituiscono. Per vedere le voci che sono state eliminate, usi `devo entry trash list`, con `--before <date>` per vedere solo quelle eliminate prima di una data.

## Eliminare voci e casseforti

{% hint style="danger" %}
`--yes` è l’unica conferma che Devolutions CLI chiede. Controlli il nome o l’ID prima di eliminare qualsiasi cosa, soprattutto in uno script, e preferisca gli ID ai nomi.
{% endhint %}

Eliminare voci e casseforti è disponibile su Devolutions Cloud e Devolutions Server.

**Eliminare una voce:**

```bash
devo entry delete "<entry-name>" --yes
```

Su Devolutions Cloud, eliminare una voce elimina anche le voci al suo interno. Devolutions CLI rifiuta di farlo finché non aggiunge `--acknowledge-recursive-scope`, il che mostra che lo sa.

**Eliminare una cassaforte:**

```bash
devo vault delete id:<vault-id> --yes
```

Su Devolutions Cloud, selezioni la cassaforte per il suo ID: un nome di cassaforte o la cassaforte corrente non è accettato. La cassaforte va nel cestino, a meno che non aggiunga `--permanently`.

## Che cosa può fare ogni tipo di spazio di lavoro

<table><thead><tr><th width="260">JOB</th><th>PROFILO LOCALE</th><th>DEVOLUTIONS CLOUD</th><th>DEVOLUTIONS SERVER</th></tr></thead><tbody><tr><td>Elencare gli spazi di lavoro, mostrare quello corrente</td><td>Sì</td><td>Sì</td><td>Sì</td></tr><tr><td>Selezionare, creare ed eliminare spazi di lavoro</td><td>Sì</td><td>No</td><td>No</td></tr><tr><td>Elencare e selezionare casseforti</td><td>Sì</td><td>Sì</td><td>Sì</td></tr><tr><td>Creare, rinominare ed eliminare casseforti</td><td>No</td><td>Sì</td><td>Sì</td></tr><tr><td>Elencare, cercare e ottenere voci</td><td>Sì</td><td>Sì</td><td>Sì</td></tr><tr><td>Creare voci</td><td>Voci RDP</td><td>No</td><td>No</td></tr><tr><td>Leggere un campo (<code>devo entry field get</code>)</td><td>Sì</td><td>Sì</td><td>Solo ID, nome, tipo, cartella e cassaforte</td></tr><tr><td>Aggiornare le voci (<code>devo entry update</code>, <code>devo entry field set</code>)</td><td>Sì*</td><td>No (password con <code>devo secret set</code>)</td><td>Host, nome utente, dominio</td></tr><tr><td>Metadati, allegati, documentazione, parametri di comando, elementi di Elenco di password</td><td>Sì*</td><td>No</td><td>No</td></tr><tr><td>Spostare voci, rinominare cartelle</td><td>Sì*</td><td>No</td><td>No</td></tr><tr><td>Leggere e impostare lo stato e i tag</td><td>Sì*</td><td>No</td><td>No</td></tr><tr><td>Eliminare voci</td><td>No</td><td>Sì, con <code>--acknowledge-recursive-scope</code></td><td>Sì</td></tr><tr><td>Elencare le voci eliminate</td><td>Sì</td><td>No</td><td>No</td></tr></tbody></table>

\* Quando il profilo lo consente. `devo doctor` elenca le operazioni che lo spazio di lavoro selezionato supporta. Se una modifica non è disponibile nel profilo, la faccia in Devolutions Remote Desktop Manager.

## Buono a sapersi

* `--yes` conferma la modifica. Senza, il comando non cambia nulla e si ferma con `confirmationRequired`. Consulti [Eseguire senza richieste](/cli/it/per-devops-e-amministratori/automate/non-interactive.md).
* Aggiunga `--output json` per ottenere un risultato che uno script possa leggere. Consulti [Leggere i risultati come JSON](/cli/it/per-devops-e-amministratori/automate/json-output.md).
* Un comando si ferma con `operationNotSupportedBySource` (Devolutions Cloud, Devolutions Server) o con un altro codice che dice che il profilo locale non può farlo? Lo spazio di lavoro selezionato non può fare quella modifica. Consulti [Un comando indica che lo spazio di lavoro non lo supporta](/cli/it/aiuto/troubleshooting/not-supported.md).

## Successivo

* [Manage users, groups, and access](/cli/it/per-devops-e-amministratori/manage/users-and-access.md)
* [Review activity logs](/cli/it/per-devops-e-amministratori/manage/logs.md)
* [Commands](/cli/it/riferimento/commands.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/per-devops-e-amministratori/manage/vaults-and-entries.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.