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

# Comandos de espacio de trabajo, de bóveda y de variable

Cada comando devo workspace, devo vault y devo variable, con cada opción, su valor predeterminado, sus valores permitidos y los tipos de espacio de trabajo que la aceptan.

Esta página describe cada comando `devo workspace`, `devo vault` y `devo variable` y cada opción que puede escribir con él. Para la lista breve de todos los comandos, consulte [Comandos](/cli/es/referencia/commands.md). Para una ayuda paso a paso, consulte [Administrar bóvedas y entradas](/cli/es/para-devops-y-administradores/manage/vaults-and-entries.md) y [Usar variables personalizadas](/cli/es/para-devops-y-administradores/manage/custom-variables.md). Las opciones que acepta cada comando, como `--context`, `--output json` o `--non-interactive`, se describen en [Opciones globales](/cli/es/referencia/global-options.md) y no se repiten aquí. Para los comandos de entrada, consulte [Comandos de entrada](/cli/es/referencia/commands/entries.md).

{% hint style="info" %}
Para ver la ayuda de un comando, con su redacción exacta, ejecute `devo <command> --help`, por ejemplo `devo vault list --help`.
{% endhint %}

## Cómo funcionan estos comandos

* **Seleccionar un espacio de trabajo o una bóveda**: los comandos toman su **nombre** de forma predeterminada, comparado de forma exacta, sin distinguir mayúsculas. Para pasar un identificador, escriba `id:<value>` o añada `--id`. `name:<value>` fuerza un nombre. Las excepciones se indican bajo cada comando, como `devo workspace delete`, que necesita el identificador exacto del espacio de trabajo.
* **Espacio de trabajo actual y bóveda actual**: la mayoría de los comandos trabajan en el espacio de trabajo actual y en la bóveda actual. Defínalos con `devo workspace use` y `devo vault use`. Para usar otro contexto en un comando, añada `--context <name>`. Consulte [Cambiar entre espacios de trabajo](/cli/es/guias/connect/switch-workspaces.md).
* **Confirmación de un cambio**: cada comando que crea, cambia o elimina algo se niega a ejecutarse sin `--yes` (alias `-y` y `--confirmed`) y se detiene con `confirmationRequired`. No se cambia nada.
* **Tipos de espacio de trabajo**: un comando que el espacio de trabajo seleccionado no admite se detiene con `operationNotSupportedBySource` (Devolutions Cloud, Devolutions Server) o con un código que indica que el perfil local no puede hacerlo. Consulte [Un comando indica que el espacio de trabajo no lo admite](/cli/es/ayuda/troubleshooting/not-supported.md).

## Grupos de comandos

<table><thead><tr><th width="300">GRUPO</th><th>COMANDOS</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

Enumera los espacios de trabajo que puede usar, con su nombre, identificador, tipo, y si cada uno está disponible, es el actual y es el predeterminado. El espacio de trabajo actual se marca con `*`. Un perfil local nuevo sin ningún espacio de trabajo devuelve una lista vacía. Alias: `devo workspace ls`.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

```bash
devo workspace list
```

Este comando no tiene opciones propias.

## devo workspace current

Muestra el espacio de trabajo actual.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

```bash
devo workspace current
```

Este comando no tiene opciones propias.

## devo workspace use

Convierte un espacio de trabajo en el actual.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;workspace></code></td><td></td><td>Obligatorio. Nombre del espacio de trabajo, o su identificador con <code>id:&#x3C;value></code> o <code>--id</code>. Un espacio de trabajo desconocido se detiene con <code>workspaceNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;workspace></code> como un ID.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Variable de entorno que contiene la contraseña del espacio de trabajo. Cuando la pasa, la variable debe existir; de lo contrario, el comando se detiene con <code>invalidParameterValue</code>. Un perfil local no necesita una contraseña para seleccionar un espacio de trabajo.</td></tr></tbody></table>

En Devolutions Cloud y Devolutions Server, el comando se detiene con `operationNotSupportedBySource`: seleccione otro espacio de trabajo con `--context` o `devo context use`.

## devo workspace create

