Out-GridView

Kimenetet küld egy interaktív táblának egy külön ablakban.

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

Ez a parancsmag csak a Windows platformon érhető el.

A Out-GridView parancsmag egy parancs kimenetét egy rácsnézet ablakába küldi, ahol a kimenet egy interaktív táblában jelenik meg.

Mivel ehhez a parancsmaghoz felhasználói felület szükséges, nem működik a Windows Server Core-on vagy a Windows Nano Serveren.

A táblázat alábbi funkcióival vizsgálhatja meg az adatokat:

  • Oszlopok elrejtése, megjelenítése és átrendezése
  • Sorok rendezése
  • Gyorsszűrő
  • Feltételszűrő hozzáadása
  • Másolás és beillesztés

A teljes útmutatásért tekintse meg a cikk Jegyzetek szakaszát.

Feljegyzés

Ezt a parancsmagot újra bevezették a PowerShell 7-ben. Ez a parancsmag csak a Windows Desktopot támogató Windows-rendszereken érhető el. A parancsmag platformfüggetlen verziójáért lásd a ConsoleGuiTools modult a PowerShell-galéria.

Példák

1. példa: Folyamatok kimenete rácsnézetbe

Ez a példa lekéri a helyi számítógépen futó folyamatokat, és elküldi őket egy rácsnézetablakba.

Get-Process | Out-GridView

2. példa: Folyamatok rácsnézetbe történő kimenete változó használatával

Ez a példa a helyi számítógépen futó folyamatokat is lekéri, és elküldi őket egy rácsnézetablakba.

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

A parancsmag kimenete Get-Process a $P változóban lesz mentve. $P Ezután be van csövezve a következőreOut-GridView: .

3. példa: Kijelölt tulajdonságok megjelenítése rács nézetben

Ez a példa rács nézetben jeleníti meg a futó folyamatok kiválasztott tulajdonságait.

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

A kimenet Get-Process a Név, a WorkingSet és a PeakWorkingSet tulajdonságok kiválasztásához Select-Object van beállítva. Egy másik folyamatkezelő elküldi a szűrt objektumokat a Sort-Object parancsmagnak, hogy csökkenő sorrendben rendezze őket a WorkingSet tulajdonság értéke alapján. Ezután a rendszer a rendezett eredményeket a következőre csövezi Out-GridView: . Mostantól a rácsnézet funkcióival kereshet, rendezhet és szűrhet adatokat.

4. példa: Kimenet mentése változóba, majd rácsnézet kimenete

Ez a példa egy változóban menti a parancsmag kimenetét, majd elküldi a következőnek Out-GridView: .

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

Get-ChildItem az automatikus változó használatával $PSHOME lekéri a PowerShell telepítési könyvtárában és alkönyvtáraiban található összes fájlt. A parancs zárójelei a műveletek sorrendjét állapítják meg. Ennek eredményeképpen a parancs kimenete Get-ChildItem a változóba $A lesz mentve, mielőtt elküldené azt.Out-GridView

5. példa: Adott számítógép kimeneti folyamatai rácsnézetbe

Ez a példa a Server01 számítógépen futó folyamatokat jeleníti meg egy rácsnézetablakban.

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

A példa a parancsmag aliasát Out-GridView használjaogv. A Cím paraméter az ablak címét adja meg.

6. példa: Adatok kimenete távoli számítógépekről rácsnézetbe

Ez a példa bemutatja, hogyan küldheti el a távoli számítógépekről gyűjtött adatokat a rendszernek Out-GridView.

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

Invoke-Command három távoli számítógépen fut Get-Culture . Az eredményként kapott adatok a következőre lesznek Out-GridViewátirányítva: . Figyelje meg, hogy a távoli számítógépen futó szkriptblokk nem tartalmazza a Out-GridView parancsot. Ha igen, a parancs sikertelen lesz, amikor az egyes távoli számítógépeken egy rácsnézetablakot próbált megnyitni.

