> 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/es/para-devops-y-administradores/manage/vaults-and-entries.md).

# Administrar bóvedas y entradas

Seleccionar espacios de trabajo y bóvedas, encontrar entradas, leer sus detalles y crear, actualizar, organizar y eliminar bóvedas y entradas con Devolutions CLI.

Use `devo vault` y `devo entry` para recorrer su espacio de trabajo y mantenerlo organizado desde un terminal o un script: elija la bóveda en la que trabaja, encuentre una entrada, cree una, actualícela, muévala o elimínela. Los comandos son los mismos para cada tipo de espacio de trabajo, pero cada tipo permite cambios distintos. La tabla al final de esta página los resume.

Estos comandos trabajan sobre el contexto actual. Para comprobar qué espacio de trabajo es, ejecute `devo status`. Para usar otro en un solo comando, añada `--context <context-name>`. Consulte [Cambiar entre espacios de trabajo](/cli/es/guias/connect/switch-workspaces.md).

## Ver y seleccionar espacios de trabajo

`devo workspace list` muestra los espacios de trabajo que puede usar, con su nombre, su identificador, su tipo y si están disponibles. El actual está marcado con `*`. `devo workspace current` muestra solo el actual.

En un perfil local de Devolutions Remote Desktop Manager, también puede seleccionar, crear y eliminar espacios de trabajo:

<table><thead><tr><th width="240">TO</th><th>EJECUCIÓN</th></tr></thead><tbody><tr><td>Seleccionar el espacio de trabajo en el que trabaja</td><td><code>devo workspace use "&#x3C;workspace-name>"</code><br><br>Use <code>id:&#x3C;workspace-id></code> para seleccionarlo por identificador.</td></tr><tr><td>Crear un espacio de trabajo SQLite</td><td><code>devo workspace create "&#x3C;workspace-name>" --passphrase-file &#x3C;passphrase-file> --yes</code><br><br>El archivo de base de datos es <code>&#x3C;workspace-name>.db</code> en la carpeta del perfil, salvo que indique otro nombre de archivo con <code>--path</code>. La frase de contraseña protege el nuevo espacio de trabajo; también puede proceder de una variable de entorno con <code>--passphrase-env</code>. El nuevo espacio de trabajo se convierte en el actual, salvo que añada <code>--no-set-current</code>.</td></tr><tr><td>Eliminar un espacio de trabajo</td><td><code>devo workspace delete id:&#x3C;workspace-id> --yes</code><br><br>Use el identificador exacto que muestra <code>devo workspace list</code>. Esto elimina el archivo de base de datos del espacio de trabajo, y sus archivos temporales, de la carpeta del perfil: no se puede deshacer. Disponible solo en Windows; en macOS y Linux, el comando se detiene con <code>sqliteWorkspaceDeleteUnsupported</code>.</td></tr></tbody></table>

## Seleccionar la bóveda en la que trabaja

La mayoría de los comandos de entrada usan la **bóveda actual**. En Devolutions Cloud y Devolutions Server, un comando que lee entradas necesita una: una bóveda actual, o `--vault-name` o `--vault-id` en el comando.

1. Enumere las bóvedas que puede ver:

   ```bash
   devo vault list
   ```
2. Convierta uno de ellos en la bóveda actual:

   ```bash
   devo vault use "<vault-name>"
   ```
3. Compruebe qué bóveda es la actual:

   ```bash
   devo vault current
   ```

Para trabajar en otra bóveda durante un solo comando sin cambiar la actual, añada `--vault-name "<vault-name>"` o `--vault-id <vault-id>` a ese comando.

Para ver los detalles de una bóveda, ejecute `devo vault get "<vault-name>"`. En un perfil local, `devo vault settings get` muestra la configuración raíz de la bóveda actual (o de la bóveda que nombre), y `devo vault template list` enumera las plantillas de bóveda.

{% hint style="info" %}
Los comandos seleccionan una bóveda, una entrada, un usuario o un grupo por **nombre** de forma predeterminada. Cuando dos elementos comparten un nombre, o un nombre es difícil de escribir, seleccione por identificador: escriba `id:<value>` o añada `--id`. Por ejemplo, `devo vault use id:<vault-id>`.
{% endhint %}

## Encontrar entradas

Busque en la bóveda actual, o en otra, por texto, tipo o carpeta:

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

