Share via

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 dieses Cmdlet eine Benutzeroberfläche erfordert, 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:

  • Spalten ausblenden, anzeigen und neu anordnen
  • Sortieren von Zeilen
  • Einen Schnellfilter
  • Kriterienfilter hinzufügen
  • Kopieren und Einfügen

Vollständige Anweisungen finden Sie im Abschnitt Notizen dieses Artikels.

Hinweis

Dieses Cmdlet wurde in PowerShell 7 wieder eingeführt. Dieses Cmdlet ist nur auf Windows-Systemen verfügbar, die Windows Desktop unterstützen. Eine plattformübergreifende Version dieses Cmdlets finden Sie im Modul GraphicalTools im PowerShell-Katalog.

Beispiele

Beispiel 1: Ausgabeprozesse in eine Rasteransicht

In diesem Beispiel werden die Prozesse abgerufen, 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 Auf dem lokalen Computer ausgeführten Prozesse abgerufen und an ein Rasteransichtsfenster gesendet.

$P = Get-Process
$P | Out-GridView

Die Ausgabe des Cmdlets Get-Process wird in der $P Variablen gespeichert. Anschließend $P wird an Out-GridViewweitergeleitet.

Beispiel 3: Anzeigen ausgewählter Eigenschaften 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 an übergeben, 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 an Out-GridViewweitergeleitet. 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 Ausgabe einer Rasteransicht

In diesem Beispiel wird die Cmdletausgabe in einer Variablen gespeichert und dann an gesendet Out-GridView.

