> 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/automatizacion/jobs.md).

# Trabajos

Realice el seguimiento de los trabajos de PowerShell Universal, inspeccione la salida y los estados, configure límites de protección de la salida y la ocultación de datos sensibles, e invoque trabajos

Los trabajos son ejecuciones de scripts. Véalos en **Ejecutar > Trabajos** para inspeccionar el estado, la salida de flujo, la salida de canalización, los errores, las solicitudes de comentarios, la versión del script y los metadatos del trabajo.

## Salida

La salida de los flujos de PowerShell, incluidos los registros de información, host, error, advertencia y detallados, se muestra en el panel de salida del trabajo. Los objetos escritos en la canalización se almacenan como CliXml y están disponibles en la pestaña **Salida de canalización**.

Configure **Comportamiento para salidas de trabajo grandes** y **Tamaño máximo de salida del trabajo (KB)** en **Engranaje de configuración > Automatización** para proteger la instancia de una salida excesiva. El máximo predeterminado es de **10 240 KB**; establézcalo en `0` para desactivar el límite.

| Comportamiento | Resultado                                                               |
| -------------- | ----------------------------------------------------------------------- |
| Advertir       | Conserva la salida y crea una advertencia. Es la opción predeterminada. |
| Truncar        | Almacena la salida solo hasta el límite.                                |
| Comprimir      | Almacena la salida excedente en forma comprimida.                       |
| Ignorar        | No aplica el límite ni el comportamiento de advertencia.                |

También puede descartar la salida de canalización de un script individual con su opción **Descartar canalización**.

### Ocultar la salida sensible de los trabajos

Active **Ocultar salida sensible de trabajos** en **Engranaje de configuración > Automatización** para enmascarar valores de la salida del trabajo antes de que la salida se registre o se guarde. La ocultación está desactivada de forma predeterminada.

Cuando está activada, PowerShell Universal sustituye los valores coincidentes por `********` para los nombres de clave sensibles integrados, incluidos `password`, `secret`, `client_secret`, `api_key`, `access_token`, `token`, `authorization`, `credential` y `connection_string`. Reconoce formatos comunes de clave-valor como JSON, datos de formulario HTTP o de cadena de consulta, y salida delimitada por dos puntos.

```powershell
Write-Host '{"password": "MyPassword"}'
# Job output: {"password": "********"}

Write-Host 'client_secret=MyClientSecret'
# Job output: client_secret=********

Write-Host 'Authorization: [value]'
# Job output: Authorization: ********
```

Añada nombres de campo específicos de su organización con **Claves de salida sensibles adicionales** en la misma página de configuración. Estas claves utilizan los mismos patrones de coincidencia que las claves integradas.

La ocultación es una red de seguridad de la salida de mejor esfuerzo, no un escáner de secretos completo. No enmascara los valores que no se emiten como pares clave-valor reconocidos, incluidos los valores insertados en el formato de objetos personalizado u obtenidos de un proveedor de secretos. No escriba secretos en la salida del trabajo.

## Versión del script

Cada trabajo registra la versión resuelta del script que lo inició. Localice la etiqueta **Versión del script** en el encabezado del trabajo para identificar el origen utilizado en esa ejecución.

* Los scripts de repositorios sincronizados con Git registran el SHA del commit de Git resuelto.
* Los scripts de comandos de módulo registran la versión resuelta del módulo.

El valor registrado permanece con el trabajo después de que el script o el módulo cambien, lo que proporciona un registro de auditoría del momento de la ejecución. Los trabajos reintentados utilizan la versión del script resuelta actualmente cuando está disponible; de lo contrario, conservan la versión registrada original.

## Estado y comentarios

Los trabajos pueden estar **En cola**, **En ejecución**, **Error**, **Advertencia**, **Fallido** o **Esperando comentarios**. Una llamada a `Read-Host` pone un trabajo en Esperando comentarios; responda desde la página del trabajo. Utilice `Read-Host -AsSecureString` para la entrada de contraseñas.

## Invocar trabajos

Utilice `Invoke-PSUScript` para iniciar un trabajo y `Wait-PSUJob` para esperarlo. Desde fuera de PowerShell Universal, utilice un token de aplicación válido.

```powershell
Invoke-PSUScript -Script 'Script1.ps1' -RequiredParameter 'Hello' | Wait-PSUJob
```

Obtenga la salida de canalización con `Get-PSUJobPipelineOutput`.

```powershell
Get-PSUJobPipelineOutput -JobId 10
```

Utilice `-Integrated` solo desde dentro de PowerShell Universal. Las aplicaciones pueden usarlo con `-Wait` para reenviar las interacciones de `Write-Progress` y `Read-Host`.

```powershell
New-UDButton -Text 'Run script' -OnClick {
    Invoke-PSUScript -Name 'AppExample.ps1' -Integrated -Wait
} -ShowLoading
```

## ID de ejecución del trabajo

De forma predeterminada, los trabajos utilizan ID numéricos incrementales. Active `JobRunID` para utilizar un `RunID` basado en GUID en las búsquedas de trabajos.

```powershell
Set-PSUSetting -JobRunId
```

## API

* `Invoke-PSUScript`
* `Get-PSUJob`
* `Get-PSUJobOutput`
* `Get-PSUJobPipelineOutput`
* `Wait-PSUJob`


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/es/automatizacion/jobs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
