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

# Get-PSUJob

Get-PSUJob récupère les tâches exécutées dans PowerShell Universal, filtrables par statut, Id, Id d'exécution ou l'identité qui les a déclenchées.

## SYNOPSIS

Récupère les tâches exécutées dans PowerShell Universal.

## SYNTAXE

```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]`.

## DESCRIPTION

Liste les tâches ou récupère une tâche par ID ou par ID d'exécution. `-Id` recherche les tâches parent et enfant associées, sauf si `-HideChildren $true` masque les enfants. `-RunId` requiert la fonctionnalité JobRunId. Les requêtes de liste prennent en charge la pagination PowerShell, le statut et le tri. Dans l'implémentation actuelle, `-HideArchived` s'applique aux requêtes de liste `-Identity`, `-Script` et `-Schedule`, mais pas à la liste par défaut de toutes les tâches. Bien que le paramètre `-Schedule` soit accepté, son implémentation de requête de liste n'applique pas actuellement de filtre de planification.

## EXEMPLES

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

## PARAMÈTRES

| Paramètre                | Description                                                                                                                                                |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-Id`                    | Récupère une tâche par ID numérique.                                                                                                                       |
| `-RunId`                 | Récupère une tâche par GUID d'exécution.                                                                                                                   |
| `-Identity`              | Liste les tâches d'une identité ; accepte l'entrée du pipeline.                                                                                            |
| `-Script`                | Liste les tâches d'un script ; accepte l'entrée du pipeline.                                                                                               |
| `-Schedule`              | Accepte un objet de planification par le pipeline ; la requête de liste actuelle ne filtre pas par planification.                                          |
| `-Status`                | Filtre les requêtes de liste par statut.                                                                                                                   |
| `-OrderBy`               | Trie les listes par `Id`, `StartTime` ou `EndTime` (`Id` par défaut).                                                                                      |
| `-OrderDirection`        | Sélectionne le sens du tri pour les requêtes de liste.                                                                                                     |
| `-HideChildren`          | Masque les tâches enfants (`$true`) ; s'applique aux listes et aux recherches détaillées.                                                                  |
| `-HideScheduled`         | Exclut les tâches planifiées des listes lorsque la valeur est `$true`.                                                                                     |
| `-HideTriggered`         | Exclut les tâches déclenchées des listes lorsque la valeur est `$true`.                                                                                    |
| `-HideArchived`          | Exclut les tâches archivées lors de l'utilisation de `-Identity`, `-Script` ou `-Schedule` ; ne s'applique pas à la liste par défaut de toutes les tâches. |
| `-Skip`                  | Ignore ce nombre de tâches lors de la pagination d'une liste.                                                                                              |
| `-First`                 | Retourne au plus ce nombre de tâches lors de la pagination d'une liste.                                                                                    |
| `-IncludeTotalCount`     | Émet le nombre total de tâches correspondantes pour une liste paginée.                                                                                     |
| `-ComputerName`          | URL ou nom d'hôte du serveur PSU cible (alias `-Uri`).                                                                                                     |
| `-AppToken`              | Jeton d'application pour l'API de gestion.                                                                                                                 |
| `-Credential`            | Identifiants pour l'API de gestion.                                                                                                                        |
| `-UseDefaultCredentials` | Utilise les identifiants Windows actuels.                                                                                                                  |
| `-Integrated`            | Utilise le client de gestion dans le processus à l'intérieur de PSU.                                                                                       |
| `-TrustCertificate`      | Ignore les erreurs de validation du certificat.                                                                                                            |
| `-Cookies`               | Réutilise les témoins d'authentification pour cette session PowerShell.                                                                                    |

## PERMISSIONS

Lister ou filtrer les tâches requiert `automation.jobs/read`. Lire une tâche par `-Id` ou `-RunId` requiert `automation.jobs.<job ID>/read` pour la tâche demandée et pour toute tâche parent ou enfant retournée. Une ReadPermission personnalisée correspondante sur la tâche peut aussi autoriser l'accès détaillé.


---

# 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/fr/commandes-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.