Out-GridView
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
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 Server Core-telepítéseinél.
A táblázat alábbi funkcióival vizsgálhatja meg az adatokat:
- Oszlopok elrejtése, megjelenítése és átrendezése: Egy oszlop elrejtéséhez, megjelenítéséhez vagy átrendezéséhez kattintson a jobb gombbal egy oszlopfejlécre, majd kattintson az Oszlopok kijelölése parancsra.
- Fajta. Az adatok rendezéséhez kattintson egy oszlopfejlécre. Kattintson ismét, ha növekvőről csökkenő sorrendre szeretne váltani.
- Gyors szűrő. Az ablak tetején található Szűrő mezővel kereshet a táblázat szövegében. Kereshet szöveget egy adott oszlopban, kereshet literálokat, és kereshet több szót is.
- Feltételszűrő. A Feltételek hozzáadása legördülő menüben szabályokat hozhat létre az adatok szűrésére. Ez nagyon hasznos nagyon nagy adathalmazokhoz, például eseménynaplókhoz.
- Másolás és beillesztés. Ha adatsorokat szeretne másolni az Out-GridView nézetből, nyomja le a CTRL+C (másolás) billentyűkombinációt. Az adatokat bármilyen szövegbe vagy számolótáblába beillesztheti.
A szolgáltatások használatára vonatkozó utasításokért írja be Get-Help Out-GridView -Full és olvassa el A Rácsnézet ablak szolgáltatásainak használata című részt a Megjegyzések szakaszban.
Példák
1. példa: Folyamatok kimenete rácsnézetbe
PS C:\> Get-Process | Out-GridView
Ez a parancs lekéri a helyi számítógépen futó folyamatokat, és elküldi őket egy rácsnézetablakba.
2. példa: Folyamatok rácsnézetbe történő kimenete változó használatával
PS C:\> $P = Get-Process
PS C:\> $P | Out-GridView
Ez a parancs a helyi számítógépen futó folyamatokat is lekéri, és elküldi őket egy rácsnézetablakba.
Az első parancs a Get-Process parancsmaggal lekéri a folyamatokat a számítógépen, majd menti a folyamatobjektumokat a $P változóba.
A második parancs egy folyamatoperátorral küldi el a $P változót az Out-GridView-nak.
3. példa: Formázott táblázat megjelenítése rácsnézetben
PS C:\> Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet | Sort-Object -Property WorkingSet -Descending | Out-GridView
Ez a parancs egy formázott táblát jelenít meg egy rácsnézetablakban.
A Get-Process parancsmaggal szerzi be a folyamatokat a számítógépen.
Ezután egy folyamatkezelővel (|) küldi el a folyamatobjektumokat a Select-Object parancsmagnak. A parancs a Select-ObjectTulajdonság paraméterével választja ki a táblában megjelenítendő Név, Munkakészlet és PeakWorkingSet tulajdonságokat.
Egy másik folyamatoperátor elküldi a szűrt objektumokat a Sort-Object parancsmagnak, amely csökkenő sorrendbe rendezi őket a WorkingSet tulajdonság értéke alapján.
A parancs utolsó része egy folyamatkezelő (|) használatával küldi el a formázott táblát 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
PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | Out-GridView
Ez a parancs egy változóba menti a kimenetét, és elküldi Out-GridView.
A parancs a Get-ChildItem parancsmaggal szerzi be a fájlokat a Windows PowerShell telepítési könyvtárába és alkönyvtáraiba. A telepítési könyvtár elérési útja a $pshome automatikus változóban lesz mentve.
A parancs a hozzárendelési operátorral (=) menti a kimenetet a $A változóba, a folyamat operátora (|) pedig elküldi a kimenetet az Out-GridView-nak.
A parancs zárójelei a műveletek sorrendjét állapítják meg. Ennek eredményeképpen a Get-ChildItem parancs kimenete a $A változóba kerül, mielőtt elküldené az Out-GridView-nak.
5. példa: Adott számítógép kimeneti folyamatai rácsnézetbe
PS C:\> Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"
Ez a parancs rácsnézetablakban jeleníti meg a Server01 számítógépen futó folyamatokat.
A parancs a következőt használja ogv, amely az Out-GridView parancsmag beépített aliasa, és a Title paramétert használja az ablak címének megadásához.
6. példa: Adatok kimenete távoli számítógépekről rácsnézetbe
PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView
Ez a példa a távoli számítógépekről a Out-GridView parancsmagba küldött adatok helyes formátumát mutatja be.
A parancs a Invoke-Command parancsmaggal futtat egy Get-Culture parancsot három távoli számítógépen. Folyamatkezelővel küldi el a Out-GridView parancsmagnak visszaadott adatokat.
Figyelje meg, hogy a távolról futtatott parancsokat tartalmazó 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 Out-GridView
PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv
Ezzel a paranccsal több folyamatot is kiválaszthat a Out-GridView ablakból. A kiválasztott folyamatokat a rendszer a Export-Csv parancsnak továbbítja, és a ProcessLog.csv fájlba írja.
A parancs a Out-GridViewPassThru paraméterét használja, amely lehetővé teszi több elem küldését a folyamaton. A PassThru paraméter egyenértékű a OutputMode paraméter Multiple értékének használatával.
8. példa: Windows-parancsikon létrehozása a Out-GridView
PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"
Ez a parancs bemutatja, hogyan hozhat létre Windows-parancsikont Out-GridViewWait paraméterével a Out-GridView ablakhoz. A Várakozás paraméter nélkül a Windows PowerShell azonnal kilép, amint megnyílik a Out-GridView ablak, amely szinte azonnal bezárja a Out-GridView ablakot.
Paraméterek
-InputObject
Megadja, hogy a parancsmag elfogadja az Out-GridView bemenetét.
Ha az InputObject paraméterrel küld objektumok gyűjteményét az Out-GridView-ba, az Out-GridView egy gyűjteményobjektumként kezeli a gyűjteményt, és megjelenít egy sort, 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.
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.
- Nincs. Nincsenek elemek. Ez az alapértelmezett érték.
- Nőtlen. Nulla elem vagy egy elem. Ezt az értéket akkor használja, ha a következő parancs csak egy bemeneti objektumot tud használni.
- Többszörös. 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 Multiple é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.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| 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
Megadja a Out-GridView ablak címsorában megjelenő szöveget.
Alapértelmezés szerint a címsor megjeleníti a parancsot, amely meghívja 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 visszatér az Out-GridView ablak megnyitásakor.
Ez a funkció lehetővé teszi a Out-GridView parancsmagok használatát Windows-parancsikonokban. Ha Out-GridView a Wait paraméter nélküli parancsikonban használja, a Out-GridView ablak csak pillanatnyira jelenik meg, mielőtt a Windows PowerShell bezárul.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| 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
Bármilyen objektumot elküldhet ennek a parancsmagnak.
Kimenetek
None
Out-GridView nem ad vissza objektumokat.
Jegyzetek
A Windows PowerShell 2.0-ban a Out-GridView parancsmag alapértelmezés szerint telepítve van a Windows ügyfélverzióira, de választható funkció a Windows kiszolgálói verzióiban. A Windows PowerShell 3.0-ban alapértelmezés szerint minden rendszerre telepítve van. Ha azonban kikapcsolja vagy eltávolítja a Windows PowerShell integrált parancsprogram-kezelési környezet funkciót, az Out-GridView parancsmag is ki lesz kapcsolva vagy el lesz távolítva.
Nem használhat távoli parancsot egy rácsnézet ablakának megnyitásához egy másik számítógépen.
Az Out-GridView parancsnak küldött parancskimenet nem formázható, például a Format-Table vagy a Format-Wide parancsmag 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 Out-GridView
Az alábbi billentyűparancsokkal számos feladatot gyorsan elvégezhet.
Használja ezt a billentyűt: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ázatba és vissza.
FEL NYÍL Egy sor felfelé. Az oszlopfejlécekre kerül.
LE NYÍL Egy sor lelépése.
BALRA NYÍL Az oszlopfejléc sorában mozgassa balra az egyik oszlopot.
JOBBRA NYÍL Az oszlopfejléc sorában mozgassa jobbra az egyik oszlopot.
HELYI MENÜ BILLENTYŰ Az oszlopfejlécsorban megjelenik az Oszlopok kiválasztása 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
A következő témakörök az Out-GridView által megjelenített ablak szolgáltatásainak használatát ismertetik.
Oszlopok elrejtése, megjelenítése és átrendezése
Oszlop elrejtése vagy megjelenítése:
Kattintson a jobb gombbal bármelyik oszlopfejlécre, majd kattintson az Oszlopok kiválasztása parancsra.
2. Az Válassza ki az oszlopokat párbeszédpanelen a nyílbillentyűkkel helyezze át az oszlopokat a Kiválasztott oszlopok a Elérhető oszlopok dobozok. A rácsnézet ablakában csak a Kijelölt oszlopok mező oszlopai jelennek meg.
Oszlopok átrendezése:
Húzza az oszlopot a kívánt helyre.
vagy-
Kattintson a jobb gombbal bármelyik oszlopfejlécre, majd kattintson az Oszlopok kiválasztása parancsra.
2. Az Válassza ki az oszlopokat párbeszédpanelen használja a Mozgás felfelé és Mozgás lefelé gombokat az oszlopok átrendezéséhez. 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 kattintson a sorra, 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. Az Out-GridView megjeleníti az összes szót tartalmazó sorokat (logikai ÉS).
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. Az Out-GridView megjeleníti azokat a sorokat, amelyek pontosan egyeznek a kifejezéssel.
Keresés oszlopokban. Ha egy vagy több oszlopban szeretne szöveget keresni, használja a következő formátumot:
<oszlop>:<szöveg> [<oszlop>:<szöveg>] ...
Ha például a DisplayName oszlopban a "Net" szót szeretné megkeresni, a Szűrő mezőbe írja be a következőt:
megjelenítendő név:net
Ha a DisplayName és a Name oszlopban a "Net" szót tartalmazó sorokat szeretné keresni, írja be a következőt:
displayname:net név:net
- Kapcsolja ki a keresést. A teljes táblázat újbóli megjelenítéséhez kattintson a Szűrő mező jobb felső sarkában található 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 összes feltételnek. 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ő:
<oszlop><operátor><érték>
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 Kritériumok hozzáadása menü gomb megjelenítéséhez az ablak jobb felső sarkában kattintson a gombra Bontsa ki nyíl.
2. Kattintson a Kritériumok 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 végzett a tulajdonságok kiválasztásával, 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ételek 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 kattintással válasszon ki egy 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.