7. példa: Több elem átadása az Out-GridView-on keresztül

Ez a példa lehetővé teszi több folyamat kiválasztását az Out-GridView ablakból. A kiválasztott folyamatokat a rendszer átadja a Export-Csv parancsnak, és beírja a ProcessLog.csv fájlba.

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

A PassThru paraméter Out-GridView lehetővé teszi, hogy több elemet küldjön a folyamatba. A PassThru paraméter egyenértékű az OutputMode paraméter Többszörös értékének használatával.

8. példa: Windows-parancsikon létrehozása a "Out-GridView" parancsikonhoz

Ez a példa bemutatja, hogyan hozhat létre windowsos parancsikont az Out-GridView ablakhoz a Wait paraméterrelOut-GridView.

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

Ez a parancssor windowsos parancsikonokban is használható. A Várakozás paraméter nélkül a PowerShell azonnal kilép az Out-GridView ablak megnyitásakor, ami szinte azonnal bezárja az Out-GridView ablakot.

Paraméterek

-InputObject

Megadja az objektumot, amelyet a parancsmag bemenetként Out-GridViewfogad el.

Amikor az InputObject paraméterrel objektumgyűjteményt Out-GridViewküld, Out-GridView a gyűjteményt egyetlen gyűjteményobjektumként kezeli, és egy olyan sort jelenít meg, amely a gyűjteményt jelöli. A gyűjtemény minden objektumának megjelenítéséhez használjon folyamatkezelőt (|) az objektumok Out-GridViewelküldéséhez.

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

-OutputMode

Megadja azokat az elemeket, amelyeket az interaktív ablak más parancsok bemeneteként küld a folyamatnak. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet. Ha a folyamat interaktív ablakából szeretne elemeket küldeni, jelölje ki az elemeket, majd kattintson az OK gombra.

A paraméter értékei határozzák meg, hogy hány elemet küldhet le a folyamatról.

  • None. Nincsenek elemek. Ez az alapértelmezett érték.
  • Single. Nulla elem vagy egy elem. Ezt az értéket akkor használja, ha a következő parancs csak egy bemeneti objektumot tud használni.
  • Multiple. Nulla, egy vagy több elem. Ezt az értéket akkor használja, ha a következő parancs több bemeneti objektumot is képes használni. Ez az érték egyenértékű a Passthru paraméterével.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Type:OutputModeOption
Accepted values:None, Single, Multiple
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Azt jelzi, hogy a parancsmag elemeket küld az interaktív ablakból a folyamaton belül más parancsok bemeneteként. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet. Ez a paraméter egyenértékű az OutputMode paraméter Többszörös értékének használatával.

Ha a folyamat interaktív ablakából szeretne elemeket küldeni, jelölje ki az elemeket, majd kattintson az OK gombra. A Shift billentyűt lenyomva tartva és a Ctrl billentyűt lenyomva tartva a program támogatja a parancsot.

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

-Title

Az ablak címsorában Out-GridView megjelenő szöveget adja meg. Alapértelmezés szerint a címsor megjeleníti a meghívandó parancsot Out-GridView.

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

-Wait

Azt jelzi, hogy a parancsmag letiltja a parancssort, és megakadályozza a Windows PowerShell bezárását az Out-GridView ablak bezárásáig. Alapértelmezés szerint a parancssor az ablak megnyitásakor Out-GridView ad vissza.

Ez a funkció lehetővé teszi a Out-GridView Parancsmagok használatát a Windows parancsikonjaiban. Ha Out-GridView a Wait paraméter nélküli parancsikonban használják, az Out-GridView ablak csak pillanatnyira jelenik meg, mielőtt a PowerShell bezárul.

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

Bevitelek

PSObject

A parancsmaghoz bármilyen objektumot csövezhet.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

PSObject

A PassThru paraméter használatakor ez a parancsmag a kijelölt sorokat képviselő objektumokat adja vissza.

Jegyzetek

