Out-GridView
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
La cmdlet Out-GridView envoie la sortie d’une commande à une fenêtre d’affichage grille dans laquelle 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 les installations minimales de Windows Server.
Vous pouvez utiliser les fonctionnalités suivantes du tableau pour examiner vos données :
- Masquer, afficher et réorganiser les colonnes : pour masquer, afficher ou réorganiser une colonne, cliquez avec le bouton droit sur un en-tête de colonne, puis cliquez sur Sélectionner des colonnes.
- Trier. Pour trier les données, cliquez sur un en-tête de colonne. Cliquez à nouveau pour basculer de l’ordre croissant vers l’ordre décroissant.
- Filtre rapide. Utilisez la zone Filtre en haut de la fenêtre pour rechercher le texte dans le tableau. Vous pouvez rechercher du texte dans une colonne particulière, rechercher des littéraux et rechercher plusieurs mots.
- Filtre de critères. Utilisez le menu déroulant Ajouter des critères pour créer des règles pour filtrer les données. Cela est très utile pour les jeux de données très volumineux, tels que les journaux d’événements.
- Copiez et collez. Pour copier des lignes de données à partir de Out-GridView, appuyez sur Ctrl+C (copier). Vous pouvez coller les données dans n’importe quel texte ou programme de feuille de calcul.
Pour obtenir des instructions sur l’utilisation de ces fonctionnalités, tapez Get-Help Out-GridView -Full et consultez Comment utiliser les fonctionnalités de la fenêtre Affichage grille dans la section Notes.
Exemples
Exemple 1 : Processus de sortie vers une vue de grille
PS C:\> Get-Process | Out-GridViewCette commande obtient les processus en cours d’exécution sur l’ordinateur local et les envoie à une fenêtre d’affichage de grille.
Exemple 2 : Utiliser une variable pour générer des processus en mode grille
PS C:\> $P = Get-Process
PS C:\> $P | Out-GridViewCette commande obtient également les processus en cours d’exécution sur l’ordinateur local et les envoie à une fenêtre d’affichage de grille.
La première commande utilise l’applet de commande Get-Process pour obtenir les processus sur l’ordinateur, puis enregistre les objets de processus dans la variable $P.
La deuxième commande utilise un opérateur de pipeline pour envoyer la variable $P à Out-GridView.
Exemple 3 : Afficher un tableau mis en forme en mode grille
PS C:\> Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet | Sort-Object -Property WorkingSet -Descending | Out-GridViewCette commande affiche une table mise en forme dans une fenêtre d’affichage grille.
Il utilise l’applet de commande Get-Process pour obtenir les processus sur l’ordinateur.
Ensuite, il utilise un opérateur de pipeline (|) pour envoyer les objets de processus à l’applet de commande Select-Object. La commande utilise le paramètre Property de Select-Object pour sélectionner les propriétés Name, WorkingSet et PeakWorkingSet à afficher dans le tableau.
Un autre opérateur de pipeline envoie les objets filtrés à l’applet de commande Sort-Object, qui les trie dans l’ordre décroissant en fonction de la valeur de la propriété WorkingSet.
La dernière partie de la commande utilise un opérateur de pipeline (|) pour envoyer la table mise en forme à 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
PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | Out-GridViewCette commande enregistre sa sortie dans une variable et l’envoie à Out-GridView.
La commande utilise l’applet de commande Get-ChildItem pour obtenir les fichiers dans le répertoire d’installation de Windows PowerShell et ses sous-répertoires. Le chemin d’accès au répertoire d’installation est enregistré dans la variable automatique $pshome.
La commande utilise l’opérateur d’affectation (=) pour enregistrer la sortie dans la variable $A et l’opérateur de pipeline (|) pour envoyer la sortie à Out-GridView.
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
PS C:\> Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"Cette commande affiche les processus en cours d’exécution sur l’ordinateur Server01 dans une fenêtre d’affichage grille.
La commande utilise
Exemple 6 : Sortie des données des ordinateurs distants vers une vue grille
PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridViewCet exemple montre le format approprié pour l’envoi de données collectées à partir d’ordinateurs distants à l’applet de commande Out-GridView
La commande utilise l’applet de commande Invoke-Command pour exécuter une commande Get-Culture sur trois ordinateurs distants.
Il utilise un opérateur de pipeline pour envoyer les données retournées à l’applet de commande Out-GridView
Notez que le bloc de script qui contient les commandes exécutées à distance 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
PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csvCette commande 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.
La commande utilise le paramètre PassThru de Out-GridView, ce qui vous permet d’envoyer 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 pour Out-GridView
PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"Cette commande montre comment utiliser le paramètre
Paramètres
-InputObject
Spécifie que l’applet de commande accepte l’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.
- Aucun. Aucun élément. Il s’agit de la valeur par défaut.
- Célibataire. 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
.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| 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 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.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| 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 Windows PowerShell.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Vous pouvez envoyer n’importe quel objet à cette applet de commande.
Sorties
None
Out-GridView ne retourne aucun objet.
Notes
Dans Windows PowerShell 2.0, l’applet de commande Out-GridView est installée par défaut sur les versions clientes de Windows, mais est une fonctionnalité facultative sur les versions de Windows. Dans Windows PowerShell 3.0, il est installé sur tous les systèmes par défaut. Toutefois, si vous désactivez ou supprimez la fonctionnalité Windows PowerShell ISE, l’applet de commande Out-GridView
est également désactivée ou supprimée. 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, par exemple à l’aide des applets de commande Format-Table ou 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 pour Out-GridView
En utilisant les raccourcis clavier suivants, vous pouvez effectuer de nombreuses tâches rapidement.
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.
Flèche vers le haut vers le haut d’une ligne. Se déplace vers les en-têtes de colonne.
Flèche vers le bas Déplacer vers le bas d’une ligne.
FLÈCHE GAUCHE Dans la ligne d’en-tête de colonne, déplacez-la vers la gauche d’une colonne.
FLÈCHE DROITE Dans la ligne d’en-tête de colonne, déplacez-la vers la droite d’une colonne.
CONTEXT MENU KEY Dans la ligne d’en-tête de colonne, affiche l’option Sélectionner des colonnes.
ENTRÉE ou SPACEBAR Dans la ligne d’en-tête de colonne, triez les données de colonne (basculeZ A-Z, Z-A).
Comment utiliser les fonctionnalités de la fenêtre d’affichage grille
Les rubriques suivantes expliquent comment utiliser les fonctionnalités de la fenêtre qui Out-GridView s’affiche.
Comment masquer, afficher et réorganiser des colonnes
Pour masquer ou afficher une colonne :
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 Colonnes sélectionnées apparaissent dans la fenêtre d’affichage grille.
Pour réorganiser les colonnes :
Faites glisser et déposez la colonne à l’emplacement souhaité.
ou-
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 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, cliquez sur la ligne ou utilisez la flèche haut ou 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 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 le tableau (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 des lignes qui incluent tous les mots (AND logique).
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 :
< >de colonne :<> texte [<colonne>:<texte>] ...
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 grille et les types .NET Framework de ces propriétés.
Chaque critère a le format suivant :
<opérateur><><valeur de colonne>
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 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 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 cliquez pour sélectionner 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.