> 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/get-psujob.md).

# Get-PSUJob

Get-PSUJob recupera los trabajos ejecutados en PowerShell Universal, con posibilidad de filtrarlos por estado, Id, Id de ejecución o la identidad que los activó.

## SINOPSIS

Recupera los trabajos ejecutados en PowerShell Universal.

## SINTAXIS

```powershell
Get-PSUJob [-Status <JobStatus>] [-OrderBy <String>] [-OrderDirection <OrderDirection>] [-HideChildren <Boolean>] [-HideScheduled <Boolean>] [-HideTriggered <Boolean>] [-HideArchived <Boolean>] [-Skip <UInt64>] [-First <UInt64>] [-IncludeTotalCount] [<ConnectionOptions>] [<CommonParameters>]
Get-PSUJob -Id <Int64> [-HideChildren <Boolean>] [<ConnectionOptions>] [<CommonParameters>]
Get-PSUJob -RunId <Guid> [-HideChildren <Boolean>] [<ConnectionOptions>] [<CommonParameters>]
Get-PSUJob -Identity <Identity> [-Status <JobStatus>] [-OrderBy <String>] [-OrderDirection <OrderDirection>] [-HideChildren <Boolean>] [-HideScheduled <Boolean>] [-HideTriggered <Boolean>] [-HideArchived <Boolean>] [-Skip <UInt64>] [-First <UInt64>] [-IncludeTotalCount] [<ConnectionOptions>] [<CommonParameters>]
Get-PSUJob -Script <Script> [-Status <JobStatus>] [-OrderBy <String>] [-OrderDirection <OrderDirection>] [-HideChildren <Boolean>] [-HideScheduled <Boolean>] [-HideTriggered <Boolean>] [-HideArchived <Boolean>] [-Skip <UInt64>] [-First <UInt64>] [-IncludeTotalCount] [<ConnectionOptions>] [<CommonParameters>]
Get-PSUJob -Schedule <Schedule> [-Status <JobStatus>] [-OrderBy <String>] [-OrderDirection <OrderDirection>] [-HideChildren <Boolean>] [-HideScheduled <Boolean>] [-HideTriggered <Boolean>] [-HideArchived <Boolean>] [-Skip <UInt64>] [-First <UInt64>] [-IncludeTotalCount] [<ConnectionOptions>] [<CommonParameters>]
```

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

## DESCRIPCIÓN

Enumera trabajos o recupera un trabajo por Id o Id de ejecución. `-Id` busca los trabajos primarios y secundarios relacionados, a menos que `-HideChildren $true` oculte los secundarios. `-RunId` requiere la característica JobRunId. Las consultas de lista admiten la paginación de PowerShell, el estado y la ordenación. En la implementación actual, `-HideArchived` se aplica a las consultas de lista de `-Identity`, `-Script` y `-Schedule`, pero no a la lista predeterminada de todos los trabajos. Aunque se acepta el parámetro `-Schedule`, su implementación de consulta de lista no aplica actualmente un filtro de programación.

## EJEMPLOS

```powershell
Get-PSUJob -RunId 'a1b2c3d4-1111-2222-3333-444455556666'
Get-PSUScript -Id 4 | Get-PSUJob -HideArchived $true
```

## PARÁMETROS

| Parámetro                | Descripción                                                                                                                                 |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `-Id`                    | Recupera un trabajo por Id numérico.                                                                                                        |
| `-RunId`                 | Recupera un trabajo por GUID de ejecución.                                                                                                  |
| `-Identity`              | Enumera los trabajos de una identidad; acepta la entrada de la canalización.                                                                |
| `-Script`                | Enumera los trabajos de un script; acepta la entrada de la canalización.                                                                    |
| `-Schedule`              | Acepta un objeto de programación a través de la canalización; la consulta de lista actual no filtra por programación.                       |
| `-Status`                | Filtra las consultas de lista por estado.                                                                                                   |
| `-OrderBy`               | Ordena las listas por `Id`, `StartTime` o `EndTime` (`Id` de forma predeterminada).                                                         |
| `-OrderDirection`        | Selecciona la dirección de ordenación de las consultas de lista.                                                                            |
| `-HideChildren`          | Oculta los trabajos secundarios (`$true`); se aplica a las listas y a las búsquedas de detalle.                                             |
| `-HideScheduled`         | Excluye los trabajos programados de las listas cuando el valor es `$true`.                                                                  |
| `-HideTriggered`         | Excluye los trabajos desencadenados de las listas cuando el valor es `$true`.                                                               |
| `-HideArchived`          | Excluye los trabajos archivados al usar `-Identity`, `-Script` o `-Schedule`; no se aplica a la lista predeterminada de todos los trabajos. |
| `-Skip`                  | Omite este número de trabajos al paginar una lista.                                                                                         |
| `-First`                 | Devuelve como máximo este número de trabajos al paginar una lista.                                                                          |
| `-IncludeTotalCount`     | Emite el número total de trabajos coincidentes de una lista paginada.                                                                       |
| `-ComputerName`          | URL o nombre de host del servidor PSU de destino (alias `-Uri`).                                                                            |
| `-AppToken`              | Token de aplicación para la API de administración.                                                                                          |
| `-Credential`            | Credenciales para la API de administración.                                                                                                 |
| `-UseDefaultCredentials` | Usa las credenciales actuales de Windows.                                                                                                   |
| `-Integrated`            | Usa el cliente de administración en proceso dentro de PSU.                                                                                  |
| `-TrustCertificate`      | Ignora los errores de validación del certificado.                                                                                           |
| `-Cookies`               | Reutiliza las cookies de autenticación para esta sesión de PowerShell.                                                                      |

## PERMISOS

Enumerar o filtrar trabajos requiere `automation.jobs/read`. Leer un trabajo mediante `-Id` o `-RunId` requiere `automation.jobs.<job ID>/read` para el trabajo solicitado y para cualquier trabajo primario o secundario devuelto. Un ReadPermission personalizado coincidente en el trabajo también puede autorizar el acceso de detalle.


---

# 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/get-psujob.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.