Out-GridView

Skickar utdata till en interaktiv tabell i ett separat fönster.

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

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Cmdleten Out-GridView skickar utdata från ett kommando till ett rutnätsvyfönster där utdata visas i en interaktiv tabell.

Eftersom den här cmdleten kräver ett användargränssnitt fungerar den inte på Windows Server Core eller Windows Nano Server.

Du kan använda följande funktioner i tabellen för att undersöka dina data:

  • Dölj, visa och ordna om kolumner
  • Sortera rader
  • Snabbfilter
  • Lägg till villkorsfilter
  • Kopiera och klistra in

Fullständiga instruktioner finns i avsnittet Anteckningar i den här artikeln.

Kommentar

Den här cmdleten återinfördes i PowerShell 7. Den här cmdleten är endast tillgänglig i Windows-system som stöder Windows Desktop. En plattformsoberoende version av den här cmdleten finns i modulen ConsoleGuiTools i PowerShell-galleriet.

Exempel

Exempel 1: Utdataprocesser till en rutnätsvy

Det här exemplet hämtar processerna som körs på den lokala datorn och skickar dem till ett rutnätsvyfönster.

Get-Process | Out-GridView

Exempel 2: Använd en variabel för att mata ut processer till en rutnätsvy

Det här exemplet hämtar även processerna som körs på den lokala datorn och skickar dem till ett rutnätsvyfönster.

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

Utdata från cmdleten Get-Process sparas i variabeln $P . $P Sedan skickas Out-GridViewtill .

Exempel 3: Visa markerade egenskaper i en rutnätsvy

I det här exemplet visas markerade egenskaper för de processer som körs i en rutnätsvy.

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

Utdata Get-Process från skickas till för att Select-Object välja egenskaperna Name, WorkingSet och PeakWorkingSet . En annan pipelineoperator skickar de filtrerade objekten till cmdleten Sort-Object för att sortera dem i fallande ordning efter värdet för egenskapen WorkingSet . Sedan skickas de sorterade resultaten till Out-GridView. Nu kan du använda funktionerna i rutnätsvyn för att söka efter, sortera och filtrera data.

Exempel 4: Spara utdata till en variabel och mata sedan ut en rutnätsvy

I det här exemplet sparas cmdlet-utdata i en variabel och skickas sedan till Out-GridView.

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

Get-ChildItem hämtar alla filer i PowerShell-installationskatalogen och dess underkataloger med hjälp av den $PSHOME automatiska variabeln. Parenteserna i kommandot upprättar ordningen på åtgärderna. Därför sparas utdata från Get-ChildItem kommandot i variabeln $A innan den skickas till Out-GridView.

Exempel 5: Utdataprocesser för en angiven dator till en rutnätsvy

I det här exemplet visas de processer som körs på Server01-datorn i ett rutnätsvyfönster.

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

Examle använder ogv, vilket är aliaset för cmdleten Out-GridView . Parametern Rubrik anger fönsterrubriken.

Exempel 6: Mata ut data från fjärrdatorer till en rutnätsvy

Det här exemplet visar hur du skickar data som samlas in från fjärrdatorer till Out-GridView.

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

Invoke-Command körs Get-Culture på tre fjärrdatorer. Resulterande data skickas till Out-GridView. Observera att skriptblocket som körs på fjärrdatorn inte innehåller Out-GridView kommandot . Om det gjorde det skulle kommandot misslyckas när det försökte öppna ett rutnätsvyfönster på var och en av fjärrdatorerna.

Exempel 7: Skicka flera objekt via "Out-GridView"

I det här exemplet kan du välja flera processer i fönstret Out-GridView . De processer som du väljer skickas till Export-Csv kommandot och skrivs ProcessLog.csv till filen.

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

Med parametern Out-GridView PassThru i kan du skicka flera objekt nedåt i pipelinen. Parametern PassThru motsvarar att använda värdet Flera för parametern OutputMode .

Exempel 8: Skapa en Windows-genväg till "Out-GridView"

Det här exemplet visar hur du använder parametern Out-GridView Wait för för att skapa en Windows-genväg till fönstretOut-GridView.

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

Den här kommandoraden kan användas i en Windows-genväg. Utan parametern Wait avslutas PowerShell så snart fönstret Out-GridView öppnas, vilket skulle stänga fönstret Out-GridView nästan omedelbart.

Parametrar

-InputObject

Anger objekt som cmdleten accepterar som indata för Out-GridView.

