Delen via

Out-GridView

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee verzendt u uitvoer 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

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 Server Core-installaties van Windows Server.

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

  • Kolommen verbergen, weergeven en opnieuw ordenen: als u een kolom wilt verbergen, weergeven of de volgorde wilt wijzigen, klikt u met de rechtermuisknop op een kolomkop en klikt u vervolgens op Kolommen selecteren.
  • Sorteren. Als u de gegevens wilt sorteren, klikt u op een kolomkop. Klik nogmaals om van oplopend naar aflopend te schakelen.
  • Snel filter. Gebruik het vak Filter boven aan het venster om de tekst in de tabel te doorzoeken. U kunt zoeken naar tekst in een bepaalde kolom, naar letterlijke waarden zoeken en naar meerdere woorden zoeken.
  • Criteriafilter. Gebruik de vervolgkeuzelijst Criteria toevoegen om regels te maken om de gegevens te filteren. Dit is erg handig voor zeer grote gegevenssets, zoals gebeurtenislogboeken.
  • Kopiëren en plakken. Als u rijen met gegevens uit Out-GridView wilt kopiëren, drukt u op Ctrl+C (kopiëren). U kunt de gegevens in elk tekst- of spreadsheetprogramma plakken.

Voor instructies voor het gebruik van deze functies typt Get-Help Out-GridView -Full en raadpleegt u Functies van het rasterweergavevenster gebruiken in de sectie Notities.

Voorbeelden

Voorbeeld 1: Processen uitvoeren naar een rasterweergave

PS C:\> Get-Process | Out-GridView

Met deze opdracht worden de processen die op de lokale computer worden uitgevoerd, ophaalt en naar een rasterweergavevenster verzonden.

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

PS C:\> $P = Get-Process
PS C:\> $P | Out-GridView

Met deze opdracht worden ook de processen die op de lokale computer worden uitgevoerd, ophaalt en naar een rasterweergavevenster verzonden.

De eerste opdracht maakt gebruik van de cmdlet Get-Process om de processen op de computer op te halen en slaat vervolgens de procesobjecten op in de $P variabele.

De tweede opdracht maakt gebruik van een pijplijnoperator om de variabele $P naar Out-GridView te verzenden.

Voorbeeld 3: een opgemaakte tabel weergeven in een rasterweergave

PS C:\> Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet | Sort-Object -Property WorkingSet -Descending | Out-GridView

Met deze opdracht wordt een opgemaakte tabel weergegeven in een rasterweergavevenster.

De cmdlet Get-Process wordt gebruikt om de processen op de computer op te halen.

Vervolgens wordt een pijplijnoperator (|) gebruikt om de procesobjecten naar de cmdlet Select-Object te verzenden. De opdracht gebruikt de parameter Property van Select-Object om de eigenschappen Name, WorkingSet en PeakWorkingSet te selecteren die in de tabel moeten worden weergegeven.

Een andere pijplijnoperator verzendt de gefilterde objecten naar de cmdlet Sort-Object, die ze in aflopende volgorde sorteert op de waarde van de eigenschap WorkingSet .

In het laatste deel van de opdracht wordt een pijplijnoperator (|) gebruikt om de opgemaakte tabel naar Out-GridView te verzenden.

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

PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | Out-GridView

Met deze opdracht wordt de uitvoer opgeslagen in een variabele en verzonden naar Out-GridView.

De opdracht maakt gebruik van de cmdlet Get-ChildItem om de bestanden in de Windows PowerShell installatiemap en de bijbehorende submappen op te halen. Het pad naar de installatiemap wordt opgeslagen in de $pshome automatische variabele.

De opdracht gebruikt de toewijzingsoperator (=) om de uitvoer in de variabele $A op te slaan en de pijplijnoperator (|) om de uitvoer naar Out-GridView te verzenden.

De haakjes in de opdracht bepalen de volgorde van de bewerkingen. Als gevolg hiervan wordt de uitvoer van de opdracht Get-ChildItem opgeslagen in de variabele $A voordat deze naar Out-GridView wordt verzonden.

Voorbeeld 5: uitvoerprocessen voor een opgegeven computer naar een rasterweergave

PS C:\> Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

Met deze opdracht worden de processen weergegeven die worden uitgevoerd op de Server01-computer in een rasterweergavevenster.

De opdracht maakt gebruik van ogv, de ingebouwde alias voor de Out-GridView-cmdlet . De opdracht gebruikt de parameter Title om de venstertitel op te geven.

Voorbeeld 6: Uitvoergegevens van externe computers naar een rasterweergave

PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

In dit voorbeeld ziet u de juiste indeling voor het verzenden van gegevens die zijn verzameld van externe computers naar de Out-GridView-cmdlet .

De opdracht gebruikt de cmdlet Invoke-Command om een Get-Culture opdracht uit te voeren op drie externe computers. Er wordt een pijplijnoperator gebruikt om de gegevens te verzenden die worden geretourneerd naar de Out-GridView-cmdlet .

U ziet dat het scriptblok met de opdrachten die extern worden uitgevoerd, de opdracht Out-GridView niet bevat. Als dat zo is, mislukt de opdracht wanneer wordt geprobeerd een rasterweergavevenster te openen op elk van de externe computers.

Voorbeeld 7: meerdere items doorgeven via Out-GridView

PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

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

