Out-GridView
Odešle výstup do interaktivní tabulky v samostatném okně.
Syntaxe
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 .
