Sdílet prostřednictvím


Out-GridView

Odešle výstup do interaktivní tabulky v samostatném okně.

Syntaxe

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

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ů
  • Řadit řádky
  • 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 vyvolána 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 Out-GridView PassThru umožňuje odeslat do kanálu více položek. Parametr PassThru je ekvivalentní použití multiple hodnoty OutputMode parametru.

Příklad 8: Vytvoření zástupce systému Windows pro Out-GridView

Tento příklad ukazuje, jak pomocí parametru Out-GridView Čekání 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.

Typ:PSObject
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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. Tato hodnota je výchozí.
  • 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.

Typ:OutputModeOption
Přípustné hodnoty:None, Single, Multiple
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í více hodnot 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.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSObject

Do této rutiny můžete převést 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

Tato rutina je dostupná jenom na platformách Windows. Tato rutina je dostupná jenom 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 pro Out-GridView

Použijte tento klíč: Provedení této akce:
Tabulátor 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:

  1. Klikněte pravým tlačítkem myši na libovolné záhlaví sloupce a klikněte na Vybrat sloupce.
  2. 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:

  1. Klikněte pravým tlačítkem myši na libovolné záhlaví sloupce a klikněte na Vybrat sloupce.
  2. 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-GridView zobrazí řá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-GridView zobrazí řá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:net

    Chcete-li najít řádky se "Net" ve sloupcích DisplayName a Name , zadejte do pole Filtr :

    displayname:net name:net

  • Vypně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í

  1. Pokud chcete zobrazit tlačítko nabídky Přidat kritéria , klikněte v pravém horním rohu okna na šipku Rozbalit.
  2. Klikněte na tlačítko nabídky Přidat kritéria .
  3. Kliknutím vyberete sloupce (vlastnosti). Můžete vybrat jednu nebo více vlastností.
  4. Až vyberete vlastnosti, klikněte na tlačítko Přidat .
  5. Chcete-li zrušit doplňky, klikněte na tlačítko Storno.
  6. 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 .