Dela via

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

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å Server Core-installationer av Windows Server.

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

  • Dölj, Visa och ändra ordning på kolumner: Om du vill dölja, visa eller ändra ordning på en kolumn högerklickar du på en kolumnrubrik och klickar sedan på Välj kolumner.
  • Sortera. Om du vill sortera data klickar du på en kolumnrubrik. Klicka igen om du vill växla från stigande till fallande ordning.
  • Snabbfilter. Använd rutan Filter överst i fönstret för att söka igenom texten i tabellen. Du kan söka efter text i en viss kolumn, söka efter literaler och söka efter flera ord.
  • Villkorsfilter. Använd listrutan Lägg till villkor för att skapa regler för att filtrera data. Detta är mycket användbart för mycket stora datamängder, till exempel händelseloggar.
  • Kopiera och klistra in. Om du vill kopiera rader med data från Out-GridView trycker du på CTRL +C (kopiera). Du kan klistra in data i valfritt text- eller kalkylbladsprogram.

Anvisningar för hur du använder de här funktionerna Get-Help Out-GridView -Full finns i Så här använder du fönsterfunktionerna i rutnätsvyn i avsnittet Anteckningar.

Exempel

Exempel 1: Utdataprocesser till en rutnätsvy

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

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

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

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

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

Det första kommandot använder cmdleten Get-Process för att hämta processerna på datorn och sparar sedan processobjekten i variabeln $P.

Det andra kommandot använder en pipelineoperator för att skicka variabeln $P till Out-GridView.

Exempel 3: Visa en formaterad tabell i en rutnätsvy

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

Det här kommandot visar en formaterad tabell i ett rutnätsvyfönster.

Den använder cmdleten Get-Process för att hämta processerna på datorn.

Sedan används en pipelineoperator (|) för att skicka processobjekten till cmdleten Select-Object. Kommandot använder egenskapsparametern för Select-Object för att välja egenskaperna Name, WorkingSet och PeakWorkingSet som ska visas i tabellen.

En annan pipelineoperator skickar de filtrerade objekten till cmdleten Sort-Object, som sorterar dem i fallande ordning efter värdet för egenskapen WorkingSet .

Den sista delen av kommandot använder en pipelineoperator (|) för att skicka den formaterade tabellen 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

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

Det här kommandot sparar sina utdata i en variabel och skickar dem till Out-GridView.

Kommandot använder cmdleten Get-ChildItem för att hämta filerna i installationskatalogen för Windows PowerShell och dess underkataloger. Sökvägen till installationskatalogen sparas i den $pshome automatiska variabeln.

Kommandot använder tilldelningsoperatorn (=) för att spara utdata i variabeln $A och pipelineoperatorn (|) för att skicka utdata till Out-GridView.

Parenteserna i kommandot upprättar ordningen på åtgärderna. Därför sparas utdata från kommandot Get-ChildItem i variabeln $A innan de skickas till Out-GridView.

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

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

Det här kommandot visar de processer som körs på Server01-datorn i ett rutnätsvyfönster.

Kommandot använder ogv, vilket är det inbyggda aliaset för cmdleten Out-GridView . Den använder parametern Rubrik för att ange fönsterrubriken.

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

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

Det här exemplet visar rätt format för att skicka data som samlats in från fjärrdatorer till Out-GridView-cmdleten .

Kommandot använder cmdleten Invoke-Command för att köra ett Get-Culture kommando på tre fjärrdatorer. Den använder en pipelineoperator för att skicka data som returneras till Out-GridView-cmdleten .

Observera att skriptblocket som innehåller kommandon som fjärrkörs inte innehåller kommandot Out-GridView . 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 genom Out-GridView

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

Med det här kommandot kan du välja flera processer från out-gridview-fönstret . De processer som du väljer skickas till kommandot Export-Csv och skrivs till filen ProcessLog.csv.

Kommandot använder parametern PassThru i Out-GridView, där du kan 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

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

