Delen via

Out-GridView

  • Referentie
Module:
Microsoft.PowerShell.Utility

Verzendt uitvoer naar een interactieve tabel in een afzonderlijk venster.

Syntaxis

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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Out-GridView cmdlet verzendt de uitvoer van een opdracht naar een rasterweergavevenster waarin de uitvoer wordt weergegeven in een interactieve tabel.

Omdat deze cmdlet een gebruikersinterface vereist, werkt deze niet op Windows Server Core of Windows Nano Server.

U kunt de volgende functies van de tabel gebruiken om uw gegevens te onderzoeken:

  • Kolommen verbergen, weergeven en opnieuw ordenen
  • Rijen sorteren
  • Snelfilter
  • Criteriafilter toevoegen
  • Kopiëren en plakken

Zie de sectie Notities van dit artikel voor volledige instructies.

Notitie

Deze cmdlet is opnieuw geïntroduceerd in PowerShell 7. Deze cmdlet is alleen beschikbaar op Windows-systemen die ondersteuning bieden voor het Windows-bureaublad. Zie de ConsoleGuiTools-module in de PowerShell Gallery voor een platformoverschrijdende versie van deze cmdlet.

Voorbeelden

Voorbeeld 1: Uitvoerprocessen naar een rasterweergave

In dit voorbeeld worden de processen op de lokale computer uitgevoerd en verzonden naar een rasterweergavevenster.

Get-Process | Out-GridView

Voorbeeld 2: Een variabele gebruiken om processen uit te voeren naar een rasterweergave

In dit voorbeeld worden ook de processen op de lokale computer uitgevoerd en verzonden naar een rasterweergavevenster.

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

De uitvoer van de Get-Process cmdlet wordt opgeslagen in de $P variabele. Vervolgens wordt $P doorgesluisd naar Out-GridView.

Voorbeeld 3: Geselecteerde eigenschappen weergeven in een rasterweergave

In dit voorbeeld worden geselecteerde eigenschappen van de actieve processen weergegeven in een rasterweergave.

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

De uitvoer wordt Get-Process doorgesluisd om de eigenschappen Name, WorkingSet en PeakWorkingSet te Select-Object selecteren. Een andere pijplijnoperator verzendt de gefilterde objecten naar de Sort-Object cmdlet om ze in aflopende volgorde te sorteren op de waarde van de eigenschap WorkingSet . Vervolgens worden de gesorteerde resultaten doorgesluisd naar Out-GridView. U kunt nu de functies van de rasterweergave gebruiken om de gegevens te zoeken, te sorteren en te filteren.

Voorbeeld 4: Uitvoer opslaan in een variabele en vervolgens een rasterweergave uitvoeren

In dit voorbeeld wordt cmdlet-uitvoer in een variabele opgeslagen en vervolgens verzonden naar Out-GridView.

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

Get-ChildItem haalt alle bestanden in de Installatiemap van PowerShell en de bijbehorende submappen op met behulp van de $PSHOME automatische variabele. De haakjes in de opdracht bepalen de volgorde van bewerkingen. Als gevolg hiervan wordt de uitvoer van de Get-ChildItem opdracht opgeslagen in de $A variabele voordat deze naartoe Out-GridViewwordt verzonden.

Voorbeeld 5: Uitvoerprocessen voor een opgegeven computer naar een rasterweergave

In dit voorbeeld worden de processen weergegeven die worden uitgevoerd op de Server01-computer in een rasterweergavevenster.

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

In het voorbeeld wordt gebruikgemaakt ogvvan de alias voor de Out-GridView cmdlet. Met de parameter Titel geeft u de venstertitel op.

Voorbeeld 6: Uitvoergegevens van externe computers naar een rasterweergave

In dit voorbeeld ziet u hoe u gegevens verzendt die zijn verzameld van externe computers naar Out-GridView.

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

