> 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/powershell-universal/es/comandos-de-powershell/invoke-psuworkflow.md).

# Invoke-PSUWorkflow

Invoke-PSUWorkflow ejecuta un flujo de trabajo configurado de PowerShell Universal por nombre, Id u objeto de flujo de trabajo.

## SINOPSIS

Ejecuta un flujo de trabajo en PowerShell Universal.

## SINTAXIS

```powershell
Invoke-PSUWorkflow -Name <String> [-Parameters <Hashtable>] [-Environment <String>] [-Queue <String>] [-Wait] [-WaitTimeout <Int32>] [<ExecutionOptions>] [<ConnectionOptions>]
Invoke-PSUWorkflow -Id <Int64> [-Parameters <Hashtable>] [<ExecutionOptions>] [<ConnectionOptions>]
Invoke-PSUWorkflow -Workflow <Workflow> [-Parameters <Hashtable>] [<ExecutionOptions>] [<ConnectionOptions>]
```

`<ExecutionOptions>`: `[-WaitForDebugger] [-Environment <String>] [-Notes <String>] [-Credential <Variable>] [-Wait] [-Queue <String>] [-WaitTimeout <Int32>] [-Tags <Tag[]>] [-Silent]`. `<ConnectionOptions>`: `[-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]`. Aquí, `-Credential` es una variable de credencial de PSU para la ejecución del flujo de trabajo, no las credenciales básicas de la API de administración.

## DESCRIPCIÓN

Ejecuta un flujo de trabajo configurado seleccionado por nombre, Id u objeto de flujo de trabajo (acepta la entrada de la canalización). Suministre las entradas declaradas del flujo de trabajo mediante `-Parameters`: los nombres desconocidos producen un error. Reemplace el entorno de ejecución o la cola y, de forma opcional, espere a que finalice. Con `-Wait`, el cmdlet delega en `Wait-PSUJob`; de lo contrario, devuelve el trabajo creado.

## EJEMPLOS

```powershell
Invoke-PSUWorkflow -Name 'DailyMaintenance'
Invoke-PSUWorkflow -Name 'Deploy' -Parameters @{ Environment = 'Test' } -Wait
```

## PARÁMETROS

| Parámetro                | Descripción                                                                                                                                 |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `-Name`                  | Nombre de flujo de trabajo obligatorio en el conjunto de parámetros predeterminado; sin distinguir mayúsculas de minúsculas.                |
| `-Id`                    | Id numérico de flujo de trabajo obligatorio en el conjunto de parámetros Id.                                                                |
| `-Workflow`              | Objeto de flujo de trabajo; acepta la entrada de la canalización.                                                                           |
| `-Parameters`            | Tabla hash de los valores de entrada declarados del flujo de trabajo; los nombres de parámetros desconocidos producen un error.             |
| `-Environment`           | Reemplazo del entorno de ejecución (alias `-PowerShellVersion`).                                                                            |
| `-Queue`                 | Cola de ejecución o grupo de ordenadores (alias `-ComputerGroup`).                                                                          |
| `-Wait`                  | Espera a que finalice el trabajo del flujo de trabajo.                                                                                      |
| `-WaitTimeout`           | Tiempo de espera en segundos utilizado durante la espera; un valor omitido o cero deja la espera sin esta sustitución del tiempo de espera. |
| `-WaitForDebugger`       | Espera a que se conecte un depurador antes de la ejecución.                                                                                 |
| `-Notes`                 | Notas adjuntas al trabajo del flujo de trabajo.                                                                                             |
| `-Credential`            | Variable de credencial de PSU utilizada para la ejecución.                                                                                  |
| `-Tags`                  | Etiquetas adjuntas al trabajo.                                                                                                              |
| `-Silent`                | Suprime la salida de la operación de espera.                                                                                                |
| `-ComputerName`          | URL o nombre de host de la API de administración de PSU (alias `-Uri`).                                                                     |
| `-AppToken`              | Token de aplicación de la API de administración.                                                                                            |
| `-UseDefaultCredentials` | Usa las credenciales actuales de Windows.                                                                                                   |
| `-Integrated`            | Usa el cliente de administración en proceso.                                                                                                |
| `-TrustCertificate`      | Ignora los errores de validación del certificado.                                                                                           |
| `-Cookies`               | Reutiliza las cookies de autenticación de la sesión.                                                                                        |

## ENLACES RELACIONADOS

[Get-PSUWorkflow](/powershell-universal/es/comandos-de-powershell/get-psuworkflow.md)

## PERMISOS

El token de acceso requiere `automation.workflows/execute` para ejecutar este cmdlet de forma remota. Recuperar primero un flujo de trabajo con `Get-PSUWorkflow` también requiere `automation.workflows/read`.


---

# 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/powershell-universal/es/comandos-de-powershell/invoke-psuworkflow.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.