Crea un espacio de trabajo SQLite en la carpeta del perfil local y, a menos que usted añada `--no-set-current`, lo convierte en el actual. La frase de contraseña que usted indica protege el nuevo espacio de trabajo.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obligatorio. Nombre del espacio de trabajo. Sin <code>--path</code>, también es el nombre del archivo de base de datos.</td></tr><tr><td><code>--kind &#x3C;kind></code></td><td><code>sqlite</code></td><td>Tipo de espacio de trabajo. Un perfil local solo crea espacios de trabajo <code>sqlite</code>; cualquier otro tipo se detiene con <code>operationNotSupportedBySource</code>.</td></tr><tr><td><code>--path &#x3C;file-name></code></td><td><code>&#x3C;name>.db</code></td><td>Nombre de archivo de la base de datos, creado en la carpeta de perfil. Pase un nombre de archivo, no una ruta con carpetas: una ruta se detiene con <code>invalidParameterValue</code>. Se añade <code>.db</code> si el nombre no termina con él.</td></tr><tr><td><code>--passphrase-file &#x3C;file></code></td><td></td><td>Archivo privado que contiene la frase de contraseña que protege el nuevo espacio de trabajo. Devolutions Cloud y Devolutions Server rechazan esta opción.</td></tr><tr><td><code>--passphrase-env &#x3C;variable></code></td><td></td><td>Variable de entorno que contiene la frase de contraseña que protege el nuevo espacio de trabajo. Devolutions Cloud y Devolutions Server rechazan esta opción.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Variable de entorno que contiene el material de contraseña del espacio de trabajo. Un perfil local la rechaza: use <code>--passphrase-file</code> o <code>--passphrase-env</code>.</td></tr><tr><td><code>--no-set-current</code></td><td>Desactivado</td><td>Crea el espacio de trabajo sin convertirlo en el actual.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma la creación. Obligatorio.</td></tr></tbody></table>

En un perfil local, pase exactamente uno de `--passphrase-file` y `--passphrase-env`. Sin ninguno de los dos, o con ambos, el comando se detiene con `invalidParameterValue`. En Devolutions Cloud y Devolutions Server, el comando se detiene con `operationNotSupportedBySource`, con o sin `--password-env`.

## devo workspace delete

Elimina un espacio de trabajo SQLite del perfil local: su archivo de base de datos y sus archivos temporales se eliminan de la carpeta de perfil. Esto no se puede deshacer. Alias: `devo workspace rm`.

Disponible solo en Windows. En macOS y Linux, el comando se detiene con `sqliteWorkspaceDeleteUnsupported` (código de salida `3`).

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;workspace></code></td><td></td><td>Obligatorio. El identificador exacto del espacio de trabajo que muestra <code>devo workspace list</code>, como <code>sqlite:Connections.db</code>, con o sin el prefijo <code>id:</code>. No se acepta un nombre de espacio de trabajo.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;workspace></code> como un ID. No hace falta cuando pasa el ID <code>sqlite:</code>.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma la eliminación. Obligatorio.</td></tr></tbody></table>

## devo workspace variable list

Enumera las variables personalizadas del espacio de trabajo actual, con su nombre, valor, ámbito, origen y descripción. Los valores se muestran en texto sin formato, excepto las variables cuyo nombre, o uno de cuyos campos almacenados, contiene `password`, `secret`, `token`, `encrypt`, `protected` o `safevalue`: su valor vuelve vacío y se marcan `redacted`. Alias: `devo workspace variable ls`.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Todas las variables</td><td>Filtro de nombre opcional, sin distinguir mayúsculas. <code>*</code> coincide con cualquier texto y <code>?</code> con un carácter. Sin un comodín, el nombre debe coincidir exactamente. Los delimitadores <code>$</code> son opcionales.</td></tr></tbody></table>

## devo workspace variable set

Crea una variable personalizada del espacio de trabajo actual, o la actualiza si existe. El valor procede de una variable de entorno o de un archivo, nunca de la línea de comandos.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obligatorio. Nombre de variable: solo letras, números y guiones bajos. Los delimitadores <code>$</code> son opcionales; el nombre se guarda en mayúsculas, entre signos <code>$</code>.</td></tr><tr><td><code>--value-env &#x3C;variable></code></td><td></td><td>Variable de entorno que contiene el valor. La variable debe existir.</td></tr><tr><td><code>--value-file &#x3C;file></code></td><td></td><td>Archivo que contiene el valor. Se usa todo el contenido tal cual, incluido un salto de línea final.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Sin cambios</td><td>Descripción de la variable. Sin ella, se conserva una descripción existente.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma el cambio. Obligatorio.</td></tr></tbody></table>