Invoke-Command wordt uitgevoerd Get-Culture op drie externe computers. De resulterende gegevens worden doorgesluisd naar Out-GridView. U ziet dat het scriptblok dat wordt uitgevoerd op de externe computer niet de Out-GridView opdracht bevat. Als dat het gebeurt, mislukt de opdracht wanneer wordt geprobeerd een rasterweergavevenster op elk van de externe computers te openen.

Voorbeeld 7: Meerdere items doorgeven via Out-GridView

In dit voorbeeld kunt u meerdere processen selecteren in het Out-GridView venster. De processen die u selecteert, worden doorgegeven aan de Export-Csv opdracht en naar het ProcessLog.csv bestand geschreven.

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

Met de passThru-parameter Out-GridView kunt u meerdere items in de pijplijn verzenden. De parameter PassThru is gelijk aan het gebruik van de parameter Multiple van de parameter OutputMode .

Voorbeeld 8: Een Windows-snelkoppeling maken naar Out-GridView

In dit voorbeeld ziet u hoe u de wachtparameter Out-GridView gebruikt om een Windows-snelkoppeling naar het Out-GridView venster te maken.

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

Deze opdrachtregel kan worden gebruikt in een Windows-snelkoppeling. Zonder de parameter Wait zou PowerShell worden afgesloten zodra het Out-GridView venster werd geopend, waardoor het Out-GridView venster bijna onmiddellijk zou worden gesloten.

Parameters

-InputObject

Hiermee geeft u het object op dat de cmdlet accepteert als invoer voor Out-GridView.

Wanneer u de parameter InputObject gebruikt om een verzameling objecten naar te Out-GridViewverzenden, Out-GridView behandelt u de verzameling als één verzamelingsobject en wordt één rij weergegeven die de verzameling vertegenwoordigt. Als u het object in de verzameling wilt weergeven, gebruikt u een pijplijnoperator (|) om objecten naar te Out-GridViewverzenden.

Type:PSObject
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-OutputMode

Hiermee geeft u de items op die het interactieve venster de pijplijn als invoer naar andere opdrachten verzendt. Deze cmdlet genereert standaard geen uitvoer. Als u items wilt verzenden vanuit het interactieve venster in de pijplijn, klikt u om de items te selecteren en vervolgens op OK te klikken.

De waarden van deze parameter bepalen hoeveel items u in de pijplijn kunt verzenden.

  • None. Geen items. Dit is de standaardwaarde.
  • Single. Nul items of één item. Gebruik deze waarde wanneer met de volgende opdracht slechts één invoerobject kan worden gebruikt.
  • Multiple. Nul, één of veel items. Gebruik deze waarde wanneer met de volgende opdracht meerdere invoerobjecten kunnen worden gebruikt. Deze waarde is gelijk aan de parameter PassThru .

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:OutputModeOption
Geaccepteerde waarden:None, Single, Multiple
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Geeft aan dat de cmdlet items vanuit het interactieve venster naar beneden in de pijplijn verzendt als invoer naar andere opdrachten. Deze cmdlet genereert standaard geen uitvoer. Deze parameter is gelijk aan het gebruik van de waarde Multiple van de parameter OutputMode .

Als u items wilt verzenden vanuit het interactieve venster in de pijplijn, klikt u om de items te selecteren en vervolgens op OK te klikken. Shift-klikken en Ctrl-klikken worden ondersteund.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Title

Hiermee geeft u de tekst op die wordt weergegeven op de titelbalk van het Out-GridView venster. Op de titelbalk wordt standaard de opdracht weergegeven die wordt Out-GridViewaangeroepen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Wait

Geeft aan dat de cmdlet de opdrachtprompt onderdrukt en voorkomt dat Windows PowerShell wordt gesloten totdat het Out-GridView venster is gesloten. Standaard wordt de opdrachtprompt geretourneerd wanneer het Out-GridView venster wordt geopend.

Met deze functie kunt u de Out-GridView cmdlets in Windows-snelkoppelingen gebruiken. Wanneer Out-GridView het venster wordt gebruikt in een snelkoppeling zonder de parameter Wait , wordt het Out-GridView venster alleen tijdelijk weergegeven voordat PowerShell wordt gesloten.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSObject

