Out-GridView
Wysyła dane wyjściowe do interaktywnej tabeli w osobnym oknie.
Składnia
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>] Opis
To polecenie cmdlet jest dostępne tylko na platformie Windows.
Polecenie cmdlet Out-GridView wysyła dane wyjściowe z polecenia do okna widoku siatki, w którym dane wyjściowe są wyświetlane w interaktywnej tabeli.
Ponieważ to polecenie cmdlet wymaga interfejsu użytkownika, nie działa w systemie Windows Server Core lub Windows Nano Server.
Do zbadania danych można użyć następujących funkcji tabeli:
- Ukryj, pokaż i zmień kolejność kolumn
- Sortowanie wierszy
- Szybki filtr
- Dodaj filtr kryteriów
- Kopiowanie i wklejanie
Aby uzyskać pełne instrukcje, zobacz sekcję Notes tego artykułu.
Nuta
To polecenie cmdlet zostało ponownie wprowadzone w programie PowerShell 7. To polecenie cmdlet jest dostępne tylko w systemach Windows, które obsługują program Windows Desktop. Aby uzyskać wieloplatformową wersję tego polecenia cmdlet, zobacz moduł ConsoleGuiTools w galerii programu PowerShell.
Przykłady
Przykład 1: Przetwarzanie danych wyjściowych w widoku siatki
Ten przykład pobiera procesy uruchomione na komputerze lokalnym i wysyła je do okna widoku siatki.
Get-Process | Out-GridViewPrzykład 2. Używanie zmiennej do wyprowadzania procesów do widoku siatki
Ten przykład pobiera również procesy uruchomione na komputerze lokalnym i wysyła je do okna widoku siatki.
$P = Get-Process
$P | Out-GridViewDane wyjściowe polecenia cmdlet Get-Process są zapisywane w zmiennej $P. Następnie $P jest potokowany do Out-GridView.
Przykład 3. Wyświetlanie wybranych właściwości w widoku siatki
W tym przykładzie przedstawiono wybrane właściwości uruchomionych procesów w widoku siatki.
Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
Sort-Object -Property WorkingSet -Descending | Out-GridViewDane wyjściowe Get-Process są przesyłane potokiem do Select-Object, aby wybrać właściwości Name, WorkingSeti PeakWorkingSet. Inny operator potoku wysyła filtrowane obiekty do polecenia cmdlet Sort-Object w celu sortowania ich w kolejności malejącej według wartości właściwości WorkingSet.
Następnie posortowane wyniki są przesyłane potokami do Out-GridView. Teraz możesz używać funkcji widoku siatki do wyszukiwania, sortowania i filtrowania danych.
Przykład 4. Zapisywanie danych wyjściowych w zmiennej, a następnie wyprowadzenie widoku siatki
W tym przykładzie dane wyjściowe polecenia cmdlet są zapisywane w zmiennej, a następnie wysyła je do Out-GridView.
($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView
Get-ChildItem pobiera wszystkie pliki w katalogu instalacyjnym programu PowerShell i jego podkatalogach przy użyciu zmiennej automatycznej $PSHOME. Nawiasy w poleceniu określają kolejność operacji. W związku z tym dane wyjściowe polecenia Get-ChildItem są zapisywane w zmiennej $A przed wysłaniem do Out-GridView.
Przykład 5. Procesy wyjściowe dla określonego komputera w widoku siatki
W tym przykładzie przedstawiono procesy uruchomione na komputerze Server01 w oknie widoku siatki.
Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"W przykładzie użyto ogv, który jest aliasem polecenia cmdlet Out-GridView. Parametr Title określa tytuł okna.
Przykład 6. Dane wyjściowe z komputerów zdalnych do widoku siatki
W tym przykładzie pokazano, jak wysyłać dane zebrane z komputerów zdalnych do Out-GridView.
Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView
Invoke-Command uruchamia Get-Culture na trzech komputerach zdalnych. Wynikowe dane są przesyłane potokami do Out-GridView. Zwróć uwagę, że blok skryptu uruchamiany na komputerze zdalnym nie zawiera polecenia Out-GridView. Jeśli tak się stanie, polecenie zakończy się niepowodzeniem, gdy podjęto próbę otwarcia okna widoku siatki na każdym z komputerów zdalnych.
Przykład 7. Przekazywanie wielu elementów za pośrednictwem elementu "Out-GridView"
W tym przykładzie można wybrać wiele procesów w oknie Out-GridView. Wybrane procesy są przekazywane do polecenia Export-Csv i zapisywane w pliku ProcessLog.csv.
Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csvParametr
Przykład 8. Tworzenie skrótu systemu Windows do elementu "Out-GridView"
W tym przykładzie pokazano, jak utworzyć skrót systemu Windows do okna za pomocą parametru Out-GridViewOut-GridView.
pwsh -Command "Get-Service | Out-GridView -Wait"Ten wiersz polecenia może być używany w skrótach systemu Windows. Bez parametru Wait program PowerShell zostanie zamknięty natychmiast po otwarciu okna Out-GridView, co spowoduje zamknięcie okna Out-GridView niemal natychmiast.
Parametry
-InputObject
Określa obiekt, który polecenie cmdlet przyjmuje jako dane wejściowe dla Out-GridView.
Gdy używasz parametru InputObject do wysyłania kolekcji obiektów do Out-GridView, Out-GridView traktuje kolekcję jako jeden obiekt kolekcji i wyświetla jeden wiersz reprezentujący kolekcję. Aby wyświetlić każdy obiekt w kolekcji, użyj operatora potoku (|), aby wysłać obiekty do Out-GridView.
| Typ: | PSObject |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-OutputMode
Określa elementy, które okno interakcyjne wysyła potok jako dane wejściowe do innych poleceń. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych. Aby wysłać elementy z okna interaktywnego w dół potoku, kliknij, aby wybrać elementy, a następnie kliknij przycisk OK.
Wartości tego parametru określają liczbę elementów, które można wysłać w dół potoku.
-
None. Brak elementów. Jest to wartość domyślna. -
Single. Zero elementów lub jednego elementu. Użyj tej wartości, gdy następne polecenie może przyjąć tylko jeden obiekt wejściowy. -
Multiple. Zero, jeden lub wiele elementów. Użyj tej wartości, gdy następne polecenie może przyjmować wiele obiektów wejściowych. Ta wartość jest równoważna parametrowi Passthru.
Ten parametr został wprowadzony w programie Windows PowerShell 3.0.
| Typ: | OutputModeOption |
| Dopuszczalne wartości: | None, Single, Multiple |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PassThru
Wskazuje, że polecenie cmdlet wysyła elementy z okna interaktywnego w dół potoku jako dane wejściowe do innych poleceń. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych. Ten parametr jest równoważny z użyciem wartości wiele parametru OutputMode.
Aby wysłać elementy z okna interaktywnego w dół potoku, kliknij, aby wybrać elementy, a następnie kliknij przycisk OK. Obsługiwane są kliknięcia i naciśnięcie Ctrl.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Title
Określa tekst wyświetlany na pasku tytułu okna Out-GridView. Domyślnie na pasku tytułu jest wyświetlane polecenie, które wywołuje Out-GridView.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Wait
Wskazuje, że polecenie cmdlet pomija wiersz polecenia i uniemożliwia zamykanie programu Windows PowerShell do momentu zamknięcia okna Out-GridView. Domyślnie wiersz polecenia jest zwracany po otwarciu okna Out-GridView.
Ta funkcja umożliwia używanie poleceń cmdlet Out-GridView w skrótach systemu Windows. Gdy Out-GridView jest używany w skrótie bez parametru Wait, okno Out-GridView jest wyświetlane tylko chwilowo przed zamknięciem programu PowerShell.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Do tego polecenia cmdlet można przekazać dowolny obiekt.
Dane wyjściowe
None
Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Jeśli używasz parametru PassThru, to polecenie cmdlet zwraca obiekty reprezentujące wybrane wiersze.
Uwagi
Program PowerShell zawiera następujące aliasy dla programu Out-GridView:
- Windows:
ogv
To polecenie cmdlet jest dostępne tylko na platformach windows. To polecenie cmdlet jest dostępne tylko na platformach windows.
Nie można użyć zdalnego polecenia, aby otworzyć okno widoku siatki na innym komputerze.
Dane wyjściowe polecenia wysyłane do Out-GridView nie mogą być sformatowane przy użyciu poleceń cmdlet Format, takich jak polecenia cmdlet Format-Table lub Format-Wide. Aby wybrać właściwości, użyj polecenia cmdlet Select-Object.
Deserializowane dane wyjściowe z poleceń zdalnych mogą nie być poprawnie sformatowane w oknie widoku siatki.
skróty klawiaturowe dlaOut-GridView
| Użyj tego klucza: | Aby wykonać tę akcję: |
|---|---|
| Zakładka | Przenosi kursor z pola filtru do menu Dodaj kryteria do tabeli i z powrotem. |
| |
Przenieś w górę jeden wiersz. Przechodzi do nagłówków kolumn z pierwszego wiersza danych. |
| DownArrow | Przenieś w dół jeden wiersz. |
| |
W wierszu nagłówka kolumny przenieś lewą kolumnę w lewo. |
| RightArrow | W wierszu nagłówka kolumny przenieś w prawo jedną kolumnę. |
| ContextMenuKey |
W wierszu nagłówka kolumny zostanie wyświetlona opcja Wybierz kolumny. |
| wprowadź lub spacji | W wierszu nagłówka kolumny posortuj dane kolumn (przełącznik A-Z, Z-A). |
Jak używać funkcji okna widoku siatki
Aby ukryć lub pokazać kolumnę:
- Kliknij prawym przyciskiem myszy dowolny nagłówek kolumny i kliknij Wybierz kolumny.
- W oknie dialogowym Wybieranie kolumn użyj strzałek, aby przenieść kolumny między zaznaczonymi kolumnami do pól Dostępne kolumny. W oknie widoku siatki są wyświetlane tylko kolumny w polu Wybierz kolumny.
Aby zmienić kolejność kolumn:
Kolumny można przeciągać i upuszczać w żądanej lokalizacji. Możesz też wykonać następujące czynności:
- Kliknij prawym przyciskiem myszy dowolny nagłówek kolumny i kliknij Wybierz kolumny.
- W oknie dialogowym Wybieranie kolumn użyj przycisków Przenieś w górę i Przenieś w dół, aby zmienić kolejność kolumn. Kolumny w górnej części listy są wyświetlane po lewej stronie kolumn w dolnej części listy w oknie widoku siatki.
Jak sortować dane tabeli
- Aby posortować dane, kliknij nagłówek kolumny.
- Aby zmienić kolejność sortowania, kliknij ponownie nagłówek kolumny. Za każdym razem, gdy klikniesz ten sam nagłówek, kolejność sortowania przełącza się między kolejnością rosnącą do malejącej. Bieżąca kolejność jest wskazywana przez trójkąt w nagłówku kolumny.
Jak wybrać danych tabeli
- Aby wybrać wiersz, wybierz wiersz lub użyj strzałki w górę lub w dół, aby przejść do wiersza.
- Aby zaznaczyć wszystkie wiersze (z wyjątkiem wiersza nagłówka), naciśnij CTRL+A.
- Aby wybrać kolejne wiersze, naciśnij i przytrzymaj SHIFT podczas klikania wierszy lub strzałek.
- Aby zaznaczyć wiersze niezwiązane z zabezpieczeniami, naciśnij ctrl
i kliknij, aby dodać wiersz do zaznaczenia. - Nie można wybrać kolumn i nie można wybrać całego wiersza nagłówka kolumny.
Jak skopiować wiersze
Aby skopiować jeden lub więcej wierszy z tabeli, zaznacz wiersze, a następnie naciśnij CTRL+C.
Dane można wkleić do dowolnego programu tekstowego lub kalkulacyjnego. Nie można kopiować kolumn lub części wierszy i nie można skopiować wiersza nagłówka kolumny.
Jak wyszukiwać w tabeli (szybki filtr)
Użyj pola Filtr, aby wyszukać dane w tabeli. Podczas wpisywania w polu w tabeli są wyświetlane tylko elementy zawierające wpisany tekst.
Wyszukaj tekst. Aby wyszukać tekst w tabeli, w polu Filtr wpisz tekst do znalezienia.
Wyszukaj wiele wyrazów. Aby wyszukać wiele wyrazów w tabeli, wpisz wyrazy rozdzielone spacjami.
Out-GridViewwyświetla wiersze zawierające wszystkie wyrazy (logiczne AND).Wyszukaj frazy literału. Aby wyszukać frazy zawierające spacje lub znaki specjalne, należy ująć frazę w znaki cudzysłowu.
Out-GridViewwyświetla wiersze zawierające dokładne dopasowanie frazy.Wyszukaj w kolumnach. Aby wyszukać tekst w co najmniej jednej kolumnie, użyj następującego formatu:
<column>:<text> [<column>:<text>] ...Aby na przykład znaleźć ciąg "Net" w kolumnie
DisplayName, w polu filtru wpisz: displayname:netAby znaleźć wiersze z wartością "Net" w kolumnach
DisplayName iName , w polu filtruwpisz: displayname:net name:netWyłącz wyszukiwanie. Aby ponownie wyświetlić całą tabelę, kliknij czerwony przycisk X w prawym górnym rogu pola filtru
filtru lub usuń tekst z pola filtru .
użyj kryteriów filtrowania tabeli
Możesz użyć reguł lub kryteriów, aby określić, które elementy są wyświetlane w tabeli. Elementy są wyświetlane tylko wtedy, gdy spełniają wszystkie ustanowione kryteria. Dostępne kryteria są określane przez właściwości obiektów wyświetlanych w oknie widoku siatki i typy programu .NET Framework tych właściwości.
Każde kryterium ma następujący format:
<column> <operator> <value>
Kryteria dla różnych właściwości są połączone przez AND. Kryteria dla tej samej właściwości są połączone przez OR. Nie można zmienić łączników logicznych.
Kryteria wpływają tylko na wyświetlanie. Nie usuwa elementów z tabeli.
Jak dodać kryteria
- Aby wyświetlić przycisk menu Dodaj kryteria, w prawym górnym rogu okna kliknij strzałkę Rozwiń.
- Kliknij przycisk menu Dodaj kryteria .
- Kliknij, aby wybrać kolumny (właściwości). Możesz wybrać jedną lub wiele właściwości.
- Po zakończeniu wybierania właściwości kliknij przycisk Dodaj.
- Aby anulować dodawanie, kliknij przycisk Anuluj.
- Aby dodać więcej kryteriów, kliknij ponownie przycisk Dodaj kryteria.
jak edytować kryterium
- Aby zmienić operator, kliknij niebieską wartość operatora, a następnie wybierz inny operator z listy rozwijanej.
- Aby wprowadzić lub zmienić wartość, wpisz wartość w polu wartości. Jeśli wprowadzisz nieprawidłową wartość, zostanie wyświetlona okrągła ikona X. Aby go usunąć, zmień wartość.
- Aby utworzyć instrukcję OR, dodaj kryteria z tą samą właściwością.
Jak usunąć kryteria
- Aby usunąć wybrane kryteria, kliknij czerwony znak X obok każdego kryterium.
- Aby usunąć wszystkie kryteria, kliknij przycisk wyczyść wszystkie
.