Envoie la sortie vers une table interactive dans une fenêtre distincte.
Syntaxe
Out-GridView [-InputObject <psobject>] [-Title <string>] [<CommonParameters>]
Description
L'applet de commande Out-GridView envoie la sortie d'une commande vers une fenêtre en mode grille dans laquelle elle est affichée dans une table interactive. Cette fonctionnalité requiert Microsoft .NET Framework 3.5 avec le Service Pack 1.
Vous pouvez utiliser les fonctionnalités suivantes de la table 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 de la souris sur un en-tête de colonne, puis cliquez sur « Sélectionner les colonnes ».
-- Trier. Pour trier les données, cliquez sur un en-tête de colonne. Cliquez à nouveau sur cet en-tête pour passer de l'ordre croissant à l'ordre décroissant.
-- Filtre rapide. Utilisez la zone « Filtrer » en haut de la fenêtre pour rechercher le texte dans la table. Vous pouvez rechercher du texte dans une colonne particulière, rechercher des littéraux ou rechercher plusieurs mots.
-- Filtre de critère. Utilisez le menu déroulant « Ajouter un critère » pour créer des règles afin de filtrer les données. Ceci est très utile pour les jeux de données volumineux, tels que les journaux d'événements.
-- Copier et coller. Pour copier des lignes de données à partir de Out-GridView, utilisez la combinaison de touches CTRL+C (pour copier). Vous pouvez coller les données dans n'importe quel programme de traitement de texte ou tableur.
Pour obtenir des instructions sur l'utilisation de ces fonctionnalités, tapez « get-help out-gridview -full » et consultez la rubrique « Comment utiliser les fonctionnalités de la fenêtre en mode grille » de la section REMARQUES.
Paramètres
-InputObject <psobject>
Accepte une entrée pour Out-GridView.
Lorsque vous utilisez le paramètre InputObject pour envoyer une collection d'objets (plusieurs objets) à Out-GridView, Out-GridView traite la collection comme un objet 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 les objets à Out-GridView.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
|
Accepter les caractères génériques ? |
false |
-Title <string>
Spécifie le texte qui s'affiche 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.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
The current command |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
System.Management.Automation.PSObject Vous pouvez envoyer n'importe quel objet à Out-GridView. |
|
Sorties |
Aucun Out-GridView ne retourne aucun objet. |
Remarques
REMARQUES POUR OUT-GRIDVIEW
----------------------
Vous pouvez télécharger Microsoft .NET Framework 3.5 avec le Service Pack 1 à partir du Centre de téléchargement Microsoft.
Étant donné que cette applet de commande nécessite une interface utilisateur, elle ne fonctionne pas dans les installations minimales de Windows Server.
Vous ne pouvez pas utiliser de commande distante pour ouvrir une fenêtre en mode grille sur un ordinateur distant.
La sortie de commande que vous envoyez ne peut pas être préformatée, par exemple en utilisant les 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 des commandes distantes peut ne pas être correctement mise en forme dans la fenêtre en mode grille.
RACCOURCIS CLAVIER POUR OUT-GRIDVIEW
-----------------------------------
En utilisant les raccourcis clavier suivants, vous pouvez effectuer de nombreuses tâches rapidement.
Utilisez cette touche : Pour effectuer cette action :
------------- ----------------------------------------------------------------
TAB Déplace le curseur de la zone Filtre vers le menu Ajouter un critère et vers la table, et inversement.
FLÈCHE HAUT Monte d'une ligne. Accède aux en-têtes de colonne.
FLÈCHE BAS Descend d'une ligne.
FLÈCHE GAUCHE Dans la ligne d'en-tête de colonne, se déplace d'une colonne à gauche.
FLÈCHE DROITE Dans la ligne d'en-tête de colonne, se déplace d'une colonne à droite.
TOUCHE MENU CONTEXTUEL Dans la ligne d'en-tête de colonne, affiche l'option « Sélectionner les colonnes ».
ENTRÉE ou BARRE D'ESPACE Dans la ligne d'en-tête de colonne, trie les données de la colonne (ordre A-Z ou Z-A).
COMMENT UTILISER LES FONCTIONNALITÉS DE LA FENÊTRE EN MODE GRILLE
----------------------------------------
Les rubriques suivantes expliquent comment utiliser les fonctionnalités de la fenêtre affichée par Out-GridView.
Comment masquer, afficher et réorganiser les colonnes
--------------------------------------
Pour masquer ou afficher une colonne :
1. Cliquez avec le bouton droit sur un en-tête de colonne, puis cliquez sur « Sélectionner les colonnes ».
2. Dans la boîte de dialogue « Sélectionner les colonnes », utilisez les touches de direction pour déplacer les colonnes entre les zones « Colonnes sélectionnés » et « Colonnes disponibles ». Seules les colonnes figurant dans la zone « Colonnes sélectionnées » sont affichées dans la fenêtre en mode grille.
Pour réorganiser les colonnes :
-- Glissez-déplacez la colonne à l'emplacement souhaité.
- ou -
1. Cliquez avec le bouton droit sur un en-tête de colonne, puis cliquez sur « Sélectionner les colonnes ».
2. Dans la boîte de dialogue « Sélectionner les colonnes », utilisez les boutons « Monter » et « Descendre » pour réorganiser les colonnes. Les colonnes figurant en haut de la liste s'affichent à gauche des colonnes en bas de liste dans la fenêtre en mode grille.
Comment trier les données de la table
----------------------
-- Pour trier les données, cliquez sur un en-tête de colonne.
-- Pour changer l'ordre de tri, cliquez à nouveau sur l'en-tête de colonne. Chaque fois que vous cliquez sur un même en-tête, l'ordre de tri change entre ordre croissant et ordre décroissant. L'ordre actuel est indiqué par un triangle dans l'en-tête de colonne.
Comment sélectionner des données de la table
------------------------
-- Pour sélectionner une ligne, cliquez dessus ou utilisez la flèche haut ou bas pour l'atteindre.
-- Pour sélectionner toutes les lignes (à l'exception de la ligne d'en-tête), appuyez sur les touches CTRL+A.
-- Pour sélectionner des lignes consécutives, appuyez sur la touche MAJ et maintenez-la enfoncée pendant que vous cliquez sur les lignes souhaitées ou utilisez les touches de direction.
-- Pour sélectionner des lignes non consécutives, appuyez sur la touche CTRL et cliquez sur une ligne pour l'ajouter à la sélection.
Vous ne pouvez pas sélectionner de colonnes, ni la ligne d'en-tête de colonne entière.
Comment copier des lignes
----------------------
-- Pour copier une ou plusieurs lignes de la table, sélectionnez-les puis appuyez sur CTRL+C.
Vous pouvez coller les données dans n'importe quel programme de traitement de texte ou tableur. Vous ne pouvez pas copier de colonnes ou de 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 « Filtrer » pour rechercher des données dans la table. Lorsque vous tapez votre recherche dans la zone, seuls les éléments qui incluent ce texte apparaissent dans la table.
-- Rechercher du texte. Pour rechercher le texte dans la table, tapez le texte souhaité dans la zone « Filtrer ».
-- Rechercher plusieurs mots. Pour rechercher plusieurs mots dans la table, tapez ces mots en les séparant par des espaces. Out-GridView affiche les lignes qui incluent tous les mots (AND logique).
--Rechercher des expressions littérales. Pour rechercher des expressions qui incluent des espaces ou des caractères spéciaux, entourez-les de guillemets. Out-GridView affiche les lignes qui contiennent une correspondance exacte pour l'expression.
--Rechercher dans les colonnes. Pour rechercher du texte dans une ou plusieurs colonnes, utilisez le format suivant :
<colonne>:<texte> [<colonne>:<texte>] ...
Par exemple, pour rechercher « Net » dans la colonne DisplayName, dans la zone « Filtrer », tapez :
displayname:net
Pour rechercher des lignes contenant le mot « Net » dans les colonnes DisplayName et Name, dans la zone « Filtrer », tapez :
displayname:net name:net
-- Arrêter la recherche. Pour afficher à nouveau l'ensemble de la table, cliquez sur le bouton X rouge dans l'angle supérieur droit de la zone « Filtrer » ou supprimez le texte de la zone Filtrer.
Utilisation de critères pour filtrer la table
--------------------------------
Vous pouvez utiliser des règles ou des « critères » pour déterminer les éléments qui sont affichés dans la table. Les éléments apparaissent uniquement lorsqu'ils satisfont à 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 en mode grille et les types .NET Framework de ces propriétés.
Chaque critère a le format suivant :
<colonne> <opérateur> <valeur>
Les critères des différentes propriétés sont reliés par l'intermédiaire de AND. Les critères définis pour la même propriété sont connectés par OU. Vous ne pouvez pas changer les connecteurs logiques.
Le critère affecte uniquement l'affichage. Il ne supprime pas d'éléments de la table.
Comment ajouter un critère
---------------------------
1. Pour afficher le bouton de menu « Ajouter un critère », dans l'angle supérieur droit de la fenêtre, cliquez sur la flèche « Développer ».
2. Cliquez sur le bouton de menu « Ajouter un critère ».
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 plus de critères, cliquez à nouveau sur le bouton Ajouter un critère.
Comment modifier un critère
--------------------
-- Pour changer un opérateur, cliquez sur la valeur d'opérateur bleue, 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 de valeur. Si vous entrez une valeur non valide, une icône X circulaire apparaît. Pour la supprimer, modifiez la valeur.
-- Pour créer une instruction OR, ajoutez un critère avec la même propriété.
Comment supprimer un critère
-------------------------
-- Pour supprimer un critère sélectionné, cliquez sur le X rouge situé à côté du critère concerné.
-- Pour supprimer tous les critères, cliquez sur le bouton « Effacer tout ».
Exemple 1
C:\PS>get-process | out-gridview Description ----------- Cette commande obtient les processus exécutés sur l'ordinateur local et les envoie à une fenêtre en mode grille.
Exemple 2
C:\PS>$p = get-process C:\PS> $p | out-gridview Description ----------- Cette commande obtient également les processus exécutés sur l'ordinateur local et les envoie vers une fenêtre en mode grille. La première commande utilise la commande Get-Process pour obtenir les processus de l'ordinateur, puis enregistre les objets processus dans la variable $p. La deuxième commande utilise un opérateur de pipeline pour envoyer la variable $p à l'applet de commande Out-GridView.
Exemple 3
C:\PS>get-process | select-object -property name, workingset, peakworkingset | sort-object -property workingset -desc | out-gridview Description ----------- Cette commande affiche une table mise en forme dans une fenêtre en mode grille. Elle utilise l'applet de commande Get-Process pour obtenir les processus de l'ordinateur. Elle utilise ensuite un opérateur de pipeline (|) pour envoyer les objets 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 la table. 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 maintenant utiliser les fonctionnalités du mode grille pour rechercher, trier et filtrer des données.
Exemple 4
C:\PS>($a = get-childitem -path $pshome -recurse) | out-gridview Description ----------- Cette commande enregistre sa sortie dans une variable et l'envoie à Out-GridView. Elle utilise l'applet de commande Get-ChildItem pour obtenir les fichiers du répertoire d'installation de Windows PowerShell et de 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 cette sortie à Out-GridView. Les parenthèses de 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
C:\PS>get-process -computername Server01| ogv -title "Processes - Server01" Description ----------- Cette commande affiche les processus s'exécutant sur l'ordinateur Server01 dans une fenêtre en mode grille. Elle utilise « ogv », qui est l'alias intégré de l'applet de commande Out-GridView, et utilise le paramètre Title pour spécifier le titre de la fenêtre.
Exemple 6
C:\PS>invoke-command -ComputerName S1, S2, S3 -scriptblock {get-culture} | out-gridview
Description
-----------
Cet exemple présente le format correct 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. Elle 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 contenant les commandes exécutées à distance n'inclut pas la commande Out-GridView. Si tel était le cas, la commande échouerait lorsqu'elle tenterait d'ouvrir une fenêtre en mode grille sur chacun des ordinateurs distants.