De opdracht maakt gebruik van de parameter PassThru van Out-GridView, waarmee u meerdere items in de pijplijn kunt verzenden. De parameter PassThru is gelijk aan het gebruik van de waarde Multiple van de parameter OutputMode .

Voorbeeld 8: een Windows-snelkoppeling naar Out-GridView Creatie

PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"

Deze opdracht laat zien hoe u de parameter Wait van Out-GridView gebruikt om een Windows-snelkoppeling naar het venster Out-GridView te maken. Zonder de parameter Wait zou Windows PowerShell afsluiten zodra het venster Out-GridView werd geopend, waardoor het venster Out-GridView bijna onmiddellijk zou worden gesloten.

Parameters

-InputObject

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

Wanneer u de parameter InputObject gebruikt om een verzameling objecten naar Out-GridView te verzenden, behandelt Out-GridView 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 Out-GridView te verzenden.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 vanuit het interactieve venster in de pijplijn wilt verzenden, klikt u om de items te selecteren en klikt u vervolgens op OK.

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

  • Geen. Geen items. Dit is de standaardwaarde.
  • Één. Nul items of één item. Gebruik deze waarde wanneer de volgende opdracht slechts één invoerobject kan nemen.
  • Meerdere. Nul, één of veel items. Gebruik deze waarde wanneer de volgende opdracht meerdere invoerobjecten kan nemen. Deze waarde is gelijk aan de parameter Passthru .

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:OutputModeOption
Accepted values:None, Single, Multiple
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Geeft aan dat de cmdlet items vanuit het interactieve venster in de pijplijn als invoer verzendt 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 vanuit het interactieve venster in de pijplijn wilt verzenden, klikt u om de items te selecteren en klikt u vervolgens op OK. Shift-klikken en Ctrl-klikken worden ondersteund.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Title

Hiermee geeft u de tekst op die wordt weergegeven in de titelbalk van het venster Out-GridView .

Op de titelbalk wordt standaard de opdracht weergegeven die Out-GridView aanroept.

Type:String
Position:Named
Default value:None
Required:False
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 venster Out-GridView wordt gesloten. Standaard wordt de opdrachtprompt geretourneerd wanneer het venster Out-GridView wordt geopend.

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

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSObject

U kunt elk object naar deze cmdlet verzenden.

Uitvoerwaarden

None

Out-GridView retourneert geen objecten.

Notities

  • In Windows PowerShell 2.0 wordt de Out-GridView-cmdlet standaard geïnstalleerd op clientversies van Windows, maar het is een optionele functie in serverversies van Windows. In Windows PowerShell 3.0 wordt het standaard op alle systemen geïnstalleerd. Als u echter de Windows PowerShell ISE-functie uitschakelt of verwijdert, wordt de Out-GridView-cmdlet ook uitgeschakeld of verwijderd.

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

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

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

  • Sneltoetsen voor Out-GridView

    Met behulp van de volgende sneltoetsen kunt u veel taken snel uitvoeren.

    Gebruik deze sleutel: voer deze actie uit:

    Met Tab verplaatst u de cursor van het vak Filter naar het menu Criteria toevoegen aan de tabel en terug.

    Pijl-omhoog Eén rij omhoog gaan. Wordt verplaatst naar kolomkoppen.

    Pijl-omlaag Eén rij omlaag gaan.

    Pijl-links In de kolomkoprij één kolom naar links gaan.

    Pijl-rechts Ga één kolom in de rij met kolomkoppen naar rechts.

    CONTEXTMENU SLEUTEL In de kolomkoprij wordt de optie Kolommen selecteren weergegeven.

    ENTER of SPATIEBALK Sorteer kolomgegevens in de kolomkoprij (wisselknop A-Z, Z-A).

    Functies van het rasterweergavevenster gebruiken

    In de volgende onderwerpen wordt uitgelegd hoe u de functies gebruikt van het venster dat Out-GridView weergeeft.

    Kolommen verbergen, weergeven en opnieuw ordenen

    Een kolom verbergen of weergeven:

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 Geselecteerde kolommen worden weergegeven in het rasterweergavevenster.

De volgorde van kolommen wijzigen:

  • Sleep de kolom naar de gewenste locatie.

  • Of-

Klik met de rechtermuisknop op een kolomkop en klik op Kolommen selecteren.

2. Gebruik in het dialoogvenster Kolommen selecteren de knoppen Omhoog en Omlaag 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 koptekst klikt, schakelt de sorteervolgorde tussen oplopend naar aflopend. De huidige volgorde wordt aangegeven met een driehoek in de kolomkop.

Tabelgegevens selecteren

  • Als u een rij wilt selecteren, klikt u op 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 niet de hele kolomkoprij 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 elk tekst- of spreadsheetprogramma plakken. U kunt geen kolommen of delen van rijen kopiëren en u kunt de kolomkoprij niet kopiëren.

Search in de tabel (snel filter)

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.

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

  • Search voor 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 bevatten (logische AND).

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

  • Search 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 met 'Net' wilt zoeken in de kolommen DisplayName en Name, typt u in het vak Filter:

displayname:net name:net

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

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:

<kolomoperatorwaarde><><>

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

De criteria zijn alleen van invloed op de weergave. Er worden geen items uit de tabel 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 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 waarde van de blauwe operator en klikt u vervolgens om een andere operator in de vervolgkeuzelijst te selecteren.

  • Als u een waarde wilt invoeren of wijzigen, typt u een waarde in het waardevak. Als u een ongeldige waarde invoert, wordt 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.