Pase exactamente uno de `--value-env` y `--value-file`: ambos detienen el comando con `conflictingOptions`, ninguno con `missingParameter`. Definir de nuevo el mismo valor y la misma descripción detiene el comando con `sqliteVariableUpdateNoChanges`. Los cambios necesitan una base de datos local sin cifrar.

## devo workspace variable delete

Elimina las variables personalizadas del espacio de trabajo actual. Alias: `devo workspace variable rm`.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Obligatorio. Uno o varios nombres de variable. Si un nombre no existe, o aparece dos veces, el comando falla y no elimina nada.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma la eliminación. Obligatorio.</td></tr></tbody></table>

## devo vault list

Enumera las bóvedas del espacio de trabajo actual, con su nombre, identificador y tipo. La bóveda actual está marcada. Alias: `devo vault ls`.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td>Todas las bóvedas</td><td>Opcional. Conserva solo la bóveda con este nombre, o con este identificador con <code>id:&#x3C;value></code> o <code>--id</code>. El nombre se compara de forma exacta, sin distinguir mayúsculas, en cada tipo de espacio de trabajo. En Devolutions Cloud y Devolutions Server, las bóvedas se ordenan por nombre.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;vault></code> como un ID.</td></tr></tbody></table>

## devo vault get

Muestra una bóveda.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatorio. Nombre de la bóveda, o su identificador con <code>id:&#x3C;value></code> o <code>--id</code>. El nombre se compara de forma exacta, sin distinguir mayúsculas, en cada tipo de espacio de trabajo. Cuando ninguna bóveda coincide, el comando se detiene con <code>vaultNotFound</code>; cuando varias bóvedas comparten el nombre, con <code>vaultSelectorAmbiguous</code>: use el identificador.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;vault></code> como un ID.</td></tr></tbody></table>

## devo vault current

Muestra la bóveda actual.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

```bash
devo vault current
```

Este comando no tiene opciones propias.

## devo vault use

Hace de una bóveda la actual. Los comandos de entrada trabajan entonces en esta bóveda, a menos que pase `--vault-name` o `--vault-id`.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatorio. Nombre de la bóveda, o su identificador con <code>id:&#x3C;value></code> o <code>--id</code>. El nombre se compara de forma exacta, sin distinguir mayúsculas, en cada tipo de espacio de trabajo. Cuando varias bóvedas comparten el nombre, la primera que se encuentra pasa a ser la bóveda actual: use el identificador para estar seguro. Una bóveda desconocida detiene el comando con <code>vaultNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;vault></code> como un ID.</td></tr></tbody></table>

## devo vault create

Crea una bóveda.

**Espacio de trabajo:** Devolutions Cloud, Devolutions Server

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obligatorio. Nombre de la nueva bóveda. Un nombre vacío se detiene con <code>missingParameter</code>.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Descripción de la nueva bóveda.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma la creación. Obligatorio.</td></tr></tbody></table>

## devo vault create-many

Crea varias bóvedas en un solo comando, una tras otra, e informa para cada nombre si se creó o falló.

**Espacio de trabajo:** Devolutions Cloud, Devolutions Server

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Obligatorio. Uno o varios nombres de bóveda.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Descripción que se da a cada bóveda creada.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma la creación. Obligatorio.</td></tr></tbody></table>

Un fallo no detiene a los demás. Cuando algunas bóvedas se crearon y otras no, el resultado dice `partialFailure`; cuando no se creó ninguna, `vaultCreateFailed`.

## devo vault update

Cambia el nombre de una bóveda o cambia su descripción.

**Espacio de trabajo:** Devolutions Cloud, Devolutions Server

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatorio. Nombre de la bóveda, o su ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;vault></code> como un ID.</td></tr><tr><td><code>--new-name &#x3C;name></code></td><td>Sin cambios</td><td>Nuevo nombre de bóveda.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Sin cambios</td><td>Nueva descripción de la bóveda. Un valor vacío se ignora, así que este comando no puede borrar una descripción.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma el cambio. Obligatorio.</td></tr></tbody></table>