($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView

Get-ChildItem ruft alle Dateien im PowerShell-Installationsverzeichnis und seinen Unterverzeichnissen mithilfe der automatischen $PSHOME 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 an Out-GridViewgesendet wird.

Beispiel 5: Ausgabeprozesse für einen angegebenen Computer in eine 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"

Das Examle verwendet ogvden Alias für das Out-GridView Cmdlet. Der Title-Parameter gibt den Fenstertitel an.

Beispiel 6: Ausgeben von Daten von Remotecomputern in eine Rasteransicht

In diesem Beispiel wird gezeigt, wie Von Remotecomputern gesammelte Daten an gesendet 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 an Out-GridViewweitergeleitet. Beachten Sie, dass der Skriptblock, der auf dem Remotecomputer ausgeführt wird, den Out-GridView Befehl nicht 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 von Ihnen 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 von Out-GridView können Sie mehrere Elemente in der Pipeline senden. Der PassThru-Parameter entspricht der Verwendung des Multiple-Werts im OutputMode-Parameter.

Beispiel 8: Create einer Windows-Verknüpfung zu "Out-GridView"

In diesem Beispiel wird gezeigt, wie Sie den Wait-Parameter von Out-GridView verwenden, um eine Windows-Verknüpfung zum 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 beendet, sobald das Out-GridView Fenster geöffnet wurde, wodurch das Out-GridView Fenster fast sofort geschlossen würde.

Parameter

-InputObject

Gibt das Objekt an, das das Cmdlet als Eingabe für Out-GridViewakzeptiert.

Wenn Sie den InputObject-Parameter verwenden, um eine Auflistung von Objekten an zu Out-GridViewsenden, Out-GridView behandelt die Auflistung als ein Auflistungsobjekt, und es wird eine Zeile angezeigt, die die Auflistung darstellt. Um die einzelnen Objekte in der Auflistung anzuzeigen, verwenden Sie einen Pipelineoperator (|), um Objekte an zu Out-GridViewsenden.

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 an die Pipeline 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.
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 im OutputMode-Parameter.

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 zurückgegeben, wenn das Out-GridView Fenster geöffnet wird.

Mit diesem Feature können Sie die Out-GridView Cmdlets in Windows-Verknüpfungen verwenden. Wenn Out-GridView in einer Verknüpfung ohne den Wait-Parameter verwendet wird, wird das Out-GridView Fenster nur vorübergehend angezeigt, bevor PowerShell geschlossen wird.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSObject

Sie können jedes Objekt an dieses Cmdlet senden.

Ausgaben

None

Out-GridView Gibt normalerweise keine Objekte zurück. Bei Verwendung des PassThru-Parameters werden die Objekte, die die ausgewählten Zeilen darstellen, an die Pipeline zurückgegeben.

Hinweise

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 Befehlsausgabe, an Out-GridView die Sie senden, kann nicht mit den Format Cmdlets, z Format-Table . B. oder Format-Wide Cmdlets, 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

Taste Aktion
TAB Verschiebt den Cursor aus dem Feld Filter zum Menü Kriterien hinzufügen zur Tabelle und zurück.
UpArrow Verschieben Sie eine Zeile nach oben. Wechselt von der ersten Datenzeile zu Spaltenheadern.
DownArrow Verschieben Sie eine Zeile nach unten.
LeftArrow Verschieben Sie in der Spaltenkopfzeile eine Spalte nach links.
RightArrow Verschieben Sie in der Spaltenheaderzeile eine Spalte nach rechts.
ContextMenuKey Zeigt in der Spaltenheaderzeile die Option Spalten auswählen an.
Eingeben oder Leertaste Sortieren Sie die Spaltendaten in der Spaltenheaderzeile (A-Z, Z-A umschalten).

Verwenden der Features des Rasteransichtfensters

So blenden Sie eine Spalte aus oder ein:

  1. Klicken Sie mit der rechten Maustaste auf eine beliebige Spaltenüberschrift, und klicken Sie 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 sortieren Sie Spalten neu:

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 auf Spalten auswählen.
  2. Verwenden Sie im Dialogfeld Spalten auswählen die SchaltflächenNach oben und Nach unten verschieben , um die Spalten neu anzuordnen. Spalten am oberen Rand der Liste werden links neben den Spalten am Ende der Liste im Rasteransichtsfenster angezeigt.

Sortieren von Tabellendaten

  • Um die Daten zu sortieren, klicken Sie auf eine Spaltenüberschrift.
  • Um die Sortierreihenfolge zu ändern, 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

  • Um eine Zeile auszuwählen, wählen Sie die Zeile aus, oder navigieren Sie mit dem Pfeil nach oben oder unten zur Zeile.
  • Um alle Zeilen (mit Ausnahme der Kopfzeile) auszuwählen, drücken Sie STRG+A.
  • Um aufeinanderfolgende Zeilen auszuwählen, halten Sie die UMSCHALTTASTE gedrückt, während Sie auf die Zeilen klicken oder die Pfeiltasten verwenden.
  • Wenn Sie nicht secutive Zeilen auswählen möchten, drücken Sie die STRG-TASTE , und klicken Sie darauf, 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

  • Um eine oder mehrere Zeilen aus der Tabelle zu kopieren, wählen Sie die Zeilen aus, 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.

Vorgehensweise: Search 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.

  • Search für Text. Um nach Text in der Tabelle zu suchen, geben Sie im Feld Filter den zu suchenden Text ein.

  • Search für mehrere Wörter. 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 AND).

  • Search für Literalbegriffe. 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.

  • Search in Spalten. Um in mindestens einer Spalte nach Text zu suchen, verwenden Sie das folgende Format:

    <column>:<text> [<column>:<text>] ...

    Um beispielsweise "Net" in der Spalte DisplayName zu suchen, geben Sie im Feld Filter folgendes ein:

    displayname:net

    Geben Sie folgendes ein, um Zeilen mit "Net" in den Spalten DisplayName und Name in das Feld Filter zu suchen:

    displayname:net name:net

  • Deaktivieren Sie die Suche. Um die gesamte Tabelle erneut anzuzeigen, klicken Sie auf die rote Schaltfläche X in der oberen rechten Ecke des Felds Filter , oder löschen Sie den Text aus dem Feld Filter .

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 verschiedene Eigenschaften werden durch AND verbunden. Kriterien für dieselbe Eigenschaft sind durch 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.

Hinzufügen von Kriterien

  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 Menü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 der Auswahl der Eigenschaften fertig sind, klicken Sie auf die Schaltfläche Hinzufügen .
  5. Um die Ergänzungen abzubrechen, klicken Sie auf Abbrechen.
  6. Um weitere Kriterien hinzuzufügen, klicken Sie erneut auf die Schaltfläche Kriterien hinzufügen .

Bearbeiten eines Kriteriums

  • Um einen Operator zu ändern, klicken Sie auf den wert des blauen Operators, 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 Feld Wert ein. Wenn Sie einen ungültigen Wert eingeben, wird ein kreisförmiges X-Symbol angezeigt. Ändern Sie den Wert, um dies zu entfernen.
  • Um eine OR-Anweisung zu erstellen, fügen Sie ein Kriterium mit derselben Eigenschaft hinzu.

Löschen von 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 .