Det här kommandot visar hur du använder wait-parametern för Out-GridView för att skapa en Windows-genväg till Out-GridView-fönstret. Utan parametern Wait avslutas Windows PowerShell så snart out-gridview-fönstret öppnas, vilket skulle stänga Out-GridView-fönstret nästan omedelbart.

Parametrar

-InputObject

Anger att cmdleten accepterar indata för Out-GridView.

När du använder parametern InputObject för att skicka en samling objekt till Out-GridView behandlar 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 denna cmdlet inga utdata. Om du vill skicka objekt från det interaktiva fönstret nedåt i pipelinen klickar du för att markera 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.

  • Inga. Inga objekt. Detta är standardvärdet.
  • Enda. Noll objekt eller ett objekt. Använd det här värdet när nästa kommando bara kan ta ett indataobjekt.
  • Flera. 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 denna cmdlet inga utdata. Den här parametern motsvarar att använda multipla värden för outputmode-parametern .

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

Den här parametern introducerades i Windows PowerShell 3.0.

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

-Title

Anger den text som visas i namnlisten i fönstret Out-GridView .

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 Windows PowerShell från att stängas tills Out-GridView-fönstret stängs. Som standard returneras kommandotolken när Out-GridView-fönstret öppnas.

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

Den här parametern introducerades i Windows PowerShell 3.0.

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

Indata

PSObject

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

Utdata

None

Out-GridView returnerar inga objekt.

Kommentarer

  • I Windows PowerShell 2.0 installeras Out-GridView-cmdleten som standard på klientversioner av Windows, men är en valfri funktion i serverversioner av Windows. I Windows PowerShell 3.0 installeras den på alla system som standard. Men om du inaktiverar eller tar bort Windows PowerShell ISE-funktionen inaktiveras eller tas även Out-GridView-cmdleten bort.

  • 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, till exempel med hjälp av cmdletarna Format-Table eller Format-Wide. 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ör Out-GridView

    Med hjälp av följande kortkommandon kan du utföra många uppgifter snabbt.

    Använd den här nyckeln:Utför den här åtgärden:

    TABB Flyttar markören från rutan Filter till menyn Lägg till villkor i tabellen och bakåt.

    UPPÅTPIL Flytta upp en rad. Flyttas till kolumnrubriker.

    NEDPIL Flytta ned en rad.

    VÄNSTERPIL I kolumnrubrikraden flyttar du en kolumn åt vänster.

    HÖGERPIL I kolumnrubrikraden flyttar du en kolumn åt höger.

    SNABBMENYNYCKEL I kolumnrubrikraden visas alternativet Välj kolumner.

    RETUR eller BLANKSTEG I kolumnrubrikraden sorterar du kolumndata (växla A-Z, Z-A).

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

    I följande avsnitt förklaras hur du använder funktionerna i fönstret som Out-GridView visar.

    Så här döljer, visar och ändrar du ordning på kolumner

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

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 Valda kolumner visas i rutnätsvyfönstret.

Så här ordnar du om kolumner:

  • Dra och släpp kolumnen på önskad plats.

  • Eller-

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 klickar du på raden eller använder upp- eller nedpilen 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 markera 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 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 Search du i tabellen (snabbfilter)

Använd filterrutan 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.

  • Search för text. Om du vill söka efter text i tabellen skriver du den text som ska hittas i rutan Filter.

  • Search för 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 (logiskt AND).

  • Search för 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.

  • Search 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 filterrutan.

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 de .NET Framework typerna av dessa egenskaper.

Varje kriterium har följande format:

<kolumnoperatorvärde><><>

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

Kriterierna påverkar bara visningen. Objekt tas inte bort från tabellen.

Så här lägger du till villkor

1. Om du vill visa knappen Lägg till villkorsmeny klickar du på pilen Expandera i det övre högra hörnet av fönstret.

2. Klicka på menyknappen 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 villkor

  • Om du vill ändra en operator klickar du på det blå operatorvärdet och sedan på för att välja 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 ogiltigt värde 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.