Pase al menos uno de `--new-name` y `--description`; de lo contrario, el comando se detiene con `missingParameter`.

## devo vault delete

Elimina una bóveda. Alias: `devo vault rm`.

**Espacio de trabajo:** Devolutions Cloud, Devolutions Server

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatorio. Nombre de la bóveda, o su identificador con <code>id:&#x3C;value></code> o <code>--id</code>. En Devolutions Cloud solo se acepta el identificador: un nombre se detiene con <code>cloudVaultCanonicalIdRequired</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;vault></code> como un ID.</td></tr><tr><td><code>--permanently</code></td><td>Desactivado</td><td>Devolutions Cloud: elimina la bóveda de forma permanente en lugar de moverla a la papelera. Devolutions Server lo ignora.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma la eliminación. Obligatorio.</td></tr></tbody></table>

## devo vault settings get

Muestra la configuración raíz de la bóveda actual, o de la bóveda que usted nombra: descripción, entrada raíz y modo de configuración de etiquetas. El resultado es de solo lectura.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td>Bóveda actual</td><td>Opcional. Nombre de la bóveda, o su ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;vault></code> como un ID.</td></tr></tbody></table>

Este comando solo funciona cuando el perfil lo permite.

## devo vault template list

Enumera las plantillas de bóveda del perfil, con su nombre y su ID. Alias: `devo vault template ls`.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--vault-id &#x3C;id></code></td><td>Todas las plantillas</td><td>Conserva la plantilla de bóveda con este ID. El valor se compara con las plantillas, no con sus bóvedas.</td></tr><tr><td><code>--vault-name &#x3C;name></code></td><td>Todas las plantillas</td><td>Conserva la plantilla de bóveda con este nombre, sin distinguir mayúsculas. Se ignora cuando se indica <code>--vault-id</code>.</td></tr></tbody></table>

## devo vault access list

Enumera los usuarios y los grupos que tienen acceso a una bóveda, con su rol. Alias: `devo vault access ls`.

**Espacio de trabajo:** Devolutions Cloud

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatorio. Nombre de la bóveda, o su ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;vault></code> como un ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td>Todos</td><td>Conserva un solo usuario: el nombre de forma predeterminada, o <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> o <code>email:&#x3C;value></code>. Un GUID solo se lee como un identificador.</td></tr><tr><td><code>--group &#x3C;group></code></td><td>Todos</td><td>Conserva un grupo de usuarios: el nombre de forma predeterminada, o <code>id:&#x3C;value></code> o <code>name:&#x3C;value></code>. Un GUID solo se lee como un identificador.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Conserva una identidad de aplicación. Devolutions Cloud la rechaza con <code>cloudVaultAccessApplicationUnsupported</code>.</td></tr><tr><td><code>--case-sensitive</code></td><td>Desactivado</td><td>Compara nombres y correos electrónicos teniendo en cuenta las mayúsculas. De forma predeterminada, las mayúsculas no importan. Un nombre de usuario coincide con el nombre de usuario o el nombre para mostrar; un correo electrónico coincide con el correo electrónico o el correo de inicio de sesión; un nombre de grupo coincide con el nombre del grupo.</td></tr></tbody></table>

Use como máximo uno de `--user`, `--group` y `--application`; de lo contrario, el comando se detiene con `conflictingOptions`.

## devo vault access grant

Da a un usuario o a un grupo un rol en una bóveda.