A PowerShell a következő aliasokat Out-GridViewtartalmazza:

  • Windows:
    • ogv

Ez a parancsmag csak Windows-platformokon érhető el. Ez a parancsmag csak Windows-platformokon érhető el.

Nem használhat távoli parancsot egy rácsnézet ablakának megnyitásához egy másik számítógépen.

Az elküldött Out-GridView parancskimenet nem formázható a Format parancsmagok, például Format-Table parancsmagok Format-Wide használatával. A tulajdonságok kiválasztásához használja a Select-Object parancsmagot.

Előfordulhat, hogy a távoli parancsok deszerializált kimenete nem megfelelően van formázva a rácsnézet ablakában.

Billentyűparancsok a következőhöz:Out-GridView

Használja ezt a kulcsot: A művelet végrehajtása:
Lapon A kurzor áthelyezése a Szűrő mezőről a Feltétel hozzáadása menübe a táblázatra és vissza.
UpArrow Ugrás egy sorra felfelé. Ugrás oszlopfejlécekre az első adatsorból.
DownArrow Lépés egy sorral lejjebb.
LeftArrow Az oszlopfejléc sorában mozgassa balra az egyik oszlopot.
RightArrow Az oszlopfejléc sorában mozgassa jobbra az egyik oszlopot.
ContextMenuKey Az oszlopfejléc sorában megjelenik az Oszlopok kijelölése lehetőség.
Enter vagy Szóköz Az oszlopfejléc sorában rendezze az oszlopadatokat (A-Z, Z-A kapcsoló).

A Rácsnézet ablak funkcióinak használata

Oszlop elrejtése vagy megjelenítése:

  1. Kattintson a jobb gombbal bármelyik oszlopfejlécre, és válassza az Oszlopok kijelölése parancsot.
  2. Az Oszlopok kijelölése párbeszédpanelen a nyílbillentyűkkel helyezze át az oszlopokat a Kijelölt oszlopok között az Elérhető oszlopok mezőre. A rácsnézet ablakában csak az Oszlopok kijelölése mezőben lévő oszlopok jelennek meg.

Oszlopok átrendezése:

Az oszlopokat áthúzhatja a kívánt helyre. Vagy kövesse az alábbi lépéseket:

  1. Kattintson a jobb gombbal bármelyik oszlopfejlécre, és válassza az Oszlopok kijelölése parancsot.
  2. Az Oszlopok kijelölése párbeszédpanelen az Áthelyezés felfelé és lefelé gombokkal átrendezheti az oszlopokat. A lista tetején lévő oszlopok a lista alján lévő oszlopoktól balra jelennek meg a rácsnézet ablakában.

Táblázatadatok rendezése

  • Az adatok rendezéséhez kattintson egy oszlopfejlécre.
  • A rendezési sorrend módosításához kattintson ismét az oszlopfejlécre. Minden alkalommal, amikor ugyanarra a fejlécre kattint, a rendezési sorrend csökkenő sorrendbe vált. Az aktuális sorrendet egy háromszög jelzi az oszlopfejlécben.

Táblaadatok kiválasztása

  • Egy sor kijelöléséhez jelölje ki a sort, vagy a felfelé vagy lefelé mutató nyíllal navigáljon a sorra.
  • Az összes sor kijelöléséhez (a fejlécsor kivételével) nyomja le a CTRL A billentyűkombinációt+.
  • Egymást követő sorok kijelöléséhez nyomja le és tartsa lenyomva a SHIFT billentyűt a sorokra kattintva vagy a nyílbillentyűkkel.
  • Ha nem biztonságos sorokat szeretne kijelölni, nyomja le a CTRL billentyűt, és kattintson egy sor hozzáadásához a kijelöléshez.
  • Nem jelölhet ki oszlopokat, és nem jelölheti ki a teljes oszlopfejlécsort.