När du använder parametern InputObject för att skicka en samling objekt till Out-GridViewbehandlar Out-GridView samlingen som ett samlingsobjekt och visar en rad som representerar samlingen. Om du vill visa varje objekt i samlingen använder du en pipelineoperator (|) för att skicka objekt till Out-GridView.

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

-OutputMode

Anger de objekt som det interaktiva fönstret skickar ned pipelinen som indata till andra kommandon. Som standard genererar den här cmdleten inga utdata. Om du vill skicka objekt från det interaktiva fönstret nedåt i pipelinen klickar du för att välja objekten och klickar sedan på OK.

Värdena för den här parametern avgör hur många objekt du kan skicka ned pipelinen.

  • None. Inga objekt. Detta är standardvärdet.
  • Single. Noll objekt eller ett objekt. Använd det här värdet när nästa kommando bara kan ta ett indataobjekt.
  • Multiple. Noll, ett eller flera objekt. Använd det här värdet när nästa kommando kan ta flera indataobjekt. Det här värdet motsvarar parametern Passthru .

Den här parametern introducerades i 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

Anger att cmdleten skickar objekt från det interaktiva fönstret nedåt i pipelinen som indata till andra kommandon. Som standard genererar den här cmdleten inga utdata. Den här parametern motsvarar att använda värdet Flera för parametern OutputMode .

Om du vill skicka objekt från det interaktiva fönstret nedåt i pipelinen klickar du för att välja objekten och klickar sedan på OK. Skift-klicka och Ctrl-klicka stöds.

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

-Title

Anger den text som visas i namnlisten i Out-GridView fönstret. Som standard visar namnlisten kommandot som anropar Out-GridView.

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

-Wait

Anger att cmdleten undertrycker kommandotolken och förhindrar att Windows PowerShell stängs tills fönstret Out-GridView stängs. Som standard returneras kommandotolken när fönstret Out-GridView öppnas.

Med den Out-GridView här funktionen kan du använda cmdletarna i Windows-genvägar. När Out-GridView används i en genväg utan parametern Out-GridView Vänta visas fönstret bara en stund innan PowerShell stängs.

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

Indata

PSObject

Du kan skicka valfritt objekt till den här cmdleten.

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

PSObject

När du använder parametern PassThru returnerar den här cmdleten objekt som representerar de valda raderna.

Kommentarer

PowerShell innehåller följande alias för Out-GridView:

  • Windows:
    • ogv

Den här cmdleten är endast tillgänglig på Windows-plattformar. Den här cmdleten är endast tillgänglig på Windows-plattformar.

Du kan inte använda ett fjärrkommando för att öppna ett rutnätsvyfönster på en annan dator.

De kommandoutdata som du skickar till Out-GridView kan inte formateras med hjälp av Format cmdletar, till exempel Format-Table eller Format-Wide cmdletar. Om du vill välja egenskaper använder du cmdleten Select-Object .

Deserialiserade utdata från fjärrkommandon kanske inte formateras korrekt i rutnätsvyfönstret.

Kortkommandon förOut-GridView

Använd den här nyckeln: Så här utför du den här åtgärden:
Tab Flyttar markören från rutan Filter till menyn Lägg till villkor i tabellen och tillbaka.
Uppväven Flytta upp en rad. Flyttar till kolumnrubriker från den första dataraden.
Nedåtåt Flytta ned en rad.
LeftArrow Flytta en kolumn till vänster i kolumnrubrikraden.
RightArrow Flytta en kolumn till höger i kolumnrubrikraden.
ContextMenuKey I kolumnrubrikraden visas alternativet Välj kolumner.
Ange eller blanksteg Sortera kolumndata i kolumnrubrikraden (växla A-Z, Z-A).

Så här använder du funktionerna i rutnätsvyns fönster

Så här döljer eller visar du en kolumn:

  1. Högerklicka på valfri kolumnrubrik och klicka på Välj kolumner.
  2. I dialogrutan Välj kolumner använder du piltangenterna för att flytta kolumnerna mellan de markerade kolumnerna till rutorna Tillgängliga kolumner. Endast kolumner i rutan Välj kolumner visas i rutnätsvyfönstret.

Så här ändrar du ordning på kolumner:

Du kan dra och släppa kolumner till önskad plats. Eller använd följande steg:

  1. Högerklicka på valfri kolumnrubrik och klicka på Välj kolumner.
  2. I dialogrutan Välj kolumner använder du knapparna Flytta upp och Flytta ned för att ordna om kolumnerna. Kolumner överst i listan visas till vänster om kolumner längst ned i listan i rutnätsvyfönstret.

