Feedback

Out-GridView

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee wordt uitvoer verzonden naar een interactieve tabel in een afzonderlijk venster.

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

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 voor deze cmdlet een gebruikersinterface is 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 module GraphicalTools 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 naar een rasterweergave uit te voeren

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. Dan, $P wordt 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 van Get-Process wordt 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 PowerShell-installatiemap 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 wordt verzonden naar Out-GridView.

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"

De examle gebruikt ogv, wat de alias is voor de Out-GridView cmdlet. Met de parameter Titel wordt de titel van het venster opgegeven.

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 zo is, 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-parameterOut-GridView kunt u meerdere items naar beneden verzenden in de pijplijn. De PassThru-parameter is gelijk aan het gebruik van de meervoudige waarde van de parameter OutputMode .

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

In dit voorbeeld ziet u hoe u de parameter Wait gebruikt om Out-GridView 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 werd 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 er één rij weergegeven die de verzameling vertegenwoordigt. Als u elk object in de verzameling wilt weergeven, gebruikt u een pijplijnoperator (|) om objecten naar te Out-GridViewverzenden.

Type:PSObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-OutputMode

Hiermee geeft u de items op die door het interactieve venster als invoer naar de pijplijn worden verzonden als invoer naar andere opdrachten. 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 klikt u vervolgens op OK.

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

  • 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 .
Type:OutputModeOption
Accepted values:None, Single, Multiple
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Hiermee wordt aangegeven 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 meervoudige waarde van de parameter OutputMode .

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

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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 aangeroepen Out-GridView.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Wait

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

Met deze functie kunt u de Out-GridView cmdlets in Windows-sneltoetsen 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
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSObject

U kunt elk object naar deze cmdlet verzenden.

Uitvoerwaarden

None

Normaal gesproken Out-GridView worden er geen objecten geretourneerd. Wanneer u de parameter PassThru gebruikt, worden de objecten die de geselecteerde rijen vertegenwoordigen, geretourneerd naar de pijplijn.

Notities

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 voorOut-GridView

Gebruik deze sleutel: Ga als volgt te werk om deze actie uit te voeren:
TAB-toets 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 uit de eerste rij met gegevens.
DownArrow Eén rij omlaag gaan.
LeftArrow Verplaats in de rij van de kolomkop één kolom naar links.
RightArrow Ga in de rij met kolomkoppen naar rechts één kolom.
ContextMenuKey In kolomkoprij wordt de optie Kolommen selecteren weergegeven.
Enter of spatiebalk Sorteer kolomgegevens in kolomkoppen (wissel A-Z, Z-A).

De functies van het venster Rasterweergave 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 oplopende tot aflopende volgorde. 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 (met uitzondering van de veldnamenrij) wilt selecteren, 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 filtervak om te zoeken naar gegevens in de tabel. Wanneer u in het vak typt, worden alleen items met de getypte tekst weergegeven in de tabel.

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

  • 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 met alle woorden (logische AND).

  • 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. Gebruik de volgende indeling om te zoeken naar tekst in een of meer kolommen:

    <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 filtervak:

    displayname:net name:net

  • Zoekactie uitschakelen. 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 instelt. 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 .