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-GridView
fogad el.
Amikor az InputObject paraméterrel objektumgyűjteményt Out-GridView
kü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-GridView
elküldéséhez.
Típus: | PSObject |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | OutputModeOption |
Elfogadott értékek: | None, Single, Multiple |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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
.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
A parancsmaghoz bármilyen objektumot csövezhet.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
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-GridView
tartalmazza:
- 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: |
---|---|
Tabulátor | 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:
- Kattintson a jobb gombbal bármelyik oszlopfejlécre, és válassza az Oszlopok kijelölése parancsot.
- 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:
- Kattintson a jobb gombbal bármelyik oszlopfejlécre, és válassza az Oszlopok kijelölése parancsot.
- 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
- A Feltétel hozzáadása menü megjelenítéséhez kattintson az ablak jobb felső sarkában a Kibontás nyílra.
- Kattintson a Feltételek hozzáadása menügombra.
- Kattintson ide az oszlopok (tulajdonságok) kiválasztásához. Kiválaszthat egy vagy több tulajdonságot.
- Ha befejezte a tulajdonságok kiválasztását, kattintson a Hozzáadás gombra.
- A hozzáadások megszakításához kattintson a Mégse gombra.
- 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.