Out-GridView

Modul:

Microsoft.PowerShell.Utility

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

Rutina Out-GridView odešle výstup 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 instalacích jádra serveru systému Windows Server.

K prozkoumání dat můžete použít následující funkce tabulky:

• Skrýt, zobrazit a změnit pořadí sloupců: Chcete-li sloupec skrýt, zobrazit nebo změnit pořadí, klikněte pravým tlačítkem myši na záhlaví sloupce a potom klikněte na vybrat sloupce.
• Třídit. Pokud chcete data seřadit, klikněte na záhlaví sloupce. Dalším kliknutím přepnete z vzestupného na sestupné pořadí.
• Rychlý filtr. Pomocí pole Filtr v horní části okna můžete hledat text v tabulce. Můžete hledat text v určitém sloupci, hledat literály a hledat více slov.
• Filtr kritérií. Pomocí rozevírací nabídky Přidat kritéria vytvořte pravidla pro filtrování dat. To je velmi užitečné pro velmi velké datové sady, jako jsou protokoly událostí.
• Zkopírujte a vložte. Pokud chcete zkopírovat řádky dat z Out-GridView, stiskněte kombinaci kláves CTRL+C (kopírovat). Data můžete vložit do libovolného textového nebo tabulkového programu.

Pokyny k používání těchto funkcí najdete v části Poznámky tak, že zadáte Get-Help Out-GridView -Full a zjistíte, jak používat funkce okna zobrazení mřížky.

Příklady

Příklad 1: Výstupní procesy do zobrazení mřížky

PS C:\> Get-Process | Out-GridView

Tento příkaz získá procesy spuštěné v místním počítači a odešle je do okna zobrazení mřížky.

Příklad 2: Použití proměnné k výstupu procesů do zobrazení mřížky

PS C:\> $P = Get-Process
PS C:\> $P | Out-GridView

Tento příkaz také získá procesy spuštěné v místním počítači a odešle je do okna zobrazení mřížky.

První příkaz použije rutinu Get-Process k získání procesů v počítači a potom uloží objekty procesu do proměnné $P.

Druhý příkaz používá operátor kanálu k odeslání proměnné $P do Out-GridView.

Příklad 3: Zobrazení formátované tabulky v zobrazení mřížky

PS C:\> Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet | Sort-Object -Property WorkingSet -Descending | Out-GridView

Tento příkaz zobrazí formátovanou tabulku v okně zobrazení mřížky.

K získání procesů v počítači používá rutinu Get-Process.

Potom pomocí operátoru kanálu (|) odešle objekty procesu do rutiny Select-Object. Příkaz používá Vlastnost parametr Select-Object k výběru vlastností Name, WorkingSet a PeakWorkingSet, které se mají zobrazit v tabulce.

Jiný operátor kanálu odešle filtrované objekty do rutiny Sort-Object, která je seřadí sestupně podle hodnoty vlastnosti WorkingSet.

Poslední část příkazu používá operátor kanálu (|) k odeslání formátované tabulky do 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

PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | Out-GridView

Tento příkaz uloží výstup do proměnné a odešle ho do Out-GridView.

Příkaz používá rutinu Get-ChildItem k získání souborů v instalačním adresáři Windows PowerShellu a jeho podadresářích. Cesta k instalačnímu adresáři se uloží do $pshome automatické proměnné.

Příkaz pomocí operátoru přiřazení (=) uloží výstup do proměnné $A a operátoru kanálu (|) k odeslání výstupu do Out-GridView.

Závorky v příkazu navazují pořadí operací. Výsledkem je, že výstup příkazu Get-ChildItem je uložen v proměnné $A před odesláním do Out-GridView.

Příklad 5: Výstupní procesy pro zadaný počítač do zobrazení mřížky

PS C:\> Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

Tento příkaz zobrazí procesy spuštěné na počítači Server01 v okně zobrazení mřížky.

Příkaz používá ogv, což je integrovaný alias pro Out-GridView rutina, používá k zadání názvu okna parametr Title.

Příklad 6: Výstup dat ze vzdálených počítačů do zobrazení mřížky

PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

Tento příklad ukazuje správný formát pro odesílání dat shromážděných ze vzdálených počítačů do rutiny Out-GridView.

Příkaz používá rutinu Invoke-Command ke spuštění příkazu Get-Culture na třech vzdálených počítačích. Pomocí operátoru kanálu odešle data vrácená do rutiny Out-GridView.

Všimněte si, že blok skriptu, který obsahuje příkazy spouštěné vzdáleně, nezahrnuje příkaz Out-GridView. 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 Out-GridView

PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