**Espacio de trabajo:** Devolutions Cloud

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatorio. Nombre de la bóveda, o su ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;vault></code> como un ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td></td><td>Usuario que recibe el rol: el nombre de forma predeterminada, o <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> o <code>email:&#x3C;value></code>. Un GUID solo se lee como un identificador.</td></tr><tr><td><code>--group &#x3C;group></code></td><td></td><td>Grupo de usuarios que recibe el rol: el nombre de forma predeterminada, o <code>id:&#x3C;value></code> o <code>name:&#x3C;value></code>. Un GUID solo se lee como un identificador.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Identidad de aplicación que recibe el rol. Devolutions Cloud la rechaza con <code>cloudVaultAccessPrincipalUnsupported</code>.</td></tr><tr><td><code>--role &#x3C;role></code></td><td></td><td>Rol de bóveda, por nombre o identificador, sin distinguir mayúsculas: <code>Restricted</code>, <code>Readers</code>, <code>PrivilegedReaders</code>, <code>Operators</code>, <code>PrivilegedOperators</code>, <code>Contributors</code> o <code>VaultOwners</code>. Un rol desconocido detiene el comando con <code>cloudVaultRoleNotFound</code>.</td></tr><tr><td><code>--case-sensitive</code></td><td>Desactivado</td><td>Compara nombres y correos electrónicos teniendo en cuenta las mayúsculas. De forma predeterminada, las mayúsculas no importan. Un nombre de usuario coincide con el nombre de usuario o el nombre para mostrar; un correo electrónico coincide con el correo electrónico o el correo de inicio de sesión; un nombre de grupo coincide con el nombre del grupo.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma el cambio. Obligatorio.</td></tr></tbody></table>

Pase exactamente uno de `--user` y `--group`: ninguno se detiene con `missingParameter`, varios con `conflictingOptions`. Cuando el nombre coincide con varios usuarios o grupos, el comando se detiene con `principalAmbiguous`: use el identificador.

## devo vault access revoke

Quita el acceso de un usuario o de un grupo a una bóveda. Alias: `devo vault access rm`.

**Espacio de trabajo:** Devolutions Cloud

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatorio. Nombre de la bóveda, o su ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>&#x3C;vault></code> como un ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td></td><td>Usuario cuyo acceso se quita: el nombre de forma predeterminada, o <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>Grupo de usuarios cuyo acceso se quita: el nombre de forma predeterminada, o <code>id:&#x3C;value></code> o <code>name:&#x3C;value></code>.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Identidad de aplicación cuyo acceso se quita. Devolutions Cloud la rechaza con <code>cloudVaultAccessPrincipalUnsupported</code>.</td></tr><tr><td><code>--all</code></td><td>Desactivado</td><td>Quita cada asignación de acceso de la bóveda. No se puede combinar con <code>--user</code>, <code>--group</code> o <code>--application</code>. Devolutions Cloud la rechaza con <code>cloudVaultAccessPrincipalUnsupported</code>: revoque un usuario o un grupo a la vez.</td></tr><tr><td><code>--case-sensitive</code></td><td>Desactivado</td><td>Compara nombres y correos electrónicos teniendo en cuenta las mayúsculas. De forma predeterminada, las mayúsculas no importan. Un nombre de usuario coincide con el nombre de usuario o el nombre para mostrar; un correo electrónico coincide con el correo electrónico o el correo de inicio de sesión; un nombre de grupo coincide con el nombre del grupo.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma la retirada. Obligatorio.</td></tr></tbody></table>

## devo vault variable list

Enumera las variables personalizadas de la bóveda actual, o de la bóveda que nombre, con su nombre, valor, ámbito, origen y descripción. Los valores se muestran en texto sin formato, excepto las variables cuyo nombre, o uno de cuyos campos almacenados, contiene `password`, `secret`, `token`, `encrypt`, `protected` o `safevalue`: su valor vuelve vacío y se marcan `redacted`. Alias: `devo vault variable ls`.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Todas las variables</td><td>Filtro de nombre opcional, sin distinguir mayúsculas. <code>*</code> coincide con cualquier texto y <code>?</code> con un carácter. Sin un comodín, el nombre debe coincidir exactamente. Los delimitadores <code>$</code> son opcionales.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Bóveda actual</td><td>Nombre de la bóveda, o su identificador con <code>id:&#x3C;value></code> o <code>--id</code>. Una bóveda desconocida se detiene con <code>vaultNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>--vault</code> como un ID.</td></tr></tbody></table>

## devo vault variable set