<table><thead><tr><th width="240">OPCIÓN</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--type</code></td><td>Conserva solo un tipo de entrada. <code>devo entry types</code> enumera los identificadores de tipo.</td></tr><tr><td><code>--group</code></td><td>Conserva solo las entradas bajo una ruta de carpeta.</td></tr><tr><td><code>--limit</code></td><td>Número máximo de entradas devueltas. El valor predeterminado es <code>100</code>.</td></tr><tr><td><code>--smart-folder</code></td><td>Pensado para enumerar las entradas de una carpeta inteligente, pero ningún tipo de espacio de trabajo evalúa las carpetas inteligentes: el comando se detiene con <code>smartFolderUnavailable</code>. Filtre con <code>--group</code> o <code>--type</code>.</td></tr></tbody></table>

Para ver una entrada, use `devo entry get "<entry-name>"`. Ninguno de los dos comandos muestra valores secretos. Para usar un secreto, encuentre su referencia con `devo entry references` y consulte [Encontrar la referencia de un secreto](/cli/es/guias/secrets/find-a-reference.md).

En un perfil local, `devo entry sealed list` enumera las entradas selladas, con el mismo tipo de filtros (`--name`, `--type`, `--group`, `--limit`), y `devo entry template list` enumera las plantillas de entrada.

## Leer y cambiar los detalles de una entrada

Además de sus secretos, una entrada contiene detalles que no son secretos: su host, su nombre de usuario o su dominio, sus archivos adjuntos, sus páginas de documentación o sus parámetros de comando. Estos comandos los leen y los cambian. Ninguno muestra un valor secreto.

**Leer o cambiar un campo.** `devo entry field get` devuelve un solo valor, lo que resulta práctico en un script:

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

