Widgets du portail

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.

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.

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.

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.

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.