> 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/new-psutrigger.md).

# New-PSUTrigger

New-PSUTrigger crea un activador de automatización en PowerShell Universal que ejecuta un script en respuesta a eventos como fallos de trabajos o paradas de paneles.

## SINOPSIS

Crea un activador de automatización.

## SINTAXIS

```powershell
New-PSUTrigger -Name <String> -EventType <EventType> -TriggerScript <Script> [-Script <Script>] [-Scripts <Script[]>] [-Dashboard <Dashboard>] [-Environment <String>] [-Delay <Int32>] [-Computer <String>] [-Condition <ScriptBlock>] [-Parameters <Hashtable>] [<ConnectionOptions>] [<CommonParameters>]
```

`<ConnectionOptions>`: `[-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]`.

## DESCRIPCIÓN

Crea un desencadenador que ejecuta un script de desencadenador para los eventos de PSU. Utilice `-Script` o `-Scripts` para asociar uno o varios scripts a los desencadenadores de eventos de trabajo; si se indican ambos, `-Scripts` tiene prioridad. `-Parameters` suministra una tabla hash al script de desencadenador y resuelve sus parámetros declarados. De forma opcional, filtre la ejecución con `-Condition`.

## EJEMPLO

```powershell
New-PSUTrigger -Name 'Build failures' -EventType JobFailed -Scripts 'Build.ps1','Deploy.ps1' -TriggerScript 'Notify.ps1' -Parameters @{ Channel = 'ops' }
```

## PARÁMETROS

| Parámetro                | Descripción                                                                        |
| ------------------------ | ---------------------------------------------------------------------------------- |
| `-Name`                  | Nombre de desencadenador obligatorio.                                              |
| `-EventType`             | Tipo de evento de PSU obligatorio que activa el desencadenador.                    |
| `-TriggerScript`         | Script obligatorio que se ejecuta cuando se produce el evento.                     |
| `-Script`                | Un script asociado para el filtrado de eventos.                                    |
| `-Scripts`               | Varios scripts asociados para el filtrado de eventos.                              |
| `-Dashboard`             | Aplicación asociada al evento.                                                     |
| `-Environment`           | Entorno de ejecución del script de desencadenador.                                 |
| `-Delay`                 | Retraso antes de ejecutar el desencadenador.                                       |
| `-Computer`              | Ordenador o grupo de ejecución.                                                    |
| `-Condition`             | Bloque de script de condición que debe cumplirse.                                  |
| `-Parameters`            | Valores de parámetros del script de desencadenador.                                |
| `-ComputerName`          | URL o nombre de host de la API de administración de PSU de destino (alias `-Uri`). |
| `-AppToken`              | Token de aplicación de la API de administración.                                   |
| `-Credential`            | Credenciales 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.                               |

## PERMISOS

El token de acceso requiere `automation.triggers/create` para ejecutar este cmdlet de forma remota.


---

# 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/new-psutrigger.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.