Freigeben über

Out-GridView

Modul:
Microsoft.PowerShell.Utility Module

Sendet die Ausgabe an eine interaktive Tabelle in einem separaten Fenster.

Syntax

PassThru (Standardwert) 

Out-GridView
    [-InputObject <PSObject>]
    [-Title <String>]
    [-PassThru]
    [<CommonParameters>]

Wait 

Out-GridView
    [-InputObject <PSObject>]
    [-Title <String>]
    [-Wait]
    [<CommonParameters>]

OutputMode 

Out-GridView
    [-InputObject <PSObject>]
    [-Title <String>]
    [-OutputMode <OutputModeOption>]
    [<CommonParameters>]

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das cmdlet Out-GridView sendet die Ausgabe von einem Befehl 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 Features der Tabelle verwenden, um Ihre Daten zu untersuchen:

  • Ausblenden, Anzeigen und Neuanordnen von Spalten
  • Sortieren von Zeilen
  • 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 Cmdlets Get-Process wird in der variablen $P gespeichert. Anschließend wird $P an 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 an Select-Object weitergeleitet, um die eigenschaften Name, WorkingSetund PeakWorkingSet auszuwählen. Ein anderer Pipelineoperator sendet die gefilterten Objekte an das cmdlet Sort-Object, 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 Features 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 und dann an Out-GridViewgesendet.

