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 Out-GridView cmdlet 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
- Szybkie filtrowanie
- Dodaj filtr kryteriów
- Kopiowanie i wklejanie
Aby uzyskać pełne instrukcje, zobacz sekcję Uwagi w tym artykule.
Uwaga
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 zapoznać się z wersją tego polecenia cmdlet dla wielu platform, zobacz moduł ConsoleGuiTools w Galeria 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 Get-Process polecenia cmdlet są zapisywane w zmiennej $P . $P Następnie następuje potok 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 polecenia Get-Process są przesyłane potokiem, aby Select-Object wybrać właściwości Name, WorkingSet i PeakWorkingSet . Inny operator potoku wysyła filtrowane obiekty do Sort-Object polecenia cmdlet, aby posortować je 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-GridViewelementu .
($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridViewGet-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 ich 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 ogvelementu , który jest aliasem Out-GridView polecenia cmdlet . 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-GridViewprogramu .
Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridViewInvoke-Command działa 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 Out-GridView polecenia . 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 z Out-GridView okna. Wybrane procesy są przekazywane do Export-Csv polecenia i zapisywane w ProcessLog.csv pliku.
Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csvParametr PassThru parametru Out-GridView umożliwia wysyłanie wielu elementów w dół potoku. Parametr PassThru jest równoważny z użyciem wartości Wiele parametru OutputMode .
Przykład 8. Tworzenie skrótu systemu Windows do elementu "Out-GridView"
W tym przykładzie pokazano, jak użyć parametru Wait polecenia , Out-GridView aby utworzyć skrót systemu Windows do Out-GridView okna.
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 Out-GridView okna, co spowoduje zamknięcie Out-GridView okna niemal natychmiast.
Parametry
-InputObject
Określa obiekt, który polecenie cmdlet przyjmuje jako dane wejściowe dla elementu 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 wysyłać obiekty do Out-GridViewobiektu .
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | OutputModeOption |
| Accepted values: | None, Single, Multiple |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 klawiszy Ctrl.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Title
Określa tekst wyświetlany na pasku Out-GridView tytułu okna. Domyślnie na pasku tytułu jest wyświetlane polecenie, które wywołuje Out-GridViewpolecenie .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Wait
Wskazuje, że polecenie cmdlet pomija wiersz polecenia i uniemożliwia zamykanie programu Windows PowerShell do momentu Out-GridView zamknięcia okna. Domyślnie wiersz polecenia jest zwracany po otwarciu Out-GridView okna.
Ta funkcja umożliwia używanie Out-GridView poleceń cmdlet w skrótach systemu Windows. Gdy Out-GridView jest używany w skrót bez parametru Wait , Out-GridView okno jest wyświetlane tylko chwilowo przed zamknięciem programu PowerShell.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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łanego do Out-GridView nie mogą być sformatowane przy użyciu Format poleceń cmdlet, takich jak Format-Table lub Format-Wide polecenia cmdlet. Aby wybrać właściwości, użyj Select-Object polecenia cmdlet .
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 Filtr do menu Dodaj kryteria do tabeli i z powrotem. |
| Warrow | Przenieś w górę jeden wiersz. Przechodzi do nagłówków kolumn z pierwszego wiersza danych. |
| DownArrow | Przenieś w dół jeden wiersz. |
| LeftArrow | W wierszu nagłówka kolumny przenieś lewą kolumnę w lewo. |
| Prawe prawe praw | W wierszu nagłówka kolumny przenieś w prawo jedną kolumnę. |
| ContextMenuKey | W wierszu nagłówka kolumny zostanie wyświetlona opcja Wybierz kolumny. |
| Wprowadź lub spację | 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 pozycję Wybierz kolumny.
- W oknie dialogowym Wybieranie kolumn użyj klawiszy 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 Wybieranie kolumn .
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 pozycję 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ć dane 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 klawisze CTRL+A.
- Aby wybrać kolejne wiersze, naciśnij i przytrzymaj klawisz SHIFT podczas klikania wierszy lub klawiszy strzałek.
- Aby zaznaczyć wiersze niezwiązane z zabezpieczeniami, naciśnij klawisz 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 klawisze 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, które zawierają 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 Filtr wpisz:
displayname:netAby znaleźć wiersze z wartością "Net" w kolumnach DisplayName i Name , w polu Filtr wpisz:
displayname:net name:netWyłącz wyszukiwanie. Aby ponownie wyświetlić całą tabelę, kliknij czerwony przycisk X w prawym górnym rogu pola Filtr lub usuń tekst z pola Filtr .
Filtrowanie tabeli przy użyciu kryteriów
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ć dodatki, 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ść wszystko .
Linki powiązane
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla