Out-GridView
Odešle výstup do interaktivní tabulky v samostatném okně.
Syntax
PassThru (Výchozí)
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
Tato rutina je dostupná jenom na platformě Windows.
Rutina Out-GridView odešle výstup z příkazu do okna zobrazení mřížky, kde se výstup zobrazí v interaktivní tabulce.
Vzhledem k tomu, že tato rutina vyžaduje uživatelské rozhraní, nefunguje na Windows Serveru Core nebo Windows Nano Serveru.
K prozkoumání dat můžete použít následující funkce tabulky:
- Skrytí, zobrazení a změna pořadí sloupců
- Řazení řádků
- Rychlý filtr
- Přidání filtru kritérií
- Kopírování a vkládání
Úplné pokyny najdete v části Poznámky tohoto článku.
Poznámka:
Tato rutina byla znovu zavedena v PowerShellu 7. Tato rutina je dostupná jenom v systémech Windows, které podporují Windows Desktop. Informace o multiplatformní verzi této rutiny najdete v modulu ConsoleGuiTools v Galerie prostředí PowerShell.
Příklady
Příklad 1: Výstupní procesy do zobrazení mřížky
Tento příklad získá procesy spuštěné v místním počítači a odešle je do okna zobrazení mřížky.
Get-Process | Out-GridView
Příklad 2: Použití proměnné k výstupu procesů do zobrazení mřížky
Tento příklad také získá procesy spuštěné v místním počítači a odešle je do okna zobrazení mřížky.
$P = Get-Process
$P | Out-GridView
Výstup rutiny Get-Process se uloží do $P proměnné.
$P Pak se předá Out-GridView.
Příklad 3: Zobrazení vybraných vlastností v zobrazení mřížky
Tento příklad zobrazuje vybrané vlastnosti spuštěných procesů v zobrazení mřížky.
Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
Sort-Object -Property WorkingSet -Descending | Out-GridView
Get-Process Výstupem je kanál pro Select-Object výběr vlastností Name, WorkingSet a PeakWorkingSet. Jiný operátor kanálu odešle filtrované objekty do Sort-Object rutiny, aby je seřadil sestupně podle hodnoty WorkingSet vlastnost.
Potom se seřazené výsledky předávají na Out-GridView. Funkce zobrazení mřížky teď můžete použít k vyhledávání, řazení a filtrování dat.
Příklad 4: Uložení výstupu do proměnné a výstup zobrazení mřížky
Tento příklad uloží výstup rutiny do proměnné a pak ji odešle do Out-GridView.
($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView
Get-ChildItem získá všechny soubory v instalačním adresáři PowerShellu a jeho podadresářích pomocí $PSHOME automatické proměnné. Závorky v příkazu navazují pořadí operací. V důsledku toho se výstup příkazu Get-ChildItem uloží do $A proměnné před odesláním do Out-GridView.
Příklad 5: Výstupní procesy pro zadaný počítač do zobrazení mřížky
Tento příklad zobrazí procesy spuštěné na počítači Server01 v okně zobrazení mřížky.
Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"
Příklad používá ogv, což je alias pro rutinu Out-GridView . Parametr Title určuje název okna.
Příklad 6: Výstup dat ze vzdálených počítačů do zobrazení mřížky
Tento příklad ukazuje, jak odesílat data shromážděná ze vzdálených počítačů do Out-GridView.
Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView
Invoke-Command běží Get-Culture na třech vzdálených počítačích. Výsledná data se předá .Out-GridView Všimněte si, že blok skriptu, který běží na vzdáleném počítači, neobsahuje Out-GridView příkaz. Pokud ano, příkaz se nezdaří, když se pokusí otevřít okno zobrazení mřížky na všech vzdálených počítačích.
Příklad 7: Předání více položek přes Out-GridView
V tomto příkladu Out-GridView můžete v okně vybrat více procesů. Vybrané procesy se předají Export-Csv příkazu a zapíšou se ProcessLog.csv do souboru.
Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv
Parametr umožňuje odeslat do kanálu více položek. Parametr
Příklad 8: Vytvoření zástupce systému Windows pro Out-GridView
Tento příklad ukazuje, jak pomocí parametru vytvořit zástupce systému Windows v Out-GridView okně.
pwsh -Command "Get-Service | Out-GridView -Wait"
Tento příkazový řádek lze použít v zástupce systému Windows. Bez parametru Wait se PowerShell ukončí hned po Out-GridView otevření okna, které zavře Out-GridView okno téměř okamžitě.
Parametry
-InputObject
Určuje objekt, který rutina přijímá jako vstup pro Out-GridView.
Když použijete InputObject parametr k odeslání kolekce objektů do Out-GridView, Out-GridView považuje kolekci za jeden objekt kolekce a zobrazí jeden řádek, který představuje kolekci. Chcete-li zobrazit každý objekt v kolekci, použijte operátor kanálu (|) k odeslání objektů do Out-GridView.
Vlastnosti parametru
| Typ: | PSObject |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-OutputMode
Určuje položky, které interaktivní okno odešle kanál jako vstup do jiných příkazů. Ve výchozím nastavení tato rutina negeneruje žádný výstup. Chcete-li odesílat položky z interaktivního okna v kanálu, kliknutím vyberte položky a klepněte na tlačítko OK.
Hodnoty tohoto parametru určují, kolik položek můžete kanál odeslat.
-
None. Žádné položky. Toto je výchozí hodnota. -
Single. Žádné položky nebo jedna položka. Tuto hodnotu použijte, když další příkaz může mít pouze jeden vstupní objekt. -
Multiple. Nula, jedna nebo mnoho položek. Tuto hodnotu použijte, když další příkaz může mít více vstupních objektů. Tato hodnota je ekvivalentní parametru Passthru.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | OutputModeOption |
| Default value: | None |
| Přípustné hodnoty: | None, Single, Multiple |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
OutputMode
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Označuje, že rutina odesílá položky z interaktivního okna v kanálu jako vstup do jiných příkazů. Ve výchozím nastavení tato rutina negeneruje žádný výstup. Tento parametr je ekvivalentní použití hodnoty Multiple parametru OutputMode.
Chcete-li odesílat položky z interaktivního okna v kanálu, kliknutím vyberte položky a klepněte na tlačítko OK. Podporují se klávesy Shift a ctrl.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
PassThru
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Title
Určuje text, který se zobrazí v záhlaví Out-GridView okna. Ve výchozím nastavení se v záhlaví zobrazí příkaz, který vyvolá Out-GridView.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Wait
Označuje, že rutina potlačí příkazový řádek a zabrání windows PowerShellu zavřít, dokud Out-GridView se okno neuzavře. Ve výchozím nastavení se příkazový řádek vrátí po Out-GridView otevření okna.
Tato funkce umožňuje používat Out-GridView rutiny v zkratkách systému Windows. Pokud Out-GridView se použije v zástupce bez parametru Wait , Out-GridView zobrazí se okno jen chvíli před zavření PowerShellu.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Wait
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
PSObject
K tomuto cmdletu můžete přesměrovat libovolný objekt.
Výstupy
None
Ve výchozím nastavení tato rutina nevrací žádný výstup.
PSObject
Pokud použijete parametr PassThru , tato rutina vrátí objekty představující vybrané řádky.
Poznámky
PowerShell obsahuje následující aliasy pro Out-GridView:
- Windows:
ogv
Tento cmdlet je dostupný pouze na platformách Windows. Tento cmdlet je dostupný pouze na platformách Windows.
Vzdálený příkaz nelze použít k otevření okna zobrazení mřížky na jiném počítači.
Výstup příkazu, do Out-GridView kterého odesíláte, nelze naformátovat pomocí Format rutin, jako Format-Table jsou rutiny nebo Format-Wide rutiny. K výběru vlastností použijte rutinu Select-Object .
Deserializovaný výstup ze vzdálených příkazů nemusí být v okně zobrazení mřížky správně naformátovaný.
Klávesové zkratky proOut-GridView
| Použijte tento klíč: | Provedení této akce: |
|---|---|
| Tab | Přesune kurzor z pole Filtr do nabídky Přidat kritéria do tabulky a zpět. |
| UpArrow | Přesunutí o jeden řádek nahoru Přesune se do záhlaví sloupců z prvního řádku dat. |
| DownArrow | Přesunutí o jeden řádek dolů |
| LeftArrow | V řádku záhlaví sloupce přesuňte jeden sloupec doleva. |
| RightArrow | V řádku záhlaví sloupce přesuňte jeden sloupec doprava. |
| ContextMenuKey | V řádku záhlaví sloupce se zobrazí možnost Vybrat sloupce. |
| Enter nebo mezerník | V řádku záhlaví sloupce seřaďte data sloupců (přepněte A-Z, Z-A). |
Jak používat funkce okna zobrazení mřížky
Skrytí nebo zobrazení sloupce:
- Klikněte pravým tlačítkem myši na libovolné záhlaví sloupce a klikněte na Vybrat sloupce.
- V dialogovém okně Vybrat sloupce pomocí šipkových kláves přesuňte sloupce mezi vybranými sloupci do polí Dostupné sloupce. V okně zobrazení mřížky se zobrazí jenom sloupce v poli Vybrat sloupce .
Změna pořadí sloupců:
Sloupce můžete přetáhnout do požadovaného umístění. Nebo použijte následující kroky:
- Klikněte pravým tlačítkem myši na libovolné záhlaví sloupce a klikněte na Vybrat sloupce.
- V dialogovém okně Vybrat sloupce pomocí tlačítek Přesunout nahoru a Dolů přeuspořádejte sloupce. Sloupce v horní části seznamu se zobrazí vlevo od sloupců v dolní části seznamu v okně zobrazení mřížky.
Řazení dat tabulky
- Pokud chcete data seřadit, klikněte na záhlaví sloupce.
- Pokud chcete změnit pořadí řazení, klikněte znovu na záhlaví sloupce. Pokaždé, když kliknete na stejné záhlaví, pořadí řazení se přepne mezi vzestupným a sestupným pořadím. Aktuální pořadí je označeno trojúhelníkem v záhlaví sloupce.
Výběr dat tabulky
- Pokud chcete vybrat řádek, vyberte ho nebo pomocí šipky nahoru nebo dolů přejděte na řádek.
- Pokud chcete vybrat všechny řádky (s výjimkou řádku záhlaví), stiskněte klávesu CTRL+A.
- Pokud chcete vybrat po sobě jdoucí řádky, stiskněte a podržte klávesu SHIFT a klikněte na řádky nebo pomocí kláves se šipkami.
- Pokud chcete vybrat nekonektorické řádky, stiskněte klávesu CTRL a kliknutím přidejte řádek do výběru.
- Nemůžete vybrat sloupce a nemůžete vybrat celý řádek záhlaví sloupce.
Kopírování řádků
Pokud chcete z tabulky zkopírovat jeden nebo více řádků, vyberte řádky a stiskněte kombinaci kláves CTRL+C.
Data můžete vložit do libovolného textového nebo tabulkového programu. Nelze kopírovat sloupce nebo části řádků a řádek záhlaví sloupce nelze zkopírovat.
Hledání v tabulce (rychlý filtr)
Pomocí pole Filtr můžete hledat data v tabulce. Když do pole napíšete, zobrazí se v tabulce jenom položky, které obsahují zadaný text.
Vyhledejte text. Pokud chcete vyhledat text v tabulce, zadejte do pole Filtr text, který chcete najít.
Vyhledejte více slov. Pokud chcete vyhledat více slov v tabulce, zadejte slova oddělená mezerami.
Out-GridViewzobrazí řádky, které obsahují všechna slova (logická funkce AND).Vyhledejte literály. Pokud chcete vyhledat fráze, které obsahují mezery nebo speciální znaky, uzavřete ho do uvozovek.
Out-GridViewzobrazí řádky, které obsahují přesnou shodu pro frázi.Hledání ve sloupcích Pokud chcete hledat text v jednom nebo více sloupcích, použijte následující formát:
<column>:<text> [<column>:<text>] ...Pokud například chcete najít "Net" ve sloupci DisplayName , do pole Filtr zadejte:
displayname:netChcete-li najít řádky se "Net" ve sloupcích DisplayName a Name , zadejte do pole Filtr :
displayname:net name:netVypněte hledání. Pokud chcete znovu zobrazit celou tabulku, klikněte na červené tlačítko X v pravém horním rohu pole Filtr nebo odstraňte text z pole Filtr .
Použití kritérií k filtrování tabulky
K určení položek zobrazených v tabulce můžete použít pravidla nebo kritéria. Položky se zobrazí pouze tehdy, když splňují všechna kritéria, která vytvoříte. Dostupná kritéria jsou určena vlastnostmi objektů zobrazených v okně zobrazení mřížky a typy rozhraní .NET Framework těchto vlastností.
Každé kritérium má následující formát:
<column> <operator> <value>
Kritéria pro různé vlastnosti jsou propojena funkcí AND. Kritéria pro stejnou vlastnost jsou propojena pomocí or. Logické spojnice nelze změnit.
Kritéria mají vliv jenom na zobrazení. Neodstraní položky z tabulky.
Přidání kritérií
- Pokud chcete zobrazit tlačítko nabídky Přidat kritéria , klikněte v pravém horním rohu okna na šipku Rozbalit.
- Klikněte na tlačítko nabídky Přidat kritéria .
- Kliknutím vyberete sloupce (vlastnosti). Můžete vybrat jednu nebo více vlastností.
- Až vyberete vlastnosti, klikněte na tlačítko Přidat .
- Chcete-li zrušit doplňky, klikněte na tlačítko Storno.
- Pokud chcete přidat další kritéria, klikněte znovu na tlačítko Přidat kritéria .
Úprava kritéria
- Pokud chcete změnit operátor, klikněte na modrou hodnotu operátoru a pak v rozevíracím seznamu vyberte jiný operátor.
- Pokud chcete zadat nebo změnit hodnotu, zadejte do pole hodnota hodnotu. Pokud zadáte hodnotu, která není platná, zobrazí se ikona kruhového X. Pokud ji chcete odebrat, změňte hodnotu.
- Pokud chcete vytvořit příkaz OR , přidejte kritéria se stejnou vlastností.
Odstranění kritérií
- Pokud chcete odstranit vybraná kritéria, klikněte na červené X vedle každého kritéria.
- Pokud chcete odstranit všechna kritéria, klikněte na tlačítko Vymazat vše .