> 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/send-psuevent.md).

# Send-PSUEvent

Send-PSUEvent envoie des données d'événement ou des commandes distantes à une connexion de concentrateur d'événements ou à une session d'ordinateur connectée.

## SYNOPSIS

Envoie des données ou des commandes à un hub d'événements, à un ordinateur ou à un groupe d'ordinateurs.

## SYNTAXE

```powershell
Send-PSUEvent -Hub <String> [-ConnectionId <String>] [-Data <Object>] [-Timeout <Int32>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
Send-PSUEvent -Hub <String> [-ConnectionId <String>] [-Command <String>] [-Parameters <Hashtable>] [-Timeout <Int32>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
Send-PSUEvent -Computer <String> [-Data <Object>] [-ScriptBlock <ScriptBlock>] [-Timeout <Int32>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
Send-PSUEvent -Computer <String> [-Command <String>] [-Parameters <Hashtable>] [-Timeout <Int32>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
Send-PSUEvent -ComputerGroup <String> [-Data <Object>] [-ScriptBlock <ScriptBlock>] [-Timeout <Int32>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
Send-PSUEvent -ComputerGroup <String> [-Command <String>] [-Parameters <Hashtable>] [-Timeout <Int32>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
```

## DESCRIPTION

Envoie des données sérialisées ou demande l'exécution d'une commande sur les agents connectés. Sélectionnez un concentrateur d'événements avec `-Hub`, un agent avec `-Computer` ou un groupe avec `-ComputerGroup`. Pour un agent, utilisez `-ScriptBlock` pour un appel de script ou `-Command` et `-Parameters` pour une commande de module ; ces options appartiennent à des jeux de paramètres différents. `-Timeout` est de 30 secondes par défaut. `Invoke-PSUCommand` est un alias.

## EXEMPLES

```powershell
Send-PSUEvent -Hub 'MyHub' -Data @{ Name = 'Adam' }
Send-PSUEvent -ComputerGroup 'Build agents' -Command 'Get-Process' -Parameters @{ Name = 'pwsh' } -Timeout 30
```

## PARAMÈTRES

| Paramètre                | Description                                                                                                                   |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| `-Hub`                   | Nom du concentrateur d'événements ; les données d'événement vont à toutes les connexions, sauf si `-ConnectionId` est fourni. |
| `-ConnectionId`          | Envoie à une connexion précise du concentrateur.                                                                              |
| `-Computer`              | Cible un ordinateur connecté.                                                                                                 |
| `-ComputerGroup`         | Cible un groupe d'ordinateurs connectés.                                                                                      |
| `-Data`                  | Objet à sérialiser et à envoyer à un concentrateur ou à un ordinateur.                                                        |
| `-ScriptBlock`           | Script à exécuter sur un ordinateur ou un groupe d'ordinateurs.                                                               |
| `-Command`               | Commande de module à exécuter sur un ordinateur, un groupe ou un concentrateur.                                               |
| `-Parameters`            | Table de hachage des paramètres transmis à `-Command`.                                                                        |
| `-Timeout`               | Temps d'attente du résultat, en secondes ; la valeur par défaut est 30.                                                       |
| `-ComputerName`          | URL du serveur PSU pour une connexion de gestion distante ; alias : `-Uri`.                                                   |
| `-AppToken`              | Jeton d'application pour une connexion de gestion distante.                                                                   |
| `-Credential`            | Identifiants pour l'API de gestion.                                                                                           |
| `-UseDefaultCredentials` | Utilisez les identifiants Windows actuels pour la connexion de gestion.                                                       |
| `-Integrated`            | Utilisez le client de gestion PSU dans le processus lorsque l'applet de commande s'exécute à l'intérieur de PSU.              |
| `-TrustCertificate`      | Autorise une connexion distante avec un certificat TLS non approuvé.                                                          |
| `-Cookies`               | Réutilisez et conservez les témoins d'authentification dans cette session PowerShell.                                         |

## PERMISSIONS

Le jeton d'accès requiert `apis.eventhubs/execute` pour exécuter cette applet de commande à distance. Cela s'applique aussi lorsque la commande cible un ordinateur ou un groupe d'ordinateurs.


---

# 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/send-psuevent.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.