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 d’affichage 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.

Remarque

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 le Bureau Windows. Pour obtenir une version multiplateforme de cette applet de commande, consultez le module ConsoleGuiTools dans PowerShell Gallery.

Exemples

Exemple 1 : Processus de sortie vers une vue de grille

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

Get-Process | Out-GridView

Exemple 2 : Utiliser une variable pour générer des processus en mode grille

Cet exemple obtient également les processus en cours d’exécution sur l’ordinateur local et les envoie à une fenêtre d’affichage de 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 des propriétés sélectionnées dans un affichage 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 est Get-Process redirigée pour Select-Object sélectionner les propriétés Name, WorkingSet et PeakWorkingSet . Un autre opérateur de pipeline envoie les objets filtrés à l’applet de commande pour les trier dans l’ordre Sort-Object décroissant en fonction de 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 de 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 dans le 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 son envoi à Out-GridView.

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

Cet exemple montre comment afficher les processus en cours d’exécution sur l’ordinateur Server01 dans une fenêtre d’affichage 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 des données des 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 vers le bas du pipeline. Le paramètre PassThru équivaut à utiliser la valeur multiple du paramètre OutputMode .

Exemple 8 : Créer un raccourci Windows vers « Out-GridView »

Cet exemple montre comment utiliser le paramètre Wait pour Out-GridView 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 ferme dès que la Out-GridView fenêtre s’ouvre, ce qui ferme presque immédiatement la Out-GridView fenêtre.

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 au pipeline comme 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 équivaut 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 équivaut à utiliser 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 apparaît 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 La fermeture de Windows PowerShell jusqu’à ce que la Out-GridView fenêtre soit fermée. Par défaut, l’invite de commandes retourne lorsque la Out-GridView fenêtre s’ouvre.

Cette fonctionnalité vous permet d’utiliser les Out-GridView applets de commande dans les raccourcis Windows. Lorsqu’elle Out-GridView est utilisée dans un raccourci sans 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 ne peut pas être mise en forme à Out-GridView l’aide Format des applets de commande, telles que Format-Table les applets de commande ou Format-Wide les 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 effectuer cette action :
Tab Déplace le curseur de la zone Filtre vers le menu Ajouter des critères au tableau et à l’arrière.
UpArrow Monter une ligne. Passe aux en-têtes de colonne 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-la vers la gauche d’une colonne.
RightArrow Dans la ligne d’en-tête de colonne, déplacez-la vers la droite d’une colonne.
ContextMenuKey Dans la ligne d’en-tête de colonne, affiche l’option Sélectionner des colonnes.
Entrée ou barre d’espace Dans la ligne d’en-tête de colonne, triez les données de colonne (bascule A-Z, Z-A).

Comment utiliser les fonctionnalités de la fenêtre d’affichage grille

Pour masquer ou afficher une colonne :

  1. Cliquez avec le bouton droit sur n’importe quel 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 vers les zones Colonnes disponibles. Seules les colonnes de la zone Sélectionner des colonnes apparaissent dans la fenêtre d’affichage grille.

Pour réorganiser les colonnes :

Vous pouvez faire glisser et déplacer des colonnes vers l’emplacement souhaité. Vous pouvez également effectuer les étapes suivantes :

  1. Cliquez avec le bouton droit sur n’importe quel 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 Déplacer vers le haut 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 des données de table

  • 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 des données de table

  • Pour sélectionner une ligne, sélectionnez la ligne ou utilisez la flèche vers le haut ou 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 décocutives, appuyez sur la touche Ctrl et cliquez 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 du tableau, 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.

Comment effectuer une recherche dans le tableau (filtre rapide)

Utilisez la zone Filtre 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.

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

  • Recherchez plusieurs mots. Pour rechercher plusieurs mots dans le tableau, tapez les mots séparés par un espace. Out-GridViewaffiche les lignes qui incluent tous les mots (AND logique).

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

  • Rechercher dans des 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ésactivez la recherche. Pour afficher à nouveau l’intégralité du tableau, cliquez sur le bouton X rouge dans le coin supérieur droit de la zone Filtre ou supprimez le texte de la zone Filtre .

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 le tableau. 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 de 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 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 des 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 en regard de chaque critère.
  • Pour supprimer tous les critères, cliquez sur le bouton Effacer tout .