Partager via

Out-GridView

  • Référence
Module:
Microsoft.PowerShell.Utility

Envoie la sortie vers un tableau interactif dans une fenêtre distincte.

Syntax

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-PassThru]
   [<CommonParameters>]
Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-Wait]
   [<CommonParameters>]
Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-OutputMode <OutputModeOption>]
   [<CommonParameters>]

Description

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet Out-GridView de commande envoie la sortie d’une commande à une fenêtre en mode grille où la sortie est affichée dans une table interactive.

Étant donné que cette applet de commande nécessite une interface utilisateur, elle ne fonctionne pas sur Windows Server Core ou Windows Nano Server.

Vous pouvez utiliser les fonctionnalités suivantes du tableau pour examiner vos données :

  • Masquer, afficher et réorganiser les colonnes
  • Trier les lignes
  • Filtre rapide
  • Ajouter un filtre de critères
  • Copier et coller

Pour obtenir des instructions complètes, consultez la section Notes de cet article.

Notes

Cette applet de commande a été réintroduite dans PowerShell 7. Cette applet de commande est disponible uniquement sur les systèmes Windows qui prennent en charge windows Desktop. Pour obtenir une version multiplateforme de cette applet de commande, consultez le module ConsoleGuiTools dans le PowerShell Gallery.

Exemples

Exemple 1 : Processus de sortie vers une vue grille

Cet exemple obtient les processus en cours d’exécution sur l’ordinateur local et les envoie à une fenêtre en mode Grille.

Get-Process | Out-GridView

Exemple 2 : Utiliser une variable pour générer des processus dans une vue grille

Cet exemple obtient également les processus en cours d’exécution sur l’ordinateur local et les envoie à une fenêtre en mode grille.

$P = Get-Process
$P | Out-GridView

La sortie de l’applet Get-Process de commande est enregistrée dans la $P variable . Ensuite, $P est redirigé vers Out-GridView.

Exemple 3 : Afficher une propriété sélectionnée dans une grille

Cet exemple montre comment afficher les propriétés sélectionnées des processus en cours d’exécution dans une vue grille.

Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
  Sort-Object -Property WorkingSet -Descending | Out-GridView

La sortie de Get-Process est redirigée vers Select-Object pour sélectionner les propriétés Name, WorkingSet et PeakWorkingSet . Un autre opérateur de pipeline envoie les objets filtrés à l’applet Sort-Object de commande pour les trier dans l’ordre décroissant selon la valeur de la propriété WorkingSet . Ensuite, les résultats triés sont redirigés vers Out-GridView. Vous pouvez maintenant utiliser les fonctionnalités de l'affichage de grille pour rechercher, trier ou filtrer les données.

Exemple 4 : Enregistrer la sortie dans une variable, puis générer une vue grille

Cet exemple enregistre la sortie de l’applet de commande dans une variable, puis l’envoie à Out-GridView.

