Out-GridView

Modul:

Microsoft.PowerShell.Utility Module

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

Syntax

PassThru (Alapértelmezett)

Out-GridView
    [-InputObject <PSObject>]
    [-Title <String>]
    [-PassThru]
    [<CommonParameters>]

Wait

Out-GridView
    [-InputObject <PSObject>]
    [-Title <String>]
    [-Wait]
    [<CommonParameters>]

OutputMode

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.

Megjegyzé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, Select-Object és a PeakWorkingSet tulajdonságok kiválasztásához 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 ogv használjaOut-GridView. 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öbb é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 ablakhoz a Out-GridView 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.

Paramétertulajdonságok

Típus:	PSObject
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	OutputModeOption
Alapértelmezett érték:	None
Elfogadott értékek:	None, Single, Multiple
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

OutputMode

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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ű a OutputMode paraméter több é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.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

PassThru

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Wait

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

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 tartalmazza Out-GridView:

• 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:
Tab	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. A rendelkezésre álló feltételeket a rácsnézet ablakában megjelenő objektumok tulajdonságai és a tulajdonságok .NET-keretrendszertí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.

Kapcsolódó hivatkozások

• Kimenet-fájl
• Külső nyomtató
• Out-String