($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 richten die Reihenfolge der Vorgänge ein. Daher wird die Ausgabe des Befehls Get-ChildItem in der $A Variablen gespeichert, bevor sie an Out-GridViewgesendet wird.

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 ogvverwendet, bei dem es sich um den Alias für das Cmdlet Out-GridView handelt. Der parameter Title gibt den Fenstertitel an.

Beispiel 6: Ausgeben von Daten von Remotecomputern in eine Rasteransicht

In diesem Beispiel wird gezeigt, wie Daten, die von Remotecomputern gesammelt werden, an Out-GridViewgesendet werden.

Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

Invoke-Command wird auf drei Remotecomputern Get-Culture ausgeführt. Die resultierenden Daten werden an Out-GridViewweitergeleitet. Beachten Sie, dass der Skriptblock, der auf dem Remotecomputer ausgeführt wird, nicht den befehl Out-GridView enthält. Wenn dies der Vorgang getan hat, schlägt der Befehl fehl, wenn er versucht hat, ein Rasteransichtsfenster auf jedem der Remotecomputer zu öffnen.

Beispiel 7: Übergeben mehrerer Elemente über 'Out-GridView'

In diesem Beispiel können Sie mehrere Prozesse aus dem fenster Out-GridView auswählen. Die ausgewählten Prozesse werden an den befehl Export-Csv ü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 an die Pipeline senden. Der PassThru--Parameter entspricht dem Wert Multiple des OutputMode-Parameters.

Beispiel 8: Erstellen einer Windows-Verknüpfung mit "Out-GridView"

In diesem Beispiel wird gezeigt, wie Sie den Parameter Wait von Out-GridView verwenden, um eine Windows-Verknüpfung mit dem fenster Out-GridView zu erstellen.

pwsh -Command "Get-Service | Out-GridView -Wait"

Diese Befehlszeile kann in einer Windows-Verknüpfung verwendet werden. Ohne den Parameter Wait würde PowerShell beendet, sobald das Out-GridView Fenster geöffnet wurde, das das Out-GridView Fenster fast sofort schließt.

Parameter

-InputObject

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

Wenn Sie den parameter InputObject verwenden, um eine Auflistung von Objekten an Out-GridViewzu senden, behandelt Out-GridView 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 (|), um Objekte an Out-GridViewzu senden.

Parametereigenschaften

Typ:PSObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OutputMode

Gibt die Elemente an, die das interaktive Fenster als Eingabe an andere Befehle sendet. Standardmäßig generiert dieses Cmdlet keine Ausgabe. Um Elemente aus dem interaktiven Fenster nach unten in der Pipeline zu senden, klicken Sie, um die Elemente auszuwählen, und klicken Sie dann auf "OK".

Die Werte dieses Parameters bestimmen, wie viele Elemente Sie an die Pipeline senden können.

  • None. Keine Elemente. Dies ist der Standardwert.
  • Single. Null elemente oder ein Element. Verwenden Sie diesen Wert, wenn der nächste Befehl nur ein Eingabeobjekt verwenden kann.
  • Multiple. Null, eins oder viele Elemente. Verwenden Sie diesen Wert, wenn der nächste Befehl mehrere Eingabeobjekte verwenden kann. Dieser Wert entspricht dem parameter PassThru.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Typ:OutputModeOption
Standardwert:None
Zulässige Werte:None, Single, Multiple
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

OutputMode
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

Gibt an, dass das Cmdlet Elemente aus dem interaktiven Fenster in der Pipeline als Eingabe an andere Befehle sendet. Standardmäßig generiert dieses Cmdlet keine Ausgabe. Dieser Parameter entspricht der Verwendung des Werts Multiple des OutputMode-Parameters.

Um Elemente aus dem interaktiven Fenster nach unten in der Pipeline zu senden, klicken Sie, um die Elemente auszuwählen, und klicken Sie dann auf "OK". Umschaltklick und STRG-Klick werden unterstützt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PassThru
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 Out-GridViewaufruft.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Wait

Gibt an, dass das Cmdlet die Eingabeaufforderung unterdrückt und verhindert, dass Windows PowerShell geschlossen wird, bis das fenster Out-GridView geschlossen wird. Standardmäßig gibt die Eingabeaufforderung zurück, 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 parameter Wait verwendet wird, wird das Out-GridView-Fenster erst unmittelbar angezeigt, bevor PowerShell geschlossen wird.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Wait
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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:

  • Fenster:
    • 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 An Out-GridView gesendete Befehlsausgabe kann nicht mithilfe der Format-Cmdlets wie Format-Table- oder Format-Wide-Cmdlets formatiert werden. Verwenden Sie zum Auswählen von Eigenschaften das Cmdlet Select-Object.

Die deserialisierte Ausgabe von Remotebefehlen ist möglicherweise nicht ordnungsgemäß im Rasteransichtsfenster formatiert.

Tastenkombinationen fürOut-GridView

Verwenden Sie diesen Schlüssel: So führen Sie diese Aktion aus:
Tab Verschiebt den Cursor aus dem Feld Filter- zum Menü "Kriterien hinzufügen" der 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.
- oder LEERTASTE eingeben Sortieren Sie in der Spaltenüberschriftszeile Spaltendaten (Umschalten von A-Z, Z-A).

Verwenden der Features des Rasteransichtsfensters

Zum Ausblenden oder Anzeigen einer Spalte:

  1. Klicken Sie mit der rechten Maustaste auf eine beliebige Spaltenüberschrift, und klicken Sie auf Spalten auswählen.
  2. Verwenden Sie im Dialogfeld Dialogfeld "Spalten auswählen" die Pfeiltasten, um die Spalten zwischen den Feldern "Ausgewählte 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 auf Spalten auswählen.
  2. Verwenden Sie im Dialogfeld "Spalten auswählen" die Schaltflächen " Nach oben nach oben verschieben" und Schaltflächen "Nach unten", um die Spalten neu anzuordnen. Spalten am oberen Rand der Liste werden links neben Den Spalten am unteren Rand der Liste im Rasteransichtsfenster angezeigt.

Sortieren von Tabellendaten

  • Klicken Sie zum Sortieren der Daten auf eine Spaltenüberschrift.
  • Wenn Sie die Sortierreihenfolge ändern möchten, klicken Sie erneut auf die Spaltenüberschrift. Jedes Mal, wenn Sie auf dieselbe Kopfzeile klicken, wechselt die Sortierreihenfolge zwischen aufsteigender bis absteigender Reihenfolge. Die aktuelle Reihenfolge wird durch ein Dreieck in der Spaltenüberschrift angegeben.

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überschriftzeile 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 beliebiges Text- oder Tabellenkalkulationsprogramm einfügen. Spalten oder Teile von Zeilen können nicht kopiert werden, und Sie können die Spaltenüberschriftenzeile nicht kopieren.

Suchen in der Tabelle (Schnellfilter)

Verwenden Sie das Feld "Filter", um nach Daten in der Tabelle zu suchen. Wenn Sie 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. Wenn Sie nach mehreren Wörtern in der Tabelle suchen möchten, geben Sie die Wörter durch Leerzeichen getrennt ein. Out-GridView zeigt Zeilen an, die alle Wörter enthalten (logische UND).

  • Suchen Sie nach Literalausdrücken. Wenn Sie nach Ausdrücken suchen möchten, 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 nach Text in einer oder mehreren Spalten zu suchen, verwenden Sie das folgende Format:

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

    Um z. B. "Net" in der Spalte DisplayName zu finden, geben Sie im Feld Filter Folgendes ein:

    displayname:net

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

    displayname:net name:net

  • Suche deaktivieren. Wenn Sie die gesamte Tabelle erneut anzeigen möchten, klicken Sie in der oberen rechten Ecke des Felds Filter auf die rote X-Schaltfläche, 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 bestimmt, die im Rasteransichtsfenster und den .NET Framework-Typen dieser Eigenschaften angezeigt werden.

Jedes Kriterium weist das folgende Format auf:

<column> <operator> <value>

Kriterien für unterschiedliche Eigenschaften werden durch UNDverbunden. Kriterien für dieselbe Eigenschaft werden durch ODERverbunden. Sie können die logischen Verbinder nicht ändern.

Die Kriterien wirken sich nur auf die Anzeige aus. Elemente werden nicht aus der Tabelle gelöscht.

Hinzufügen von Kriterien

  1. Um die Schaltfläche 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 eine oder mehrere Eigenschaften auswählen.
  4. Wenn Sie mit dem Auswählen von Eigenschaften fertig sind, klicken Sie auf die Schaltfläche Hinzufügen.
  5. Um die Ergänzungen abzubrechen, klicken Sie auf Abbrechen.
  6. Wenn Sie weitere Kriterien hinzufügen möchten, klicken Sie erneut auf die Schaltfläche Kriterien hinzufügen.

Bearbeiten eines Kriteriums

  • 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. Um ihn zu entfernen, ändern Sie den Wert.
  • 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.