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
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 tabeli interakcyjnej.
Ponieważ to polecenie cmdlet wymaga interfejsu użytkownika, nie działa w instalacjach Server Core systemu Windows Server.
Aby sprawdzić dane, możesz użyć następujących funkcji tabeli:
- Ukryj, Pokaż i Zmień kolejność kolumn: Aby ukryć, pokazać lub zmienić kolejność kolumny, kliknij prawym przyciskiem myszy nagłówek kolumny, a następnie kliknij pozycję Wybierz kolumny.
- Sortowania. Aby posortować dane, kliknij nagłówek kolumny. Kliknij ponownie, aby przełączyć się z kolejności rosnącej na malejącą.
- Szybki filtr. Użyj pola Filtr w górnej części okna, aby wyszukać tekst w tabeli. Możesz wyszukać tekst w określonej kolumnie, wyszukać literały i wyszukać wiele wyrazów.
- Filtr kryteriów. Użyj menu rozwijanego Dodaj kryteria, aby utworzyć reguły w celu filtrowania danych. Jest to bardzo przydatne w przypadku bardzo dużych zestawów danych, takich jak dzienniki zdarzeń.
- Skopiuj i wklej. Aby skopiować wiersze danych z elementu Out-GridView, naciśnij klawisze CTRL+C (kopiuj). Dane można wkleić do dowolnego programu tekstowego lub kalkulacyjnego.
Aby uzyskać instrukcje dotyczące korzystania z tych funkcji, wpisz Get-Help Out-GridView -Full i zobacz How to Use the Grid View Window Features (Jak używać funkcji okna widoku siatki) w sekcji Uwagi.
Przykłady
Przykład 1. Procesy wyjściowe w widoku siatki
PS C:\> Get-Process | Out-GridViewTo polecenie pobiera procesy uruchomione na komputerze lokalnym i wysyła je do okna widoku siatki.
Przykład 2. Używanie zmiennej do przetwarzania danych wyjściowych w widoku siatki
PS C:\> $P = Get-Process
PS C:\> $P | Out-GridViewTo polecenie pobiera również procesy uruchomione na komputerze lokalnym i wysyła je do okna widoku siatki.
Pierwsze polecenie używa polecenia cmdlet Get-Process do pobierania procesów na komputerze, a następnie zapisuje obiekty procesu w zmiennej $P.
Drugie polecenie używa operatora potoku do wysyłania zmiennej $P do elementu Out-GridView.
Przykład 3. Wyświetlanie sformatowanej tabeli w widoku siatki
PS C:\> Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet | Sort-Object -Property WorkingSet -Descending | Out-GridViewTo polecenie wyświetla sformatowaną tabelę w oknie widoku siatki.
Używa Get-Process polecenia cmdlet do pobierania procesów na komputerze.
Następnie używa operatora potoku (|) do wysyłania obiektów procesu do polecenia cmdlet Select-Object. Polecenie używa parametru Property elementu Select-Object , aby wybrać właściwości Name, WorkingSet i PeakWorkingSet, które mają być wyświetlane w tabeli.
Inny operator potoku wysyła odfiltrowane obiekty do polecenia cmdlet Sort-Object, które sortuje je w kolejności malejącej według wartości właściwości WorkingSet .
Ostatnia część polecenia używa operatora potoku (|) do wysyłania sformatowanej tabeli do elementu 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 wyświetlanie widoku siatki
PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | Out-GridViewTo polecenie zapisuje dane wyjściowe w zmiennej i wysyła je do elementu Out-GridView.
Polecenie używa polecenia cmdlet Get-ChildItem, aby pobrać pliki w katalogu instalacyjnym Windows PowerShell i jego podkatalogach. Ścieżka do katalogu instalacyjnego jest zapisywana w zmiennej automatycznej $pshome.
Polecenie używa operatora przypisania (=), aby zapisać dane wyjściowe w zmiennej $A i operator potoku (|) w celu wysłania danych wyjściowych do elementu Out-GridView.
Nawiasy w poleceniu określają kolejność operacji. W rezultacie dane wyjściowe polecenia Get-ChildItem są zapisywane w zmiennej $A przed wysłaniem ich do elementu Out-GridView.
Przykład 5. Procesy wyjściowe dla określonego komputera w widoku siatki
PS C:\> Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"To polecenie wyświetla procesy uruchomione na komputerze Server01 w oknie widoku siatki.
Polecenie używa ogvpolecenia , który jest wbudowanym aliasem polecenia cmdlet Out-GridView , używa parametru Title do określenia tytułu okna.
Przykład 6. Dane wyjściowe z komputerów zdalnych do widoku siatki
PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridViewW tym przykładzie przedstawiono poprawny format wysyłania danych zebranych z komputerów zdalnych do polecenia cmdlet Out-GridView .
Polecenie używa polecenia cmdlet Invoke-Command do uruchamiania polecenia Get-Culture na trzech komputerach zdalnych. Używa operatora potoku do wysyłania danych zwracanych do polecenia cmdlet Out-GridView .
Zwróć uwagę, że blok skryptu zawierający polecenia uruchamiane zdalnie 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 Out-GridView
PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csvTo polecenie umożliwia wybranie wielu procesów w oknie Out-GridView . Wybrane procesy są przekazywane do polecenia Export-Csv i zapisywane w pliku ProcessLog.csv.
Polecenie używa parametru PassThru elementu Out-GridView, który 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: Twórca skrót systemu Windows do Out-GridView
PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"To polecenie pokazuje, jak za pomocą parametru Wait elementu Out-GridView utworzyć skrót systemu Windows do okna Out-GridView . Bez parametru Wait Windows PowerShell zostanie zamknięta zaraz po otwarciu okna Out-GridView, które zamknie okno Out-GridView niemal natychmiast.
Parametry
-InputObject
Określa, że polecenie cmdlet akceptuje dane wejściowe dla elementu Out-GridView.
Gdy używasz parametru InputObject do wysyłania kolekcji obiektów do elementu Out-GridView, funkcja 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 elementu Out-GridView.
| 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 żadnego wyniku. 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.
- Brak. Brak elementów. Jest to wartość domyślna.
- Pojedynczy. Zero elementów lub jednego elementu. Użyj tej wartości, gdy następne polecenie może przyjmować tylko jeden obiekt wejściowy.
- Wielu. 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 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 interakcyjnego w dół potoku jako dane wejściowe do innych poleceń. Domyślnie to polecenie cmdlet nie generuje żadnego wyniku. 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 jest kliknięcie klawiszy Shift i kliknięcie klawiszy Ctrl.
Ten parametr został wprowadzony w Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Title
Określa tekst wyświetlany na pasku tytułu okna Out-GridView .
Domyślnie pasek tytułu wyświetla polecenie, które wywołuje element Out-GridView.
| 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 zamknięcie 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 element Out-GridView jest używany w skrótie bez parametru Wait, okno Out-GridView jest wyświetlane tylko chwilowo przed zamknięciem Windows PowerShell.
Ten parametr został wprowadzony w Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Dane wejściowe
Dowolny obiekt można wysłać do tego polecenia cmdlet.
Dane wyjściowe
None
Funkcja Out-GridView nie zwraca żadnych obiektów.
Uwagi
W Windows PowerShell 2.0 polecenie cmdlet Out-GridView jest instalowane domyślnie w wersjach klienckich systemu Windows, ale jest opcjonalną funkcją w wersjach systemu Windows server. W systemie Windows PowerShell 3.0 jest on instalowany domyślnie we wszystkich systemach. Jeśli jednak wyłączysz lub usuniesz funkcję Windows PowerShell ISE, polecenie cmdlet Out-GridView zostanie również wyłączone lub usunięte.
Nie można użyć zdalnego polecenia, aby otworzyć okno widoku siatki na innym komputerze.
Nie można sformatować danych wyjściowych polecenia wysyłanych do elementu Out-GridView , na przykład za pomocą poleceń 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 dla Out-GridView
Korzystając z poniższych skrótów klawiaturowych, można szybko wykonywać wiele zadań.
Użyj tego klucza: Aby wykonać tę akcję:
KARTA przenosi kursor z pola Filtr do menu Dodaj kryteria do tabeli i z powrotem.
STRZAŁKA W GÓRĘ Przenieś w górę jeden wiersz. Spowoduje przejście do nagłówków kolumn.
STRZAŁKA W DÓŁ Przenieś w dół jeden wiersz.
STRZAŁKA W LEWO W wierszu nagłówka kolumny przenieś lewą jedną kolumnę.
STRZAŁKA W PRAWO W wierszu nagłówka kolumny przenieś w prawo jedną kolumnę.
KLUCZ MENU KONTEKST W wierszu nagłówka kolumny wyświetla opcję Wybierz kolumny.
ENTER lub SPACEBAR W wierszu nagłówka kolumny posortuj dane kolumny (przełącz A-Z, Z-A).
Jak używać funkcji okna widoku siatki
W poniższych tematach wyjaśniono, jak używać funkcji okna wyświetlanego przez element Out-GridView .
Jak ukryć, pokazać i zmienić kolejność kolumn
Aby ukryć lub pokazać kolumnę:
Kliknij prawym przyciskiem myszy dowolny nagłówek kolumny i kliknij pozycję Wybierz kolumny.
2. W oknie dialogowym Wybieranie kolumn użyj klawiszy strzałek, aby przenieść kolumny między kolumnami Wybrane do pól Dostępne kolumny. W oknie widoku siatki są wyświetlane tylko kolumny w polu Wybrane kolumny.
Aby zmienić kolejność kolumn:
Przeciągnij i upuść kolumnę w żądanej lokalizacji.
Lub-
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, ponownie kliknij 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, kliknij 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, klikając wiersze lub używając klawiszy strzałek.
Aby wybrać niebezpieczone wiersze, 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 Search w tabeli (szybki filtr)
Użyj pola Filtr, aby wyszukać dane w tabeli. Podczas wpisywania w polu są wyświetlane tylko elementy zawierające wpisany tekst w tabeli.
Search dla tekstu. Aby wyszukać tekst w tabeli, w polu Filtr wpisz tekst do znalezienia.
Search dla wielu wyrazów. Aby wyszukać wiele wyrazów w tabeli, wpisz wyrazy rozdzielone spacjami. Funkcja Out-GridView wyświetla wiersze zawierające wszystkie wyrazy (logiczne AND).
Search dla fraz literału. Aby wyszukać frazy zawierające spacje lub znaki specjalne, należy ująć frazę w cudzysłów. Element Out-GridView wyświetla wiersze zawierające dokładne dopasowanie frazy.
Search 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 .NET Framework typów tych właściwości.
Każde kryterium ma następujący format:
<wartość operatora><kolumny><>
Kryteria dla różnych właściwości są połączone przez usługę 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 kliknij, aby wybrać innego operatora 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.