> 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/portal/portal-widgets.md).

# Widgets du portail

Découvrez les widgets Portal intégrés de PowerShell Universal, y compris les formulaires de script, les tableaux et les graphiques, ainsi que la façon de créer des widgets personnalisés avec PSBlazor.

Les widgets sont des blocs d'interfaces utilisateur créés avec PowerShell et Blazor. Vous pouvez créer des interfaces utilisateur web robustes avec une expérience minimale en développement web.

## Widgets intégrés

PowerShell Universal offre des widgets intégrés permettant de s'intégrer à d'autres fonctionnalités de la plateforme afin d'afficher des éléments d'interface.

### Script Form

Fournit un formulaire permettant aux utilisateurs finaux d'exécuter des scripts. L'accès au Portal est évalué en trois étapes distinctes :

1. **Répertorier le script :** l'utilisateur doit posséder soit un rôle correspondant sous **Script Properties > Portal**, soit un rôle attribué à une étiquette **Display in Portal** associée.
2. **Ouvrir le formulaire de script :** l'utilisateur doit posséder un rôle correspondant sous **Script Properties > Portal**. Un accès accordé uniquement par une étiquette n'est pas suffisant.
3. **Exécuter le script :** l'utilisateur doit posséder la permission **Automation Scripts > Execute** applicable.

**Important :** les rôles du Portal, les rôles d'étiquette et les permissions Execute ne se remplacent pas les uns les autres. Un script peut être répertorié mais retourner **Unauthorized** lorsqu'il est ouvert, ou il peut s'ouvrir mais ne pas s'exécuter si l'utilisateur ne satisfait pas à toutes les exigences applicables.

Les étiquettes déterminent également où un script est répertorié :

| Configuration                                                                                        | Résultat dans le Portal                                                          |
| ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| Rôle Portal du script correspondant et aucune étiquette                                              | Répertorié à la racine du Portal                                                 |
| Étiquette **Display in Portal** autorisée                                                            | Répertorié sous l'étiquette                                                      |
| Étiquette autorisée, mais aucun rôle Portal du script correspondant                                  | Répertorié sous l'étiquette, mais retourne **Unauthorized** lorsqu'il est ouvert |
| Rôle Portal du script correspondant, mais aucune permission Execute                                  | Peut être répertorié et ouvert, mais ne peut pas être exécuté                    |
| Uniquement des étiquettes sans **Display in Portal**                                                 | Non répertorié, même avec un rôle Portal du script correspondant                 |
| Rôle Portal du script correspondant, permission Execute et étiquette **Display in Portal** autorisée | Répertorié sous l'étiquette et peut être ouvert et exécuté                       |

Une étiquette est autorisée lorsque **Display in Portal** est activé et que l'étiquette inclut un rôle attribué à l'utilisateur. Si un script possède des étiquettes, il n'est pas répertorié à la racine du Portal. Au moins une étiquette **Display in Portal** autorisée est requise pour qu'il puisse être découvert.

### Script Table

Le widget script table affiche un tableau basé sur la dernière sortie d'un script. Cela sélectionne la tâche la plus récente et génère le tableau en fonction des propriétés des objets retournés. Par exemple, essayez d'exécuter un script qui retourne les processus de la machine actuelle.

```powershell
Get-Process | Select-Object Name, Id
```

### Script Pie Chart

Le widget script pie chart affiche un graphique basé sur les données de la dernière exécution d'un script. Le script doit produire des données dans un format particulier afin de définir les parts du graphique. Voici un exemple de la façon de générer des données pour un graphique circulaire.

```powershell
1..5 | ForEach-Object {
    [PSCustomObject]@{ 
        type = "Category $_"
        value = Get-Random -Min 5 -Max 60
    }
}
```

Dans les propriétés du widget pie chart, réglez la Category Property à `type` et la Value Property à `value`.

### Script Line Chart

Le widget script line chart affiche un graphique basé sur les données de la dernière exécution d'un script. Le script doit produire des données dans un format particulier afin de définir les lignes du graphique. Voici un exemple de la façon de générer des données pour un graphique linéaire.

```powershell
1..5 | ForEach-Object {
    [PSCustomObject]@{ 
        type = "Category $_"
        value = Get-Random -Min 5 -Max 60
    }
}
```

Dans les propriétés du widget line chart, réglez le XProperty à `type` et le YProperty à `value`.

## Widgets prédéfinis

Vous pouvez trouver des widgets créés par Ironman Software et des membres de la communauté dans la[ PowerShell Universal Gallery](/powershell-universal/fr/plateforme/library.md).

## Widgets personnalisés

Vous pouvez développer vos propres widgets personnalisés à l'aide de PSBlazor. PSBlazor utilise une syntaxe semblable à Razor combinée à PowerShell afin de permettre la création de composants entièrement interactifs et personnalisables.


---

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