Udostępnij za pośrednictwem

Out-GridView

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

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-GridView

Przykł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-GridView

Dane 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-GridView

Dane 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-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 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-GridView

Invoke-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.csv

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

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 Out-GridView tytułu okna. Domyślnie na pasku tytułu jest wyświetlane polecenie, które wywołuje Out-GridViewpolecenie .

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSObject

Do tego polecenia cmdlet można przekazać dowolny obiekt.

Dane wyjściowe

None

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

PSObject

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 dla Out-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ę:

  1. Kliknij prawym przyciskiem myszy dowolny nagłówek kolumny i kliknij pozycję Wybierz kolumny.
  2. 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 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:

  1. Kliknij prawym przyciskiem myszy dowolny nagłówek kolumny i kliknij pozycję Wybierz kolumny.
  2. 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 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-GridView wyś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-GridView wyś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:net

    Aby znaleźć wiersze z wartością "Net" w kolumnach DisplayName i Name , w polu Filtr wpisz:

    displayname:net name:net

  • Wyłą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

  1. Aby wyświetlić przycisk menu Dodaj kryteria , w prawym górnym rogu okna kliknij strzałkę Rozwiń.
  2. Kliknij przycisk menu Dodaj kryteria.
  3. Kliknij, aby wybrać kolumny (właściwości). Możesz wybrać jedną lub wiele właściwości.
  4. Po zakończeniu wybierania właściwości kliknij przycisk Dodaj .
  5. Aby anulować dodatki, kliknij przycisk Anuluj.
  6. 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 .