Sortera tabelldata

  • Om du vill sortera data klickar du på en kolumnrubrik.
  • Om du vill ändra sorteringsordningen klickar du på kolumnrubriken igen. Varje gång du klickar på samma rubrik växlar sorteringsordningen mellan stigande till fallande ordning. Den aktuella ordningen indikeras av en triangel i kolumnrubriken.

Så här väljer du tabelldata

  • Om du vill markera en rad väljer du raden eller använder uppåt- eller nedåtpilen för att navigera till raden.
  • Om du vill markera alla rader (förutom rubrikraden) trycker du på CTRL+A.
  • Om du vill välja efterföljande rader trycker du på och håller ned SKIFT-tangenten medan du klickar på raderna eller använder piltangenterna.
  • Om du vill välja icke-konsekutiva rader trycker du på CTRL-tangenten och klickar för att lägga till en rad i markeringen.
  • Du kan inte markera kolumner och du kan inte välja hela kolumnrubrikraden.

Kopiera rader

  • Om du vill kopiera en eller flera rader från tabellen markerar du raderna och trycker sedan på CTRL+C.

    Du kan klistra in data i valfritt text- eller kalkylbladsprogram. Du kan inte kopiera kolumner eller delar av rader och du kan inte kopiera kolumnrubrikraden.

Så här söker du i tabellen (snabbfilter)

Använd rutan Filter för att söka efter data i tabellen. När du skriver i rutan visas endast objekt som innehåller den inskrivna texten i tabellen.

  • Sök efter text. Om du vill söka efter text i tabellen skriver du den text som du vill söka efter i rutan Filter.

  • Sök efter flera ord. Om du vill söka efter flera ord i tabellen skriver du orden avgränsade med blanksteg. Out-GridView visar rader som innehåller alla ord (logisk AND).

  • Sök efter literalfraser. Om du vill söka efter fraser som innehåller blanksteg eller specialtecken omger du frasen inom citattecken. Out-GridView visar rader som innehåller en exakt matchning för frasen.

  • Sök i kolumner. Om du vill söka efter text i en eller flera kolumner använder du följande format:

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

    Om du till exempel vill hitta "Net" i kolumnen DisplayName skriver du i rutan Filter :

    displayname:net

    Om du vill hitta rader med "Net" i kolumnerna DisplayName och Name skriver du i rutan Filter:

    displayname:net name:net

  • Inaktivera sökning. Om du vill visa hela tabellen igen klickar du på den röda X-knappen i det övre högra hörnet i rutan Filter eller tar bort texten från rutan Filter .

Använd villkor för att filtrera tabellen

Du kan använda regler eller kriterier för att avgöra vilka objekt som visas i tabellen. Objekt visas bara när de uppfyller alla kriterier som du upprättar. De tillgängliga kriterierna bestäms av egenskaperna för de objekt som visas i rutnätsvyfönstret och .NET Framework-typerna av dessa egenskaper.

Varje kriterium har följande format:

<column> <operator> <value>

Villkor för olika egenskaper är anslutna med AND. Villkor för samma egenskap är anslutna med OR. Du kan inte ändra de logiska anslutningsprogrammen.

Villkoret påverkar bara visningen. Det tar inte bort objekt från tabellen.

Så här lägger du till villkor

  1. Om du vill visa menyknappen Lägg till villkor klickar du på pilen Expandera i det övre högra hörnet av fönstret.
  2. Klicka på menyn Lägg till villkor .
  3. Klicka om du vill välja kolumner (egenskaper). Du kan välja en eller flera egenskaper.
  4. När du är klar med att välja egenskaper klickar du på knappen Lägg till .
  5. Om du vill avbryta tilläggen klickar du på Avbryt.
  6. Om du vill lägga till fler villkor klickar du på knappen Lägg till villkor igen.

Redigera ett kriterium

  • Om du vill ändra en operator klickar du på det blå operatorvärdet och väljer sedan en annan operator i listrutan.
  • Om du vill ange eller ändra ett värde skriver du ett värde i värderutan. Om du anger ett värde som inte är giltigt visas en cirkelformad X-ikon. Om du vill ta bort det ändrar du värdet.
  • Om du vill skapa en OR-instruktion lägger du till ett villkor med samma egenskap.

Ta bort villkor

  • Om du vill ta bort markerade villkor klickar du på det röda X:et bredvid varje kriterium.
  • Om du vill ta bort alla villkor klickar du på knappen Rensa alla .