Sorok másolása

  • Ha ki szeretne másolni egy vagy több sort a táblázatból, jelölje ki a sorokat, majd nyomja le a CTRL+C billentyűkombinációt.

    Az adatokat bármilyen szövegbe vagy számolótáblába beillesztheti. Nem másolhat oszlopokat vagy sorok részeit, és nem másolhatja az oszlopfejlécsort.

Keresés a táblázatban (gyorsszűrő)

A Szűrő mezővel adatokat kereshet a táblában. Amikor beírja a mezőt, csak a beírt szöveget tartalmazó elemek jelennek meg a táblázatban.

  • Szöveg keresése. Ha szöveget szeretne keresni a táblázatban, írja be a keresett szöveget a Szűrő mezőbe.

  • Keressen több szót. Ha több szót szeretne keresni a táblázatban, írja be a szóközzel elválasztott szavakat. Out-GridView az összes szót (logikai ÉS) tartalmazó sorokat jeleníti meg.

  • Keressen literálkifejezéseket. Ha szóközöket vagy speciális karaktereket tartalmazó kifejezéseket szeretne keresni, a kifejezést idézőjelek közé kell foglalnia. Out-GridView A kifejezés pontos egyezését tartalmazó sorokat jelenít meg.

  • Keresés oszlopokban. Ha egy vagy több oszlopban szeretne szöveget keresni, használja a következő formátumot:

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

    Ha például meg szeretné keresni a "Net" kifejezést a DisplayName oszlopban, a Szűrő mezőbe írja be a következőt:

    displayname:net

    Ha a DisplayName és a Name oszlopban "Net" típusú sorokat szeretne keresni, írja be a Szűrő mezőbe a következőt:

    displayname:net name:net

  • Kapcsolja ki a keresést. A teljes táblázat ismételt megjelenítéséhez kattintson a Szűrő mező jobb felső sarkában lévő piros X gombra, vagy törölje a szöveget a Szűrő mezőből.

Feltételek használata a tábla szűréséhez

Szabályok vagy feltételek használatával meghatározhatja, hogy mely elemek jelenjenek meg a táblában. Az elemek csak akkor jelennek meg, ha megfelelnek az Ön által meghatározott feltételeknek. Az elérhető feltételeket a rácsnézet ablakában megjelenő objektumok tulajdonságai és a tulajdonságok .NET-keretrendszer típusai határozzák meg.

Mindegyik feltétel formátuma a következő:

<column> <operator> <value>

A különböző tulajdonságokra vonatkozó feltételeket az AND köti össze. Ugyanannak a tulajdonságnak a feltételeit az OR köti össze. A logikai összekötők nem módosíthatók.

A feltételek csak a megjelenítésre lesznek hatással. Nem törli az elemeket a táblából.

Feltételek hozzáadása

  1. A Feltétel hozzáadása menü megjelenítéséhez kattintson az ablak jobb felső sarkában a Kibontás nyílra.
  2. Kattintson a Feltételek hozzáadása menügombra.
  3. Kattintson ide az oszlopok (tulajdonságok) kiválasztásához. Kiválaszthat egy vagy több tulajdonságot.
  4. Ha befejezte a tulajdonságok kiválasztását, kattintson a Hozzáadás gombra.
  5. A hozzáadások megszakításához kattintson a Mégse gombra.
  6. További feltételek hozzáadásához kattintson ismét a Feltétel hozzáadása gombra.

Feltétel szerkesztése

  • Operátor módosításához kattintson a kék operátor értékére, majd válasszon másik operátort a legördülő listából.
  • Érték megadásához vagy módosításához írjon be egy értéket az érték mezőbe. Ha érvénytelen értéket ad meg, megjelenik egy körkörös X ikon. Az eltávolításhoz módosítsa az értéket.
  • OR utasítás létrehozásához adjon hozzá egy azonos tulajdonsággal rendelkező feltételt.

Feltételek törlése

  • A kijelölt feltételek törléséhez kattintson az egyes feltételek melletti piros X-ra.
  • Az összes feltétel törléséhez kattintson az Összes törlése gombra.