Out-GridView

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>]

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.

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

Get-Process | Out-GridView

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.

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 naar Select-Object om de eigenschappen Name, WorkingSeten PeakWorkingSet te selecteren. Een andere pijplijnoperator verzendt de gefilterde objecten naar de cmdlet Sort-Object 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.

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

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

Get-ChildItem haalt alle bestanden op in de installatiemap van PowerShell en de bijbehorende submappen 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 opdracht Get-ChildItem opgeslagen in de $A variabele voordat deze naar Out-GridViewwordt verzonden.

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 ogvgebruikt. Dit is de alias voor de Out-GridView cmdlet. De parameter Title geeft de titel van het venster op.

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 voert Get-Culture uit 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 opdracht Out-GridView bevat. Als dat het gebeurt, mislukt de opdracht wanneer wordt geprobeerd een rasterweergavevenster op elk van de externe computers te openen.

In dit voorbeeld 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.

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

Met de parameter PassThru van 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.

In dit voorbeeld ziet u hoe u de parameter Wait van 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 wordt PowerShell afgesloten zodra het Out-GridView venster werd geopend, waardoor het Out-GridView venster bijna onmiddellijk zou worden gesloten.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt elk object doorsluisen naar deze cmdlet.

Deze cmdlet retourneert standaard geen uitvoer.

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

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 die u naar Out-GridView verzendt, kan niet worden opgemaakt met behulp van de Format cmdlets, zoals Format-Table of Format-Wide cmdlets. Als u eigenschappen wilt selecteren, gebruikt u de cmdlet Select-Object.

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

sneltoetsen voorOut-GridView

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 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 (met uitzondering van de veldnamenrij) wilt selecteren, drukt u op Ctrl+A.
• Als u opeenvolgende rijen wilt selecteren, houdt u de Shift- ingedrukt terwijl u op de rijen klikt of de pijltoetsen gebruikt.
• Als u niet-aangrenzende rijen wilt selecteren, drukt u op de Ctrl--toets 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 rijen met alle woorden (logische EN) worden weergegeven.

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

• 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 met 'Net' wilt zoeken in de kolommen DisplayName en Name, 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 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 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 worden 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. Items uit de tabel worden niet verwijderd.

Criteria toevoegen

1. Als u de knop Criteria toevoegen menu wilt weergeven, klikt u in de rechterbovenhoek van het venster op de pijl Uitvouwen.
2. Klik op de knop Criteria toevoegen menu.
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 Alle wissen.