Out-GridView
Sendet die Ausgabe an eine interaktive Tabelle in einem separaten Fenster.
Syntax
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>] Beschreibung
Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Das Out-GridView Cmdlet sendet die Ausgabe eines Befehls an ein Rasteransichtsfenster, in dem die Ausgabe in einer interaktiven Tabelle angezeigt wird.
Da für dieses Cmdlet eine Benutzeroberfläche erforderlich ist, funktioniert es nicht unter Windows Server Core oder Windows Nano Server.
Sie können die folgenden Funktionen der Tabelle verwenden, um Ihre Daten zu überprüfen:
- Ausblenden, Anzeigen und Neuanordnen von Spalten
- Zeilen sortieren
- Schnellfilter
- Kriterienfilter hinzufügen
- Kopieren und Einfügen
Vollständige Anweisungen finden Sie im Abschnitt "Hinweise " dieses Artikels.
Hinweis
Dieses Cmdlet wurde in PowerShell 7 erneut eingeführt. Dieses Cmdlet ist nur auf Windows-Systemen verfügbar, die den Windows-Desktop unterstützen. Eine plattformübergreifende Version dieses Cmdlets finden Sie im Modul ConsoleGuiTools im PowerShell-Katalog.
Beispiele
Beispiel 1: Ausgabeprozesse in einer Rasteransicht
In diesem Beispiel werden die prozesse, die auf dem lokalen Computer ausgeführt werden, und sie werden an ein Rasteransichtsfenster gesendet.
Get-Process | Out-GridViewBeispiel 2: Verwenden einer Variablen zum Ausgeben von Prozessen in eine Rasteransicht
In diesem Beispiel werden auch die Prozesse auf dem lokalen Computer ausgeführt und an ein Rasteransichtsfenster gesendet.
$P = Get-Process
$P | Out-GridViewDie Ausgabe des Get-Process Cmdlets wird in der $P Variablen gespeichert. $P Anschließend wird an das Verleitungs-Shape Out-GridViewweitergeleitet.
Beispiel 3: Anzeigen einer ausgewählten Eigenschaft in einer Rasteransicht
In diesem Beispiel werden ausgewählte Eigenschaften der ausgeführten Prozesse in einer Rasteransicht angezeigt.
Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
Sort-Object -Property WorkingSet -Descending | Out-GridViewDie Ausgabe von Get-Process wird weitergeleitet, um Select-Object die Eigenschaften Name, WorkingSet und PeakWorkingSet auszuwählen. Ein anderer Pipelineoperator sendet die gefilterten Objekte an das Sort-Object Cmdlet, um sie in absteigender Reihenfolge nach dem Wert der WorkingSet-Eigenschaft zu sortieren.
Anschließend werden die sortierten Ergebnisse weitergeleitet an Out-GridView. Sie können nun die Funktionen der Rasteransicht verwenden, um die Daten zu durchsuchen, zu sortieren und zu filtern.
Beispiel 4: Speichern der Ausgabe in einer Variablen und anschließendes Ausgeben einer Rasteransicht
In diesem Beispiel wird die Cmdlet-Ausgabe in einer Variablen gespeichert, die sie dann an Out-GridViewsendet.
($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridViewGet-ChildItem ruft alle Dateien im PowerShell-Installationsverzeichnis und deren Unterverzeichnisse mithilfe der $PSHOME automatischen Variablen ab. Die Klammern im Befehl bestimmen die Reihenfolge der Vorgänge. Daher wird die Ausgabe des Get-ChildItem Befehls in der $A Variablen gespeichert, bevor sie gesendet Out-GridViewwird.
Beispiel 5: Ausgabeprozesse für einen angegebenen Computer in einer Rasteransicht
In diesem Beispiel werden die Prozesse angezeigt, die auf dem Server01-Computer in einem Rasteransichtsfenster ausgeführt werden.
Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"Im Beispiel wird der Alias für das Out-GridView Cmdlet verwendetogv. Der Parameter Title gibt den Fenstertitel an.
Beispiel 6: Ausgeben von Daten von Remotecomputern in eine Rasteransicht
In diesem Beispiel wird gezeigt, wie Daten gesendet werden, die von Remotecomputern gesammelt werden.Out-GridView
Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridViewInvoke-Command wird auf drei Remotecomputern ausgeführt Get-Culture . Die resultierenden Daten werden weitergeleitet an Out-GridView. Beachten Sie, dass der Skriptblock, der auf dem Remotecomputer ausgeführt wird, nicht den Out-GridView Befehl enthält. Wenn dies der Fall war, würde der Befehl bei dem Versuch fehlschlagen, ein Rasteransichtsfenster auf jedem Remotecomputer zu öffnen.
Beispiel 7: Übergeben mehrerer Elemente über 'Out-GridView'
In diesem Beispiel können Sie mehrere Prozesse aus dem Out-GridView Fenster auswählen. Die ausgewählten Prozesse werden an den Export-Csv Befehl übergeben und in die ProcessLog.csv Datei geschrieben.
Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csvMit dem PassThru-ParameterOut-GridView können Sie mehrere Elemente an die Pipeline senden. Der PassThru-Parameter entspricht der Verwendung des Multiple-Werts des OutputMode-Parameters .
Beispiel 8: Erstellen einer Windows-Verknüpfung mit "Out-GridView"
In diesem Beispiel wird gezeigt, wie Sie den Wait-ParameterOut-GridView verwenden, um eine Windows-Verknüpfung mit dem Out-GridView Fenster zu erstellen.
pwsh -Command "Get-Service | Out-GridView -Wait"Diese Befehlszeile kann in einer Windows-Verknüpfung verwendet werden. Ohne den Wait-Parameter würde PowerShell nach dem Öffnen des Out-GridView Fensters beendet, das das Out-GridView Fenster fast sofort schließt.
Parameter
-InputObject
Gibt das Objekt an, das das Cmdlet als Eingabe akzeptiert Out-GridView.
Wenn Sie den InputObject-Parameter verwenden, um eine Auflistung von Objekten an zu Out-GridViewsenden, Out-GridView behandelt die Auflistung als ein Auflistungsobjekt und zeigt eine Zeile an, die die Auflistung darstellt. Verwenden Sie zum Anzeigen der einzelnen Objekte in der Auflistung einen Pipelineoperator (|) zum Senden von Objekten an Out-GridView.
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OutputMode
Gibt die Elemente an, die das interaktive Fenster als Eingabe an andere Befehle sendet. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert. Um Elemente aus dem interaktiven Fenster über die Pipeline zu senden, klicken Sie auf die Elemente und dann auf „OK“.
Die Werte für diesen Parameter bestimmen, wie viele Elemente Sie über die Pipeline senden können.
None. Keine Elemente. Dies ist der Standardwert.Single. Ein Element oder null Elemente. Verwenden Sie diesen Wert, wenn der nächste Befehl nur jeweils ein Eingabeobjekt akzeptieren kann.Multiple. Null, eines oder viele Elemente. Verwenden Sie diesen Wert, wenn der nächste Befehl mehrere Eingabeobjekte akzeptieren kann. Dieser Wert entspricht dem Passthru-Parameter .
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
| Type: | OutputModeOption |
| Accepted values: | None, Single, Multiple |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Gibt an, dass das Cmdlet Elemente aus dem interaktiven Fenster in der Pipeline als Eingabe an andere Befehle sendet. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert. Dieser Parameter entspricht der Verwendung des Multiple-Werts des OutputMode-Parameters .
Um Elemente aus dem interaktiven Fenster über die Pipeline zu senden, klicken Sie auf die Elemente und dann auf „OK“. Das Klicken bei gedrückter UMSCHALTTASTE und STRG-TASTE wird unterstützt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Title
Gibt den Text an, der in der Titelleiste des Out-GridView Fensters angezeigt wird. Standardmäßig zeigt die Titelleiste den Befehl an, der aufgerufen wird Out-GridView.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Wait
Gibt an, dass das Cmdlet die Eingabeaufforderung unterdrückt und verhindert, dass Windows PowerShell geschlossen wird, bis das Out-GridView Fenster geschlossen wird. Standardmäßig wird die Eingabeaufforderung beim Öffnen des Out-GridView Fensters zurückgegeben.
Mit diesem Feature können Sie die Out-GridView Cmdlets in Windows-Verknüpfungen verwenden. Wenn Out-GridView es in einer Verknüpfung ohne den Wait-Parameter verwendet wird, wird das Out-GridView Fenster nur momentariell angezeigt, bevor PowerShell geschlossen wird.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Sie können jedes Objekt an dieses Cmdlet weiterleiten.
Ausgaben
None
Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.
Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet Objekte zurück, die die ausgewählten Zeilen darstellen.
Hinweise
PowerShell enthält die folgenden Aliase für Out-GridView:
- Windows:
ogv
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar. Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
Sie können keinen Remotebefehl verwenden, um ein Rasteransichtsfenster auf einem anderen Computer zu öffnen.
Die von Ihnen gesendete Out-GridView Befehlsausgabe kann nicht mithilfe der Format Cmdlets wie Format-Table z. B. Cmdlets Format-Wide formatiert werden. Verwenden Sie das Select-Object Cmdlet, um Eigenschaften auszuwählen.
Die deserialisierte Ausgabe von Remotebefehlen ist möglicherweise im Rasteransichtsfenster nicht ordnungsgemäß formatiert.
Tastenkombinationen fürOut-GridView
| Verwenden Sie diesen Schlüssel: | So führen Sie diese Aktion aus: |
|---|---|
| Tab | Verschiebt den Cursor aus dem Filterfeld in das Menü "Kriterien hinzufügen" in die Tabelle und zurück. |
| UpArrow | Um eine Zeile nach oben verschieben. Wechselt zu Spaltenüberschriften aus der ersten Datenzeile. |
| DownArrow | Bewegen Sie sich um eine Zeile nach unten. |
| LeftArrow | Verschieben Sie in der Spaltenüberschriftszeile nach links eine Spalte. |
| RightArrow | Verschieben Sie in der Spaltenüberschriftszeile nach rechts eine Spalte. |
| ContextMenuKey | Zeigt in der Spaltenüberschriftszeile die Option "Spalten auswählen" an. |
| Eingabetaste oder LEERTASTE | Sortieren Sie in der Spaltenüberschriftszeile Spaltendaten (Umschalten von A-Z, Z-A). |
So verwenden Sie die Features des Rasteransichtsfensters
So blenden Sie eine Spalte aus oder zeigen sie an:
- Klicken Sie mit der rechten Maustaste auf eine beliebige Spaltenüberschrift, und klicken Sie dann auf "Spalten auswählen".
- Verwenden Sie im Dialogfeld "Spalten auswählen " die Pfeiltasten, um die Spalten zwischen den Ausgewählten Spalten in die Felder "Verfügbare Spalten" zu verschieben. Im Rasteransichtsfenster werden nur Spalten im Feld "Spalten auswählen" angezeigt.
So ordnen Sie Spalten neu an:
Sie können Spalten an die gewünschte Position ziehen und ablegen. Oder führen Sie die folgenden Schritte aus:
- Klicken Sie mit der rechten Maustaste auf eine beliebige Spaltenüberschrift, und klicken Sie dann auf "Spalten auswählen".
- Verwenden Sie im Dialogfeld "Spalten auswählen" die Schaltflächen "Nach oben " und "Nach unten ", um die Spalten neu anzuordnen. Spalten am oberen Rand der Liste werden links neben den Spalten am Ende der Liste im Rasteransichtsfenster angezeigt.
So sortieren Sie Tabellendaten
- Um die Daten zu sortieren, klicken Sie auf eine Spaltenüberschrift.
- Wenn Sie die Sortierreihenfolge ändern möchten, klicken Sie erneut auf die Spaltenüberschrift. Bei jedem Klicken auf die gleiche Überschrift, wird die Sortierreihenfolge zwischen aufsteigender in absteigender Reihenfolge umgeschaltet. Die aktuelle Reihenfolge wird durch ein Dreieck in der Spaltenüberschrift angezeigt.
Auswählen von Tabellendaten
- Wenn Sie eine Zeile auswählen möchten, wählen Sie die Zeile aus, oder verwenden Sie den Pfeil nach oben oder unten, um zur Zeile zu navigieren.
- Um alle Zeilen (mit Ausnahme der Kopfzeile) auszuwählen, drücken Sie STRG+A.
- Um aufeinander folgende Zeilen auszuwählen, halten Sie die UMSCHALTTASTE gedrückt, während Sie auf die Zeilen klicken oder die Pfeiltasten verwenden.
- Um nicht zusammenhängende Zeilen auszuwählen, drücken Sie die STRG-TASTE , und klicken Sie, um der Auswahl eine Zeile hinzuzufügen.
- Sie können keine Spalten auswählen, und Sie können nicht die gesamte Spaltenüberschriftszeile auswählen.
Kopieren von Zeilen
Wenn Sie eine oder mehrere Zeilen aus der Tabelle kopieren möchten, markieren Sie die Zeilen, und drücken Sie dann STRG+C.
Sie können die Daten in ein anderes Text- oder Tabellenkalkulationsprogramm einfügen. Sie können keine Spalten oder Teile von Zeilen kopieren, und Sie können nicht die Spaltenüberschriftszeile kopieren.
So suchen Sie in der Tabelle (Schnellfilter)
Verwenden Sie das Feld "Filter", um nach Daten in der Tabelle zu suchen. Wenn Sie den Suchtext in das Feld eingeben, werden nur Elemente, die den eingegebenen Text enthalten, in der Tabelle angezeigt.
Suchen sie nach Text. Um nach Text in der Tabelle zu suchen, geben Sie im Feld "Filter" den zu suchenden Text ein.
Suchen Sie nach mehreren Wörtern. Um in der Tabelle nach mehreren Wörtern zu suchen, geben Sie die Wörter durch Leerzeichen voneinander getrennt ein.
Out-GridViewZeigt Zeilen an, die alle Wörter enthalten (logischeS UND).Suchen Sie nach Literalausdrücken. Um Ausdrücke zu suchen, die Leerzeichen oder Sonderzeichen enthalten, schließen Sie den Ausdruck in Anführungszeichen ein.
Out-GridViewZeigt Zeilen an, die eine genaue Übereinstimmung für den Ausdruck enthalten.Suchen sie in Spalten. Um in mindestens einer Spalte nach Text zu suchen, verwenden Sie das folgende Format:
<column>:<text> [<column>:<text>] ...Geben Sie beispielsweise Folgendes ein, um "Net" in der Spalte "DisplayName " im Feld "Filter " zu finden:
displayname:netUm Zeilen mit "Net" in den Spalten "DisplayName " und "Name " zu finden, geben Sie im Feld "Filter " Folgendes ein:
displayname:net name:netSuche deaktivieren. Um die gesamte Tabelle erneut anzuzeigen, klicken Sie in der oberen rechten Ecke des Filterfelds auf die rote X-Schaltfläche, oder löschen Sie den Text aus dem Filterfeld .
Verwenden von Kriterien zum Filtern der Tabelle
Sie können Regeln oder Kriterien verwenden, um zu bestimmen, welche Elemente in der Tabelle angezeigt werden. Elemente werden nur angezeigt, wenn sie alle von Ihnen festgelegten Kriterien erfüllen. Die verfügbaren Kriterien werden durch die Eigenschaften der Objekte, die im Rasteransichtsfenster angezeigt werden, und die .NET Framework-Typen der Eigenschaften bestimmt.
Jedes Kriterium weist das folgende Format auf:
<column> <operator> <value>
Kriterien für unterschiedliche Eigenschaften werden von AND verbunden. Kriterien für dieselbe Eigenschaft werden von OR verbunden. Sie können die logischen Verbindungen nicht ändern.
Die Kriterien wirken sich nur auf die Anzeige aus. Es werden keine Elemente aus der Tabelle gelöscht.
So fügen Sie Kriterien hinzu
- Um die Menüschaltfläche "Kriterien hinzufügen" anzuzeigen, klicken Sie in der oberen rechten Ecke des Fensters auf den Pfeil "Erweitern".
- Klicken Sie auf die Schaltfläche "Kriterien hinzufügen".
- Klicken Sie, um Spalten (Eigenschaften) auszuwählen. Sie können mindestens eine Eigenschaft auswählen.
- Wenn Sie mit dem Auswählen von Eigenschaften fertig sind, klicken Sie auf die Schaltfläche "Hinzufügen ".
- Klicken Sie auf 'Abbrechen', um die Ergänzungen abzubrechen.
- Wenn Sie weitere Kriterien hinzufügen möchten, klicken Sie erneut auf die Schaltfläche "Kriterien hinzufügen".
So bearbeiten Sie ein Kriterium
- Um einen Operator zu ändern, klicken Sie auf den blauen Operatorwert, und wählen Sie dann einen anderen Operator aus der Dropdownliste aus.
- Um einen Wert einzugeben oder zu ändern, geben Sie einen Wert in das Wertfeld ein. Wenn Sie einen ungültigen Wert eingeben, wird ein kreisförmiges X-Symbol angezeigt. Ändern Sie den Wert, um dies zu entfernen.
- Fügen Sie zum Erstellen einer OR-Anweisung ein Kriterium mit derselben Eigenschaft hinzu.
So löschen Sie Kriterien
- Um ausgewählte Kriterien zu löschen, klicken Sie auf das rote X neben jedem Kriterium.
- Um alle Kriterien zu löschen, klicken Sie auf die Schaltfläche "Alle löschen".
Ähnliche Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für