> 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/invoke-psuscript.md).

# Invoke-PSUScript

Invoke-PSUScript démarre une nouvelle tâche pour exécuter un script dans PowerShell Universal, en retournant une tâche dont vous pouvez suivre la progression et la sortie.

## SYNOPSIS

Démarre une nouvelle tâche PowerShell Universal pour un script.

## SYNTAXE

```powershell
Invoke-PSUScript -Script <Script> [-Environment <String>] [-Credential <Variable>] [-Notes <String>] [-WaitForDebugger] [-Wait] [-WaitTimeout <Int32>] [-Queue <String>] [-Parameters <Hashtable>] [-Tags <Tag[]>] [-Silent] [<ConnectionOptions>] [<CommonParameters>]
Invoke-PSUScript -Id <Int64> [-Environment <String>] [-Credential <Variable>] [-Notes <String>] [-WaitForDebugger] [-Wait] [-WaitTimeout <Int32>] [-Queue <String>] [-Parameters <Hashtable>] [-Tags <Tag[]>] [-Silent] [<ConnectionOptions>] [<CommonParameters>]
Invoke-PSUScript -Name <String> [-Environment <String>] [-Credential <Variable>] [-Notes <String>] [-WaitForDebugger] [-Wait] [-WaitTimeout <Int32>] [-Queue <String>] [-Parameters <Hashtable>] [-Tags <Tag[]>] [-Silent] [<ConnectionOptions>] [<CommonParameters>]
```

`<ConnectionOptions>`: `[-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]`. Les paramètres de script sont aussi exposés dynamiquement lorsque c'est possible.

## DESCRIPTION

Démarre une tâche que l'on peut suivre avec les applets de commande de tâches. Sélectionnez un script par nom, par ID ou par objet de script (qui accepte l'entrée du pipeline). Les paramètres de script normaux sont exposés dynamiquement. Les paramètres de script masqués ne sont volontairement pas exposés comme paramètres dynamiques de l'applet de commande, mais ils peuvent être fournis par la table de hachage `-Parameters` et sont transmis au script. Ici, `-Credential` est une *variable* d'identifiant PSU pour la tâche, et non un `PSCredential` pour l'authentification à l'API de gestion.

## EXEMPLE

```powershell
Invoke-PSUScript -Name 'Deploy.ps1' -Parameters @{ Region = 'westus'; InternalToken = $token }
```

## PARAMÈTRES

| Paramètre                | Description                                                                                       |
| ------------------------ | ------------------------------------------------------------------------------------------------- |
| `-Script`                | Objet de script à exécuter ; accepte l'entrée du pipeline.                                        |
| `-Id`                    | ID numérique du script à exécuter ; accepte l'entrée du pipeline.                                 |
| `-Name`                  | Nom ou chemin du script à exécuter.                                                               |
| `-Environment`           | Remplacement de l'environnement d'exécution (alias `-PowerShellVersion`).                         |
| `-Credential`            | Variable d'identifiant PSU utilisée pour la tâche.                                                |
| `-Notes`                 | Notes enregistrées avec la tâche.                                                                 |
| `-WaitForDebugger`       | Attend un débogueur avant l'exécution de la tâche.                                                |
| `-Wait`                  | Attend la fin de la tâche.                                                                        |
| `-WaitTimeout`           | Délai d'attente, en secondes.                                                                     |
| `-Queue`                 | File d'attente de tâches ou groupe d'ordinateurs (alias `-ComputerGroup`).                        |
| `-Parameters`            | Table de hachage des valeurs de paramètres du script, y compris les paramètres de script masqués. |
| `-Tags`                  | Étiquettes à attacher à la tâche.                                                                 |
| `-Silent`                | Masque la sortie d'exécution dans le pipeline actuel.                                             |
| `-ComputerName`          | URL ou nom d'hôte du serveur PSU cible (alias `-Uri`).                                            |
| `-AppToken`              | Jeton d'application 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

Le jeton d'accès requiert `automation.scripts.<script path>/execute` pour exécuter cette applet de commande à distance. Le chargement des paramètres du script requiert aussi `automation.scripts.<script path>/read`. La recherche du script peut en plus requérir `automation.scripts/read` ou `automation.scripts.<name>/read` lors de l'utilisation de `-Name`. Sans `-Wait`, la lecture de la nouvelle tâche requiert `automation.jobs.<job ID>/read` ou la ReadPermission configurée de la tâche.


---

# 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/invoke-psuscript.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.