Freigeben über

Out-GridView

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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

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

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

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

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

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

Mit dem PassThru-Parameter Out-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-Parameter Out-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.

Typ:PSObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:OutputModeOption
Zulässige Werte:None, Single, Multiple
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSObject

Sie können jedes Objekt an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

PSObject

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ür Out-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:

  1. Klicken Sie mit der rechten Maustaste auf eine beliebige Spaltenüberschrift, und klicken Sie dann auf "Spalten auswählen".
  2. 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:

  1. Klicken Sie mit der rechten Maustaste auf eine beliebige Spaltenüberschrift, und klicken Sie dann auf "Spalten auswählen".
  2. 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-GridView Zeigt 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-GridView Zeigt 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:net

    Um Zeilen mit "Net" in den Spalten "DisplayName " und "Name " zu finden, geben Sie im Feld "Filter " Folgendes ein:

    displayname:net name:net

  • Suche 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

  1. Um die Menüschaltfläche "Kriterien hinzufügen" anzuzeigen, klicken Sie in der oberen rechten Ecke des Fensters auf den Pfeil "Erweitern".
  2. Klicken Sie auf die Schaltfläche "Kriterien hinzufügen".
  3. Klicken Sie, um Spalten (Eigenschaften) auszuwählen. Sie können mindestens eine Eigenschaft auswählen.
  4. Wenn Sie mit dem Auswählen von Eigenschaften fertig sind, klicken Sie auf die Schaltfläche "Hinzufügen ".
  5. Klicken Sie auf 'Abbrechen', um die Ergänzungen abzubrechen.
  6. 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".