Feedback

Out-GridView

  • Referens
Modul:
Microsoft.PowerShell.Utility

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 anvisningar finns i avsnittet Anteckningar i den här artikeln.

Anteckning

Denna cmdlet återinfördes i PowerShell 7. Den här cmdleten är endast tillgänglig på Windows-system som stöder Windows Desktop. En plattformsoberoende version av den här cmdleten finns i modulen GraphicalTools 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 också de processer 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 Select-Object för att 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 i 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 de 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-GridViewPassThru i kan du skicka flera objekt nedåt i pipelinen. Parametern PassThru motsvarar att använda multipla värden för outputmode-parametern.

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

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

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å fort 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
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 denna cmdlet 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 .
Type:OutputModeOption
Accepted values:None, Single, Multiple
Position:Named
Default value:None
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 denna cmdlet inga utdata. Den här parametern motsvarar att använda värdet Multiple 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
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
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-GridViewVänta visas fönstret bara tillfälligt innan PowerShell stängs.

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

Indata

PSObject

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

Utdata

None

Normalt Out-GridView returnerar inte några objekt. När du använder parametern PassThru returneras objekten som representerar de valda raderna till pipelinen.

Kommentarer

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.

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 är korrekt formaterade 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:
Tabb Flyttar markören från rutan Filter till menyn Lägg till villkor i tabellen och tillbaka.
Uppärvning Flytta upp en rad. Flyttar till kolumnrubriker från den första dataraden.
Nedärvd Flytta ned en rad.
LeftArrow Flytta en kolumn till vänster i kolumnrubrikraden.
RightArrow Flytta en kolumn åt höger i kolumnrubrikraden.
ContextMenuKey I kolumnrubrikraden visas alternativet Välj kolumner.
Retur 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 valda kolumnerna till rutorna Tillgängliga kolumner. Endast kolumner i rutan Välj kolumner visas i rutnätsvyfönstret.

Så här ordnar du om 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 och 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 markera raderna i följd trycker du på och håller ned SKIFT-tangenten när du klickar på raderna eller använder piltangenterna.
  • Om du vill välja icke-konsekutiva rader trycker du på CTRL och klickar på för att lägga till en rad i markeringen.
  • Du kan inte markera kolumner och du kan inte markera 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 ska hittas 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

  • Stäng av sökningen. 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ända villkor för att filtrera tabellen

Du kan använda regler eller villkor 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 de .NET Framework typerna av dessa egenskaper.

Varje kriterium har följande format:

<column> <operator> <value>

Kriterier 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 knappen Lägg till villkor klickar du på pilen Expandera i det övre högra hörnet i fönstret.
  2. Klicka på menyn Lägg till villkor .
  3. Klicka här 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 .