Crea una variable personalizada de la bóveda actual, o de la bóveda que nombre, o la actualiza si existe. El valor procede de una variable de entorno o de un archivo, nunca de la línea de comandos.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obligatorio. Nombre de variable: solo letras, números y guiones bajos. Los delimitadores <code>$</code> son opcionales; el nombre se guarda en mayúsculas, entre signos <code>$</code>.</td></tr><tr><td><code>--value-env &#x3C;variable></code></td><td></td><td>Variable de entorno que contiene el valor. La variable debe existir.</td></tr><tr><td><code>--value-file &#x3C;file></code></td><td></td><td>Archivo que contiene el valor. Se usa todo el contenido tal cual, incluido un salto de línea final.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Sin cambios</td><td>Descripción de la variable. Sin ella, se conserva una descripción existente.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Bóveda actual</td><td>Nombre de la bóveda, o su ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>--vault</code> como un ID.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma el cambio. Obligatorio.</td></tr></tbody></table>

Pase exactamente uno de `--value-env` y `--value-file`: ambos detienen el comando con `conflictingOptions`, ninguno con `missingParameter`. Definir de nuevo el mismo valor y la misma descripción detiene el comando con `sqliteVariableUpdateNoChanges`. Los cambios necesitan una base de datos local sin cifrar.

## devo vault variable delete

Elimina las variables personalizadas de la bóveda actual, o de la bóveda que nombre. Alias: `devo vault variable rm`.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Obligatorio. Uno o varios nombres de variable. Si un nombre no existe, o aparece dos veces, el comando falla y no elimina nada.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Bóveda actual</td><td>Nombre de la bóveda, o su ID con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>--vault</code> como un ID.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma la eliminación. Obligatorio.</td></tr></tbody></table>

## devo variable export

Escribe las variables personalizadas de un ámbito en un archivo JSON. Cada variable se escribe con su nombre, valor, descripción, ámbito y origen. Como con `list`, una variable cuyo nombre, o uno de cuyos campos almacenados, contiene `password`, `secret`, `token`, `encrypt`, `protected` o `safevalue` se escribe con un valor vacío. La exportación solo lee las variables: no necesita `--yes`, y funciona para cada ámbito, incluidos los que no puede cambiar desde Devolutions CLI. `variable export` es el único comando `devo variable`.

**Espacio de trabajo:** Perfil local

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

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--scope &#x3C;scope></code></td><td></td><td>Obligatorio. Qué variables exportar, sin distinguir mayúsculas: <code>workspace</code> (las variables del espacio de trabajo actual), <code>vault</code> (las variables de una bóveda), <code>option</code> (también escrito <code>options</code>: las variables guardadas en el archivo de opciones de Devolutions Remote Desktop Manager del perfil; un valor guardado de forma ofuscada vuelve vacío y se marca <code>unavailable</code>), o <code>user-vault</code> (también escrito <code>uservault</code>: se acepta, pero un perfil local no tiene variables de bóveda de usuario, así que el archivo contiene una lista vacía). Cualquier otro valor detiene el comando con <code>invalidVariableScope</code>.</td></tr><tr><td><code>--out-file &#x3C;file></code></td><td></td><td>Obligatorio. Archivo JSON que escribir. Su carpeta debe existir (<code>directoryNotFound</code> en caso contrario), y la ruta no puede ser una carpeta.</td></tr><tr><td><code>--force</code></td><td>Desactivado</td><td>Sustituye el archivo si existe. Sin ella, un archivo existente detiene el comando con <code>fileExists</code>.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Bóveda actual</td><td>Para los ámbitos <code>vault</code> y <code>user-vault</code>, la bóveda que exportar: nombre, o identificador con <code>id:&#x3C;value></code> o <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Desactivado</td><td>Trata <code>--vault</code> como un ID.</td></tr><tr><td><code>--name &#x3C;filter></code></td><td>Todas las variables</td><td>Conserva solo las variables cuyo nombre coincide, sin distinguir mayúsculas. <code>*</code> coincide con cualquier texto y <code>?</code> con un carácter.</td></tr></tbody></table>

{% hint style="warning" %}
El archivo exportado contiene los valores en texto sin formato, y Devolutions CLI no lo hace privado. No lo incluya en un commit, y elimínelo cuando ya no lo necesite.
{% endhint %}

## Páginas relacionadas

* [Manage vaults and entries](/cli/es/para-devops-y-administradores/manage/vaults-and-entries.md)
* [Use custom variables](/cli/es/para-devops-y-administradores/manage/custom-variables.md)
* [Manage users, groups, and access](/cli/es/para-devops-y-administradores/manage/users-and-access.md)
* [Entry commands](/cli/es/referencia/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/es/referencia/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.