U kunt elk object doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

PSObject

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet objecten die de geselecteerde rijen vertegenwoordigen.

Notities

PowerShell bevat de volgende aliassen voor Out-GridView:

  • Windows:
    • ogv

Deze cmdlet is alleen beschikbaar op Windows-platforms. Deze cmdlet is alleen beschikbaar op Windows-platforms.

U kunt geen externe opdracht gebruiken om een rasterweergavevenster op een andere computer te openen.

De uitvoer van de opdracht waarnaar u verzendt Out-GridView , kan niet worden opgemaakt met behulp van de Format cmdlets, zoals Format-Table of Format-Wide cmdlets. Gebruik de Select-Object cmdlet om eigenschappen te selecteren.

Gedeserialiseerde uitvoer van externe opdrachten is mogelijk niet correct opgemaakt in het rasterweergavevenster.

Sneltoetsen voor Out-GridView

Gebruik deze sleutel: Ga als volgt te werk om deze actie uit te voeren:
Tab Hiermee verplaatst u de cursor van het filtervak naar het menu Criteria toevoegen naar de tabel en terug.
UpArrow Eén rij omhoog gaan. Hiermee gaat u naar kolomkoppen van de eerste rij met gegevens.
DownArrow Eén rij omlaag gaan.
LeftArrow Ga in de rij met kolomkoppen naar links één kolom.
RightArrow Ga in de rij met kolomkoppen naar rechts één kolom.
ContextMenuKey In de rij kolomkoppen wordt de optie Kolommen selecteren weergegeven.
Enter of spatiebalk Sorteer kolomgegevens in de kolomkoprij (wissel A-Z, Z-A).

De functies van het rasterweergavevenster gebruiken

Een kolom verbergen of weergeven:

  1. Klik met de rechtermuisknop op een kolomkop en klik op Kolommen selecteren.
  2. Gebruik in het dialoogvenster Kolommen selecteren de pijltoetsen om de kolommen tussen de geselecteerde kolommen te verplaatsen naar de vakken Beschikbare kolommen. Alleen kolommen in het vak Kolommen selecteren worden weergegeven in het rasterweergavevenster.

Kolommen opnieuw ordenen:

U kunt kolommen naar de gewenste locatie slepen en neerzetten. Of gebruik de volgende stappen:

  1. Klik met de rechtermuisknop op een kolomkop en klik op Kolommen selecteren.
  2. Gebruik in het dialoogvenster Kolommen selecteren de knoppen Omhoog en Omlaag verplaatsen om de volgorde van de kolommen te wijzigen. Kolommen boven aan de lijst worden links van kolommen onder aan de lijst weergegeven in het rasterweergavevenster.

Tabelgegevens sorteren

  • Als u de gegevens wilt sorteren, klikt u op een kolomkop.
  • Als u de sorteervolgorde wilt wijzigen, klikt u nogmaals op de kolomkop. Telkens wanneer u op dezelfde kop klikt, schakelt de sorteervolgorde tussen oplopend tot aflopend. De huidige volgorde wordt aangegeven met een driehoek in de kolomkop.

Tabelgegevens selecteren

  • Als u een rij wilt selecteren, selecteert u de rij of gebruikt u de pijl-omhoog of pijl-omlaag om naar de rij te navigeren.
  • Als u alle rijen wilt selecteren (met uitzondering van de veldnamenrij), drukt u op Ctrl+A.
  • Als u opeenvolgende rijen wilt selecteren, houdt u Shift ingedrukt terwijl u op de rijen klikt of de pijltoetsen gebruikt.
  • Als u niet-aangrenzende rijen wilt selecteren, drukt u op Ctrl en klikt u om een rij aan de selectie toe te voegen.
  • U kunt geen kolommen selecteren en u kunt de hele kolomkoprij niet selecteren.