Lee `name`, `type`, `group`, `host`, `username`, `domain`, `port` u otra propiedad de la entrada, como una propiedad de metadatos. En Devolutions Server, solo vuelven el identificador, el nombre, el tipo, la carpeta y la bóveda: `host` y `username` están vacíos. Consulte [Comandos de entrada](/cli/es/referencia/commands/entries.md#devo-entry-field-get). Para cambiar un campo, use `devo entry field set` con el valor nuevo en `--value`, o desde `--value-env` o `--value-file`:

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

`devo entry field set` cambia los mismos campos que `devo entry update`: `host`, `username` y `domain` en Devolutions Server y un perfil local, y `name` solo en un perfil local. Rechaza `password`: para cambiar una contraseña, use `devo secret set`. Consulte [Actualizar un secreto desde un script](/cli/es/guias/secrets/update-a-secret.md).

**Otros detalles de una entrada**, en un perfil local:

<table><thead><tr><th width="240">TO</th><th>EJECUCIÓN</th></tr></thead><tbody><tr><td>Enumerar los campos de metadatos</td><td><code>devo entry metadata list "&#x3C;entry-name>"</code><br><br>También puede seleccionar la entrada por su ruta: <code>path:&#x3C;entry-path></code>.</td></tr><tr><td>Enumerar los datos adjuntos</td><td><code>devo entry attachment list "&#x3C;entry-name>"</code></td></tr><tr><td>Leer una página de documentación</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>Estos comandos toman el identificador de la entrada.</td></tr><tr><td>Cambiar el nombre de una página de documentación</td><td><code>devo entry documentation update &#x3C;entry-id> --title "&#x3C;page-title>" --new-title "&#x3C;new-title>" --yes</code><br><br>Un perfil local no puede cambiar el contenido de una página.</td></tr><tr><td>Enumerar y cambiar los parámetros de 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>Seleccione el parámetro con <code>--label</code> o <code>--position</code>. Puede cambiar su etiqueta (<code>--new-label</code>), su tipo (<code>--type</code>: <code>Text</code>, <code>Secured</code>, <code>EnvironmentVariable</code> o <code>Unused</code>) o su valor predeterminado (<code>--value</code>, <code>--value-env</code> o <code>--value-file</code>). <code>--include-unused</code> también enumera los espacios de parámetros no utilizados.</td></tr><tr><td>Enumerar los elementos de una entrada Lista de contraseñas</td><td><code>devo entry password-list list "&#x3C;entry-name>" --name "&#x3C;item-name>"</code><br><br><code>--name</code> filtra los elementos por nombre. Las contraseñas y los campos personalizados sensibles vuelven vacíos.</td></tr></tbody></table>

## Crear y actualizar bóvedas

Crear, cambiar el nombre y eliminar bóvedas está disponible en Devolutions Cloud y Devolutions Server.

1. Crear una bóveda:

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

   Para crear varias bóvedas a la vez, use `devo vault create-many "<name-1>" "<name-2>" --yes`. Devolutions CLI indica cuáles se crearon y cuáles fallaron.
2. Cambie el nombre de una bóveda o cambie su descripción:

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

## Crear y actualizar entradas

Crear entradas está disponible en un perfil local de Devolutions Remote Desktop Manager.

Los dos comandos de abajo escriben en el espacio de trabajo local, así que necesitan su frase de contraseña: pase `--passphrase-file <file>` o `--passphrase-env <VARIABLE_NAME>`, o guárdela en un archivo `<workspace file>.passphrase` de la carpeta del perfil. Sin una de ellas, se detienen con `missingParameter`.

1. Cree la entrada. Un perfil local crea solo entradas RDP:

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

   La entrada va a la bóveda predeterminada: un perfil local crea entradas solo allí, y otro `--vault-id` se detiene con `sqliteEntryCreateVaultUnsupported`.
2. Defina su contraseña desde una variable de entorno o un archivo, para que el valor nunca aparezca en la línea de comandos:

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

   Consulte [Actualizar un secreto desde un script](/cli/es/guias/secrets/update-a-secret.md).

Para cambiar una entrada existente, use `devo entry update` con los campos que se van a cambiar:

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

Lo que puede cambiar depende del tipo de espacio de trabajo:

* **Perfil local**: `--new-name`, `--host`, `--username` y `--domain`. `--host-port` y `--password-secret-reference` se rechazan.
* **Devolutions Server**: `--host`, `--username` y `--domain`.
* **Devolutions Cloud**: solo la contraseña, con `devo secret set`.

## Organizar las entradas

Estos comandos están disponibles en un perfil local.

<table><thead><tr><th width="240">TO</th><th>EJECUCIÓN</th></tr></thead><tbody><tr><td>Mover entradas a otra carpeta</td><td><code>devo entry move --entry-id &#x3C;entry-id> --destination-group "&#x3C;folder>" --yes</code><br><br>Repita <code>--entry-id</code> para mover varias entradas. Un perfil local mueve las entradas solo dentro de su bóveda: un <code>--to-vault</code> distinto se detiene con <code>entryMoveCrossVaultUnsupported</code>. Un <code>--destination-group</code> vacío las mueve a la raíz de la bóveda.</td></tr><tr><td>Cambiar el nombre de una carpeta</td><td><code>devo entry folder rename "&#x3C;folder-path>" --new-name "&#x3C;new-name>" --yes</code><br><br>Las rutas de las entradas dentro de la carpeta también se actualizan.</td></tr><tr><td>Establecer el estado de una entrada</td><td><code>devo entry status set "&#x3C;entry-name>" --status Locked --message "&#x3C;reason>" --yes</code><br><br>Valores de estado: <code>Archived</code>, <code>Broken</code>, <code>Default</code>, <code>Disabled</code>, <code>Expired</code>, <code>Locked</code> o <code>Warning</code>.<br><br>Para seleccionar la entrada por identificador con este comando y <code>devo entry tag set</code>, añada <code>--id</code>: estos dos comandos no reconocen el prefijo <code>id:</code>.</td></tr><tr><td>Sustituir las etiquetas de una entrada</td><td><code>devo entry tag set "&#x3C;entry-name>" --tag &#x3C;tag-1> --tag &#x3C;tag-2> --yes</code><br><br>Las etiquetas que pasa sustituyen a las existentes. Use <code>--clear</code> para quitarlas todas.</td></tr></tbody></table>

Para volver a leerlos, use `devo entry status get` y `devo entry tag list`. Estos dos comandos se detienen con `entryFieldNotFound` cuando la entrada no tiene estado o no tiene etiquetas, y siempre en Devolutions Cloud y Devolutions Server, que no los devuelven. Para ver las entradas que se eliminaron, use `devo entry trash list`, con `--before <date>` para ver solo las eliminadas antes de una fecha.

## Eliminar entradas y bóvedas

{% hint style="danger" %}
`--yes` es la única confirmación que pide Devolutions CLI. Compruebe el nombre o el identificador antes de eliminar nada, sobre todo en un script, y prefiera los identificadores a los nombres.
{% endhint %}

Eliminar entradas y bóvedas está disponible en Devolutions Cloud y Devolutions Server.

**Eliminar una entrada:**

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

En Devolutions Cloud, eliminar una entrada también elimina las entradas que contiene. Devolutions CLI se niega a hacerlo hasta que usted añada `--acknowledge-recursive-scope`, lo que muestra que lo sabe.

**Eliminar una bóveda:**

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

En Devolutions Cloud, seleccione la bóveda por su identificador: no se acepta un nombre de bóveda ni la bóveda actual. La bóveda va a la papelera, a menos que añada `--permanently`.

## Qué puede hacer cada tipo de espacio de trabajo

<table><thead><tr><th width="260">TAREA</th><th>PERFIL LOCAL</th><th>DEVOLUTIONS CLOUD</th><th>DEVOLUTIONS SERVER</th></tr></thead><tbody><tr><td>Enumerar espacios de trabajo, mostrar el actual</td><td>Sí</td><td>Sí</td><td>Sí</td></tr><tr><td>Seleccionar, crear y eliminar espacios de trabajo</td><td>Sí</td><td>No</td><td>No</td></tr><tr><td>Enumerar y seleccionar bóvedas</td><td>Sí</td><td>Sí</td><td>Sí</td></tr><tr><td>Crear, cambiar el nombre y eliminar bóvedas</td><td>No</td><td>Sí</td><td>Sí</td></tr><tr><td>Enumerar, buscar y obtener entradas</td><td>Sí</td><td>Sí</td><td>Sí</td></tr><tr><td>Crear entradas</td><td>Entradas RDP</td><td>No</td><td>No</td></tr><tr><td>Leer un campo (<code>devo entry field get</code>)</td><td>Sí</td><td>Sí</td><td>Solo ID, nombre, tipo, carpeta y bóveda</td></tr><tr><td>Actualizar entradas (<code>devo entry update</code>, <code>devo entry field set</code>)</td><td>Sí*</td><td>No (contraseña con <code>devo secret set</code>)</td><td>Host, nombre de usuario, dominio</td></tr><tr><td>Metadatos, datos adjuntos, documentación, parámetros de comando, elementos de Lista de contraseñas</td><td>Sí*</td><td>No</td><td>No</td></tr><tr><td>Mover entradas, cambiar el nombre de carpetas</td><td>Sí*</td><td>No</td><td>No</td></tr><tr><td>Leer y establecer el estado y las etiquetas</td><td>Sí*</td><td>No</td><td>No</td></tr><tr><td>Eliminar entradas</td><td>No</td><td>Sí, con <code>--acknowledge-recursive-scope</code></td><td>Sí</td></tr><tr><td>Enumerar las entradas eliminadas</td><td>Sí</td><td>No</td><td>No</td></tr></tbody></table>

\* Cuando el perfil lo permite. `devo doctor` enumera las operaciones que admite el espacio de trabajo seleccionado. Si un cambio no está disponible en su perfil, hágalo en Devolutions Remote Desktop Manager.

## Bueno saberlo

* `--yes` confirma el cambio. Sin ella, el comando no cambia nada y se detiene con `confirmationRequired`. Consulte [Ejecutar sin solicitudes](/cli/es/para-devops-y-administradores/automate/non-interactive.md).
* Añada `--output json` para obtener un resultado que un script pueda leer. Consulte [Leer los resultados como JSON](/cli/es/para-devops-y-administradores/automate/json-output.md).
* ¿Un comando se detiene con `operationNotSupportedBySource` (Devolutions Cloud, Devolutions Server) u otro código que indica que el perfil local no puede hacerlo? El espacio de trabajo seleccionado no puede hacer ese cambio. Consulte [Un comando indica que el espacio de trabajo no lo admite](/cli/es/ayuda/troubleshooting/not-supported.md).

## Siguiente

* [Manage users, groups, and access](/cli/es/para-devops-y-administradores/manage/users-and-access.md)
* [Review activity logs](/cli/es/para-devops-y-administradores/manage/logs.md)
* [Commands](/cli/es/referencia/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/es/para-devops-y-administradores/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.