exec

---

path: api-and-integrations/cli-utility/exec.mdx title: Ejecución de comandos (exec) slug: /api-and-integrations/cli-utility/exec pagination_next: null pagination_prev: null createdAt: "Mon Nov 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)" updatedAt: "Mon Nov 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)" description: >- Modo exec: ejecución de comandos con variables de entorno obtenidas de Passwork. keywords:

• Passwork
• CLI
• exec
• environment variables
• automation

---

Descripción general

exec obtiene un elemento de Passwork, descifra los valores y los exporta como variables de entorno, luego ejecuta el comando especificado con acceso a estas variables.

Identificación de elementos

Especifique uno o más parámetros con valores:

Parámetro	Descripción
--password-id	ID del elemento (o varios separados por comas)
--folder-id	ID de la carpeta (o varios separados por comas)
--vault-id	ID de la bóveda (o varios separados por comas)
--tags	Etiquetas de búsqueda (separadas por comas)

Cómo funciona

1. Se conecta al servidor y se autentica.
2. Busca elementos según los parámetros de identificación.
3. Descifra los valores (contraseña, campos personalizados).
4. Crea variables de entorno: el nombre de la variable corresponde al nombre del elemento/campo (los espacios/símbolos se reemplazan con _).
5. Ejecuta el comando; se devuelve el código de salida del comando.

Sintaxis

shell

passwork-cli exec [parameters] command_to_execute

O con --cmd:

shell

passwork-cli exec [parameters] --cmd "command_to_execute"

Ejemplos

Ejecutar un cliente de base de datos con una contraseña de un elemento:

shell

export PASSWORK_HOST="https://passwork.example.com"
export PASSWORK_TOKEN="<access_token>"
export PASSWORK_MASTER_KEY="<master_key>"

passwork-cli exec --password-id "db_password_id" \
  mysql -u admin -h localhost -p"$DB_PASSWORD" database_name

Obtener múltiples contraseñas de una carpeta y ejecutar un script:

shell

passwork-cli exec --folder-id "project_folder_id" ./deploy.sh

Comando con tuberías/comillas (a través de --cmd):

shell

passwork-cli exec --password-id "server_creds" \
  --cmd "ssh user@server 'journalctl -u app | grep ERROR' > errors.log"

Búsqueda por etiquetas y ejecución de un escenario complejo:

shell

passwork-cli exec \
  --tags "production,api" \
  ./complex_deployment.sh

Notas

• En las variables de entorno: el valor principal del elemento (contraseña) y los campos adicionales con tipo contraseña.
• Los nombres de las variables se normalizan: los espacios y caracteres especiales se reemplazan con _.
• Para certificados autofirmados, utilice --no-ssl-verify.