Rijen kopiëren

  • Als u een of meer rijen uit de tabel wilt kopiëren, selecteert u de rijen en drukt u op Ctrl+C.

    U kunt de gegevens in een tekst- of spreadsheetprogramma plakken. U kunt geen kolommen of delen van rijen kopiëren en u kunt de kolomkoprij niet kopiëren.

Zoeken in de tabel (snelfilter)

Gebruik het vak Filter om te zoeken naar gegevens in de tabel. Wanneer u in het vak typt, worden alleen items met de getypte tekst in de tabel weergegeven.

  • Zoeken naar tekst. Als u wilt zoeken naar tekst in de tabel, typt u in het vak Filter de tekst die u wilt zoeken.

  • Zoek naar meerdere woorden. Als u wilt zoeken naar meerdere woorden in de tabel, typt u de woorden gescheiden door spaties. Out-GridView geeft rijen weer die alle woorden (logische AND) bevatten.

  • Zoek naar letterlijke woordgroepen. Als u wilt zoeken naar woordgroepen met spaties of speciale tekens, plaatst u de woordgroep tussen aanhalingstekens. Out-GridView geeft rijen weer die een exacte overeenkomst bevatten voor de woordgroep.

  • Zoeken in kolommen. Als u wilt zoeken naar tekst in een of meer kolommen, gebruikt u de volgende indeling:

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

    Als u bijvoorbeeld 'Net' wilt zoeken in de kolom DisplayName , typt u in het vak Filter :

    displayname:net

    Als u rijen wilt zoeken met 'Net' in de kolommen DisplayName en Naam , typt u in het vak Filter :

    displayname:net name:net

  • Schakel de zoekfunctie uit. Als u de hele tabel opnieuw wilt weergeven, klikt u op de rode X-knop in de rechterbovenhoek van het filtervak of verwijdert u de tekst uit het filtervak.

Criteria gebruiken om de tabel te filteren

U kunt regels of criteria gebruiken om te bepalen welke items in de tabel worden weergegeven. Items worden alleen weergegeven wanneer ze voldoen aan alle criteria die u tot stand brengt. De beschikbare criteria worden bepaald door de eigenschappen van de objecten die worden weergegeven in het rasterweergavevenster en de .NET Framework-typen van deze eigenschappen.

Elk criterium heeft de volgende indeling:

<column> <operator> <value>

Criteria voor verschillende eigenschappen zijn verbonden door AND. Criteria voor dezelfde eigenschap zijn verbonden door OR. U kunt de logische connectors niet wijzigen.

De criteria zijn alleen van invloed op de weergave. Items uit de tabel worden niet verwijderd.

Criteria toevoegen

  1. Als u de menuknop Criteria toevoegen wilt weergeven, klikt u in de rechterbovenhoek van het venster op de pijl Uitvouwen.
  2. Klik op de menuknop Criteria toevoegen.
  3. Klik hier om kolommen (eigenschappen) te selecteren. U kunt een of meer eigenschappen selecteren.
  4. Wanneer u klaar bent met het selecteren van eigenschappen, klikt u op de knop Toevoegen .
  5. Als u de toevoegingen wilt annuleren, klikt u op Annuleren.
  6. Als u meer criteria wilt toevoegen, klikt u nogmaals op de knop Criteria toevoegen.

Een criterium bewerken

  • Als u een operator wilt wijzigen, klikt u op de blauwe operatorwaarde en selecteert u een andere operator in de vervolgkeuzelijst.
  • Als u een waarde wilt invoeren of wijzigen, typt u een waarde in het waardevak. Als u een ongeldige waarde invoert, wordt er een cirkelvormig X-pictogram weergegeven. Als u deze wilt verwijderen, wijzigt u de waarde.
  • Als u een OR-instructie wilt maken, voegt u een criterium met dezelfde eigenschap toe.

Criteria verwijderen

  • Als u geselecteerde criteria wilt verwijderen, klikt u op de rode X naast elk criterium.
  • Als u alle criteria wilt verwijderen, klikt u op de knop Alles wissen.