Tento příkaz umožňuje vybrat více procesů z okna Out-GridView. Vybrané procesy se předají příkazu Export-Csv a zapíšou se do souboru ProcessLog.csv.

Příkaz používá parametr PassThruOut-GridView Out-GridView, který umožňuje odesílat více položek mimo kanál. Parametr PassThru je ekvivalentní použití více hodnot parametru OutputMode.

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

PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"

Tento příkaz ukazuje, jak pomocí parametru WaitOut-GridView vytvořit zástupce windows v okně Out-GridView. Bez parametru Wait se Prostředí Windows PowerShell ukončí, jakmile se otevře okno Out-GridView, které by zavřelo okno Out-GridView téměř okamžitě.

Parametry

-InputObject

Určuje, že rutina přijímá vstup pro Out-GridView.

Když použijete parametr InputObject 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 odesílá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.

• Žádný. Žádné položky. Toto je výchozí hodnota.
• Jednotlivý. Žádné položky nebo jedna položka. Tuto hodnotu použijte, když další příkaz může mít pouze jeden vstupní objekt.
• Mnohonásobný. 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 OutputMode parametru.

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.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	SwitchParameter
Position:	Named
Default value:	None
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í okna Out-GridView.

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 se okno Out-GridView zavře. Ve výchozím nastavení se příkazový řádek vrátí, když se otevře okno Out-GridView.

Tato funkce umožňuje používat rutiny Out-GridView ve zkratkách systému Windows. Když se Out-GridView použije v zástupce bez parametru Wait, zobrazí se okno Out-GridView jen chvíli předtím, než se Prostředí Windows PowerShell zavře.

Tento parametr byl představen ve Windows PowerShellu 3.0.

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

Vstupy

PSObject

Do této rutiny můžete odeslat libovolný objekt.

Výstupy

None

Out-GridView nevrací žádné objekty.

Poznámky

• Ve Windows PowerShellu 2.0 se ve výchozím nastavení nainstaluje rutina Out-GridView v klientských verzích Windows, ale je volitelná funkce ve verzích Serveru systému Windows. Ve Windows PowerShellu 3.0 je ve výchozím nastavení nainstalovaný ve všech systémech. Pokud ale funkci ISE windows PowerShellu vypnete nebo odeberete, rutina Out-GridView je také vypnutá nebo odebraná.

• Vzdálený příkaz nelze použít k otevření okna zobrazení mřížky na jiném počítači.

• Výstup příkazu, který odešlete do Out-GridView, nelze formátovat, například pomocí rutin Format-Table nebo Format-Wide. 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

  Pomocí následujícíchkláveschchch

  Použijte tento klíč:Chcete-li provést tuto akci:

  Tab Přesune kurzor z pole Filtr do nabídky Přidat kritéria do tabulky a zpět.

  ŠIPKA NAHORU se posune o jeden řádek nahoru. Přesune se do záhlaví sloupců.

  ŠIPKA DOLŮ se přesune o jeden řádek dolů.

  ŠIPKA VLEVO V řádku záhlaví sloupce přesuňte jeden sloupec doleva.

  ŠIPKA VPRAVO V řádku záhlaví sloupce přesuňte jeden sloupec doprava.

  KONTEXTOVÁ NABÍDKA KLÁVESA V řádku záhlaví sloupce zobrazí možnost Vybrat sloupce.

  ENTER nebo MEZERNÍK V řádku záhlaví sloupce seřaďte data sloupců (přepínač A-Z, Z-A).

  Jak používat funkce okna zobrazení mřížky

  Následující témata vysvětlují, jak používat funkce okna, které Out-GridView.

  Skrytí, zobrazení a změna pořadí sloupců

  Skrytí nebo zobrazení sloupce:

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í kláves se šipkami přesuňte sloupce mezi vybranými sloupci do polí Dostupné sloupce. V okně zobrazení mřížky se zobrazí jenom sloupce v poli Vybrané sloupce.

Změna pořadí sloupců:

• Přetáhněte sloupec do požadovaného umístění.

• nebo-

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 Přesunout 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, klikněte na řádek 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 kombinaci kláves 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:

< >sloupce:<text> [<sloupec>:<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 stanovená kritéria. 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:

> <operátor><sloupce><hodnotu

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. Chcete-li 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 vyberte sloupce (vlastnosti). Můžete vybrat jednu nebo více vlastností.

4. Po dokončení výběru vlastností klikněte na tlačítko Přidat.

5. Chcete-li zrušit doplňky, klepněte na tlačítko Storno.

6. Chcete-li 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 potom kliknutím vyberte jiný operátor z rozevíracího seznamu.

• 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.

Související odkazy

• Out-Default
• Out-File
• Out-Host
• Out-Null
• Out-Printer
• Out-String