Out-GridView
Verzendt 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
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-GridViewVoorbeeld 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-GridViewDe 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-GridViewDe 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-GridViewGet-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-GridViewInvoke-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.csvMet de passThru-parameterOut-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 |
| 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 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 |
| 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 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 |
| Required: | 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 Out-GridViewaangeroepen.
| 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 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Invoerwaarden
U kunt elk object doorsluisen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert standaard geen uitvoer.
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 voorOut-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:
- Klik met de rechtermuisknop op een kolomkop en klik op Kolommen selecteren.
- 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:
- Klik met de rechtermuisknop op een kolomkop en klik op Kolommen selecteren.
- 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-GridViewgeeft 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-GridViewgeeft 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:netAls u rijen wilt zoeken met 'Net' in de kolommen DisplayName en Naam , typt u in het vak Filter :
displayname:net name:netSchakel 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
- Als u de menuknop Criteria toevoegen wilt weergeven, klikt u in de rechterbovenhoek van het venster op de pijl Uitvouwen.
- Klik op de menuknop Criteria toevoegen.
- Klik hier om kolommen (eigenschappen) te selecteren. U kunt een of meer eigenschappen selecteren.
- Wanneer u klaar bent met het selecteren van eigenschappen, klikt u op de knop Toevoegen .
- Als u de toevoegingen wilt annuleren, klikt u op Annuleren.
- 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.
Verwante koppelingen
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor