Partager via

Out-GridView

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

Envoie la sortie à une table interactive dans une fenêtre distincte.

Syntaxe

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 de commande Out-GridView envoie la sortie d’une commande à une fenêtre d’affichage grille dans laquelle la sortie s’affiche 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.

Note

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 GraphiqueTools 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 de commande Get-Process est enregistrée dans la variable $P. 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 de Get-Process est redirigée vers Select-Object pour sélectionner les propriétés Name, WorkingSetet PeakWorkingSet. Un autre opérateur de pipeline envoie les objets filtrés à l’applet de commande pour les trier dans l’ordre 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 désormais utiliser les fonctionnalités de l’affichage grille pour rechercher, trier et 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 variable automatique $PSHOME. Les parenthèses dans la commande établissent l’ordre des opérations. Par conséquent, la sortie de la commande Get-ChildItem est enregistrée dans la variable $A avant d’être envoyée à 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’examen utilise ogv, qui est l’alias de l’applet de commande Out-GridView. 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 commande Out-GridView. Si c’est le cas, la commande échoue lorsqu’elle a essayé d’ouvrir une fenêtre d’affichage 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 fenêtre Out-GridView. Les processus que vous sélectionnez sont passés à la commande Export-Csv et écrits dans le fichier ProcessLog.csv.

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

Le paramètre PassThru de Out-GridView vous permet d’envoyer plusieurs éléments vers le bas du pipeline. Le paramètre passThru est équivalent à l’utilisation de la valeur de multiple du paramètre OutputMode .

Exemple 8 : Créer 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 fenêtre Out-GridView.

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 fenêtre Out-GridView s’ouvre, ce qui ferme presque immédiatement la fenêtre Out-GridView.

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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 aucune sortie. Pour envoyer des éléments à partir de la fenêtre interactive vers le bas du 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 au pipeline.

  • None. Aucun élément. Il s’agit de la valeur par défaut.
  • Single. Zéro élément ou un élément. Utilisez cette valeur lorsque la commande suivante ne peut prendre qu’un seul objet d’entrée.
  • Multiple. Zéro, un ou plusieurs éléments. Utilisez cette valeur lorsque la commande suivante peut prendre plusieurs objets d’entrée. Cette valeur équivaut au paramètre passthru .
Type:OutputModeOption
Valeurs acceptées:None, Single, Multiple
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 aucune sortie. Ce paramètre équivaut à utiliser la valeur de multiple du paramètre OutputMode .

Pour envoyer des éléments à partir de la fenêtre interactive vers le bas du pipeline, cliquez pour sélectionner les éléments, puis cliquez sur OK. Maj-click et Ctrl-click sont pris en charge.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Title

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 fenêtre Out-GridView soit fermée. Par défaut, l’invite de commandes retourne lorsque la fenêtre Out-GridView s’ouvre.

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

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSObject

Vous pouvez envoyer n’importe quel objet à cette applet de commande.

Sorties

None

Normalement, Out-GridView ne retourne aucun objet. Lors de l’utilisation du paramètre PassThru, les objets représentant les lignes sélectionnées sont retournés au pipeline.

Notes

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 grille sur un autre ordinateur.

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

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

raccourcis clavier pourOut-GridView

Utilisez cette clé : Pour effectuer cette action :
Tab Déplace le curseur de la zone de 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.
Entrer 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 dans 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 le Monter et descendre boutons pour réorganiser les colonnes. Les colonnes situées en haut de la liste apparaissent à gauche des colonnes situées en bas de la liste dans la fenêtre d’affichage 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 entre l’ordre croissant et décroissant. L’ordre actuel 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 maj touche tout en cliquant sur les lignes ou en utilisant les touches de direction.
  • Pour sélectionner des lignes non conformes, appuyez sur la touche Ctrl , puis cliquez pour ajouter une ligne à la sélection.
  • Vous ne pouvez pas sélectionner de colonnes et vous ne pouvez pas sélectionner la ligne d’en-tête de 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 texte ou programme de feuille de calcul. Vous ne pouvez pas copier des colonnes ou des parties de lignes et vous ne pouvez pas copier la ligne d’en-tête de colonne.

Comment effectuer une recherche dans la table (filtre rapide)

Utilisez la zone Filtre pour rechercher des données dans la table. Lorsque vous tapez dans la zone, seuls les éléments qui incluent le texte typé 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 des espaces. Out-GridView affiche les lignes qui incluent tous les mots (logique ET).

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

  • Rechercher dans des colonnes. Pour rechercher du 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 de filtre , tapez :

    displayname:net

    Pour rechercher des lignes avec « Net » dans l' DisplayName et les colonnes 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 Filtrer ou supprimez le texte de la zone filtre .

utiliser des critères pour filtrer la table

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 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. Elle ne supprime pas les éléments du tableau.

Comment ajouter des critères

  1. Pour afficher l'Ajouter des critères bouton de menu, dans le coin supérieur droit de la fenêtre, cliquez sur la flèche Développer.
  2. Cliquez sur le bouton de menu Ajouter des critères.
  3. Cliquez pour sélectionner des 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 non valide, une icône X circulaire s’affiche. Pour le supprimer, modifiez la valeur.
  • 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.