($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView

Get-ChildItem obtient tous les fichiers du répertoire d’installation de PowerShell et ses sous-répertoires à l’aide de la $PSHOME variable automatique. Les parenthèses de la commande établissent l'ordre des opérations. Par conséquent, la sortie de la Get-ChildItem commande est enregistrée dans la $A variable avant d’être envoyée à Out-GridView.

Exemple 5 : processus de sortie d’un ordinateur spécifié vers une vue grille

Cet exemple montre comment afficher les processus en cours d’exécution sur l’ordinateur Server01 dans une fenêtre en mode grille.

Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

L’exemple utilise ogv, qui est l’alias de l’applet de Out-GridView commande . Le paramètre Title spécifie le titre de la fenêtre.

Exemple 6 : Sortie de données d’ordinateurs distants vers une vue grille

Cet exemple montre comment envoyer des données collectées à partir d’ordinateurs distants vers Out-GridView.

Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

Invoke-Command s’exécute Get-Culture sur trois ordinateurs distants. Les données obtenues sont redirigées vers Out-GridView. Notez que le bloc de script qui s’exécute sur l’ordinateur distant n’inclut pas la Out-GridView commande . Si tel était le cas, la commande échouerait quand elle essaierait d'ouvrir une fenêtre d'affichage de grille sur chacun des ordinateurs distants.

Exemple 7 : Passer plusieurs éléments via « Out-GridView »

Cet exemple vous permet de sélectionner plusieurs processus dans la Out-GridView fenêtre. Les processus que vous sélectionnez sont passés à la Export-Csv commande et écrits dans le ProcessLog.csv fichier.

Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

Le paramètre PassThru de vous permet d’envoyer Out-GridView plusieurs éléments dans le pipeline. Le paramètre PassThru équivaut à l'utilisation de la valeur Multiple du paramètre OutputMode.

Exemple 8 : Create un raccourci Windows vers « Out-GridView »

Cet exemple montre comment utiliser le paramètre Wait de Out-GridView pour créer un raccourci Windows vers la Out-GridView fenêtre.

pwsh -Command "Get-Service | Out-GridView -Wait"

Cette ligne de commande peut être utilisée dans un raccourci Windows. Sans le paramètre Wait , PowerShell se fermerait dès l’ouverture de la Out-GridView fenêtre, ce qui fermerait la Out-GridView fenêtre presque immédiatement.

Paramètres

-InputObject

Spécifie l’objet que l’applet de commande accepte comme entrée pour Out-GridView.

Lorsque vous utilisez le paramètre InputObject pour envoyer une collection d’objets à Out-GridView, Out-GridView traite la collection comme un objet de collection et affiche une ligne qui représente la collection. Pour afficher chaque objet de la collection, utilisez un opérateur de pipeline (|) pour envoyer des objets à Out-GridView.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OutputMode

Spécifie les éléments que la fenêtre interactive envoie dans le pipeline en tant qu’entrée à d’autres commandes. Par défaut, cette applet de commande ne génère aucun résultat. Pour envoyer des éléments depuis la fenêtre interactive dans le pipeline, cliquez pour sélectionner les éléments, puis cliquez sur OK.

Les valeurs de ce paramètre déterminent le nombre d'éléments que vous pouvez envoyer dans le pipeline.

  • None. aucun élément. Il s’agit de la valeur par défaut.
  • Single. zéro ou un élément. Utilisez cette valeur lorsque la commande suivante ne peut prendre qu'un seul objet en entrée.
  • Multiple. zéro, un ou plusieurs éléments. Utilisez cette valeur lorsque la commande suivante peut prendre plusieurs objets en entrée. Cette valeur est équivalente au paramètre Passthru.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:OutputModeOption
Accepted values:None, Single, Multiple
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Indique que l’applet de commande envoie des éléments de la fenêtre interactive vers le bas du pipeline en tant qu’entrée à d’autres commandes. Par défaut, cette applet de commande ne génère aucun résultat. Ce paramètre est équivalent à l'utilisation de la valeur Multiple du paramètre OutputMode.

Pour envoyer des éléments depuis la fenêtre interactive dans le pipeline, cliquez pour sélectionner les éléments, puis cliquez sur OK. MAJ+clic et Ctrl+clic sont pris en charge.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Title

Spécifie le texte qui s’affiche dans la barre de titre de la Out-GridView fenêtre. Par défaut, la barre de titre affiche la commande qui appelle Out-GridView.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Wait

Indique que l’applet de commande supprime l’invite de commandes et empêche Windows PowerShell de se fermer jusqu’à ce que la Out-GridView fenêtre soit fermée. Par défaut, l’invite de commandes retourne lorsque la fenêtre s’ouvre Out-GridView .

Cette fonctionnalité vous permet d’utiliser les applets de Out-GridView commande dans les raccourcis Windows. Quand Out-GridView est utilisé dans un raccourci sans le paramètre Wait , la Out-GridView fenêtre s’affiche uniquement momentanément avant la fermeture de PowerShell.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

PSObject

Vous pouvez diriger n’importe quel objet vers cette applet de commande.

Sorties

None

Par défaut, cette applet de commande ne retourne aucune sortie.

PSObject

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne des objets représentant les lignes sélectionnées.

Notes

PowerShell inclut les alias suivants pour Out-GridView:

  • Windows :
    • ogv

Cette applet de commande est disponible uniquement sur les plateformes Windows. Cette applet de commande est disponible uniquement sur les plateformes Windows.

Vous ne pouvez pas utiliser une commande distante pour ouvrir une fenêtre d'affichage de grille sur un autre ordinateur.

La sortie de commande que vous envoyez à Out-GridView ne peut pas être mise en forme à l’aide Format des applets de commande, telles que Format-Table ou Format-Wide des applets de commande. Pour sélectionner des propriétés, utilisez l’applet de Select-Object commande .

La sortie désérialisée à partir des commandes distantes ne peut pas être correctement mise en forme dans la fenêtre d'affichage de grille.

Raccourcis clavier pourOut-GridView

Utilisez cette clé : Pour exécuter cette action :
Onglet Déplace le curseur de la zone Filtre vers le menu Ajouter des critères dans le tableau, puis retour vers l’arrière.
UpArrow Monter d’une ligne. Se déplace vers les en-têtes de colonne à partir de la première ligne de données.
DownArrow Descendre d’une ligne.
LeftArrow Dans la ligne d’en-tête de colonne, déplacez une colonne vers la gauche.
RightArrow Dans la ligne d’en-tête de colonne, déplacez une colonne vers la droite.
ContextMenuKey Dans la ligne d’en-tête de colonne, affiche l’option Sélectionner des colonnes.
Entrée ou Espace Dans la ligne d’en-tête de colonne, triez les données de colonne (basculez A-Z, Z-A).

Guide pratique pour utiliser les fonctionnalités de la fenêtre d’affichage grille

Pour masquer ou afficher une colonne :

  1. Cliquez avec le bouton droit sur un en-tête de colonne, puis cliquez sur Sélectionner des colonnes.
  2. Dans la boîte de dialogue Sélectionner des colonnes , utilisez les touches de direction pour déplacer les colonnes entre les colonnes sélectionnées et les colonnes disponibles. Seules les colonnes de la zone Sélectionner des colonnes s’affichent dans la fenêtre en mode Grille.

Pour réorganiser les colonnes :

Vous pouvez glisser-déplacer des colonnes à l’emplacement souhaité. Vous pouvez également effectuer les étapes suivantes :

  1. Cliquez avec le bouton droit sur un en-tête de colonne, puis cliquez sur Sélectionner des colonnes.
  2. Dans la boîte de dialogue Sélectionner des colonnes , utilisez les boutons Monter et Descendre pour réorganiser les colonnes. Les colonnes en haut de la liste apparaissent à gauche des colonnes au bas de la liste dans la fenêtre d'affichage de grille.

Comment trier les données de tableau

  • Pour trier les données, cliquez sur un en-tête de colonne.
  • Pour modifier l’ordre de tri, cliquez à nouveau sur l’en-tête de colonne. Chaque fois que vous cliquez sur le même en-tête, l'ordre de tri bascule de croissant à décroissant (ou inversement). L'ordre actif est indiqué par un triangle dans l'en-tête de colonne.

Comment sélectionner les données de tableau

  • Pour sélectionner une ligne, sélectionnez la ligne ou utilisez la flèche haut ou vers le bas pour accéder à la ligne.
  • Pour sélectionner toutes les lignes (à l’exception de la ligne d’en-tête), appuyez sur CTRL+A.
  • Pour sélectionner des lignes consécutives, appuyez longuement sur la touche Maj tout en cliquant sur les lignes ou en utilisant les touches de direction.
  • Pour sélectionner des lignes non conséquentes, appuyez sur la touche Ctrl et cliquez sur pour ajouter une ligne à la sélection.
  • Vous ne pouvez pas sélectionner des colonnes et vous ne pouvez pas sélectionner la ligne d'en-tête d'une colonne entière.

Comment copier des lignes

  • Pour copier une ou plusieurs lignes de la table, sélectionnez les lignes, puis appuyez sur Ctrl+C.

    Vous pouvez coller les données dans n'importe quel tableur ou traitement de texte. Vous ne pouvez pas copier des colonnes ou des parties de ligne et vous ne pouvez pas copier la ligne d'en-tête de colonne.

Guide pratique pour Recherche dans la table (filtre rapide)

Utilisez la zone Filtrer pour rechercher des données dans la table. Lorsque vous entrez une valeur dans la zone, seuls les éléments qui incluent le texte entré apparaissent dans le tableau.

  • Recherche pour le texte. Pour rechercher du texte dans le tableau, dans la zone Filtre, tapez le texte à rechercher.

  • Recherche pour plusieurs mots. Pour rechercher plusieurs mots dans le tableau, tapez les mots séparés par un espace. Out-GridView affiche des lignes qui incluent tous les mots ( LOGIQUE AND).

  • Recherche pour les expressions littérales. Pour rechercher une expression qui comporte des espaces ou des caractères spéciaux, placez-la entre guillemets. Out-GridView affiche des lignes qui incluent une correspondance exacte pour l’expression .

  • Recherche en colonnes. Pour rechercher un texte dans une ou plusieurs colonnes, utilisez le format suivant :

    <column>:<text> [<column>:<text>] ...

    Par exemple, pour rechercher « Net » dans la colonne DisplayName , dans la zone Filtre , tapez :

    displayname:net

    Pour rechercher des lignes avec « Net » dans les colonnes DisplayName et Name , dans la zone Filtre , tapez :

    displayname:net name:net

  • Désactiver la recherche. Pour afficher à nouveau la table entière, cliquez sur le bouton X rouge dans le coin supérieur droit de la zone Filtrer ou supprimez le texte de la zone Filtrer .

Utiliser des critères pour filtrer le tableau

Vous pouvez utiliser des règles ou des critères pour déterminer quels éléments sont affichés dans la table. Les éléments apparaissent uniquement lorsqu’ils répondent à tous les critères que vous établissez. Les critères disponibles sont déterminés par les propriétés des objets affichés dans la fenêtre d'affichage de grille et les types .NET Framework de ces propriétés.

Chaque critère a le format suivant :

<column> <operator> <value>

Les critères des différentes propriétés sont connectés par AND. Les critères pour la même propriété sont connectés par OR. Vous ne pouvez pas modifier les connecteurs logiques.

Les critères affectent uniquement l'affichage. Ils ne suppriment pas des éléments du tableau.

Comment ajouter des critères

  1. Pour afficher le bouton de menu Ajouter des critères , dans le coin supérieur droit de la fenêtre, cliquez sur la flèche Développer.
  2. Cliquez sur le bouton du menu Ajouter des critères .
  3. Cliquez pour sélectionner les colonnes (propriétés). Vous pouvez sélectionner une ou plusieurs propriétés.
  4. Lorsque vous avez terminé de sélectionner les propriétés, cliquez sur le bouton Ajouter .
  5. Pour annuler les ajouts, cliquez sur Annuler.
  6. Pour ajouter d’autres critères, cliquez à nouveau sur le bouton Ajouter des critères .

Comment modifier un critère

  • Pour modifier un opérateur, cliquez sur la valeur de l’opérateur bleu, puis sélectionnez un autre opérateur dans la liste déroulante.
  • Pour entrer ou modifier une valeur, tapez une valeur dans la zone valeur. Si vous entrez une valeur qui n'est pas valide, une icône en forme de X s'affiche. Pour supprimer la valeur, modifiez-la.
  • Pour créer une instruction OR , ajoutez un critère avec la même propriété.

Comment supprimer des critères

  • Pour supprimer les critères sélectionnés, cliquez sur le X rouge à côté de chaque critère.
  • Pour supprimer tous les critères, cliquez sur le bouton Effacer tout .