Out-GridView

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

Das Cmdlet Out-GridView 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 auf Server Core-Installationen von Windows Server.

Sie können die folgenden Features der Tabelle verwenden, um Ihre Daten zu untersuchen:

• Ausblenden, Anzeigen und Neuanordnen von Spalten: Um eine Spalte auszublenden, anzuzeigen oder neu anzuordnen, klicken Sie mit der rechten Maustaste auf eine Spaltenüberschrift, und klicken Sie dann auf Spalten auswählen.
• Sortieren. Klicken Sie zum Sortieren der Daten auf eine Spaltenüberschrift. Klicken Sie erneut, um von aufsteigender zu absteigender Reihenfolge zu wechseln.
• Schnellfilter. Verwenden Sie das Feld Filter am oberen Rand des Fensters, um den Text in der Tabelle zu durchsuchen. Sie können nach Text in einer bestimmten Spalte suchen, nach Literalen suchen und nach mehreren Wörtern suchen.
• Kriterien-Filter. Verwenden Sie das Dropdown-Menü Kriterien hinzufügen, um Regeln zum Filtern der Daten zu erstellen. Dies ist sehr nützlich für sehr große Datensätze, wie z. B. Ereignisprotokolle.
• Kopieren und Einfügen. Um Datenzeilen aus Out-GridView zu kopieren, drücken Sie STRG+C (Kopieren). Sie können die Daten in ein beliebiges Text- oder Tabellenkalkulationsprogramm einfügen.

Anweisungen zur Verwendung dieser Funktionen finden Sie unter Get-Help Out-GridView -Full Verwenden der Funktionen des Rasteransichtsfensters im Abschnitt Notizen.

PS C:\> Get-Process | Out-GridView

Mit diesem Befehl werden die auf dem lokalen Computer ausgeführten Prozesse abgerufen und an ein Rasteransichtsfenster gesendet.

PS C:\> $P = Get-Process
PS C:\> $P | Out-GridView

Mit diesem Befehl werden auch die Prozesse abgerufen, die auf dem lokalen Computer ausgeführt werden, und sie werden an ein Rasteransichtsfenster gesendet.

Der erste Befehl verwendet das Cmdlet Get-Process, um die Prozesse auf dem Computer abzurufen, und speichert dann die Prozessobjekte in der Variablen $P.

Der zweite Befehl verwendet einen Pipelineoperator, um die Variable $P an Out-GridView zu senden.

PS C:\> Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet | Sort-Object -Property WorkingSet -Descending | Out-GridView

Mit diesem Befehl wird eine formatierte Tabelle in einem Rasteransichtsfenster angezeigt.

Es verwendet das Cmdlet Get-Process, um die Prozesse auf dem Computer abzurufen.

Anschließend wird ein Pipelineoperator (|) verwendet, um die Prozessobjekte an das Cmdlet Select-Object zu senden. Der Befehl verwendet den Property-Parameter von Select-Object, um die Eigenschaften Name, WorkingSet und PeakWorkingSet auszuwählen, die in der Tabelle angezeigt werden sollen.

Ein anderer Pipelineoperator sendet die gefilterten Objekte an das Cmdlet Sort-Object, das sie in absteigender Reihenfolge nach dem Wert der WorkingSet-Eigenschaft sortiert.

Im letzten Teil des Befehls wird ein Pipelineoperator (|) verwendet, um die formatierte Tabelle an Out-GridView zu senden.

Sie können nun die Features der Rasteransicht verwenden, um die Daten zu durchsuchen, zu sortieren und zu filtern.

PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | Out-GridView

Dieser Befehl speichert die Ausgabe in einer Variablen und sendet sie an Out-GridView.

Der Befehl verwendet das Cmdlet Get-ChildItem, um die Dateien im Windows PowerShell-Installationsverzeichnis und seinen Unterverzeichnissen abzurufen. Der Pfad zum Installationsverzeichnis wird in der $pshome automatischen Variablen gespeichert.

Der Befehl verwendet den Zuweisungsoperator (=), um die Ausgabe in der Variablen $A zu speichern, und den Pipelineoperator (|), um die Ausgabe an Out-GridView zu senden.

Die Klammern im Befehl richten die Reihenfolge der Vorgänge ein. Daher wird die Ausgabe des Befehls Get-ChildItem in der Variablen $A gespeichert, bevor sie an Out-GridView gesendet wird.

PS C:\> Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

Mit diesem Befehl werden die Prozesse, die auf dem Computer Server01 ausgeführt werden, in einem Rasteransichtsfenster angezeigt.

Der Befehl verwendet ogv, den integrierten Alias für das Cmdlet Out-GridView , und verwendet den Parameter Title , um den Fenstertitel anzugeben.

PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

In diesem Beispiel wird das richtige Format zum Senden von Daten, die von Remotecomputern gesammelt wurden, an das Cmdlet Out-GridView gezeigt.

Der Befehl verwendet das Cmdlet Invoke-Command, um einen Get-Culture Befehl auf drei Remotecomputern auszuführen. Er verwendet einen Pipelineoperator, um die Daten zu senden, die an das Cmdlet Out-GridView zurückgegeben werden.

Beachten Sie, dass der Skriptblock, der die Befehle enthält, die remote ausgeführt werden, den Befehl Out-GridView nicht 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.

PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

Mit diesem Befehl können Sie mehrere Prozesse aus dem Fenster Out-GridView auswählen. Die Prozesse, die Sie auswählen, werden an den Befehl Export-Csv übergeben und in die ProcessLog.csv Datei geschrieben.

Der Befehl verwendet den PassThru-Parameter von Out-GridView, mit dem Sie mehrere Elemente in der Pipeline senden können. Der PassThru-Parameter entspricht der Verwendung des Multiple-Werts des OutputMode-Parameters .

PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"

Dieser Befehl zeigt, wie Sie den Wait-Parameter von Out-GridView verwenden, um eine Windows-Verknüpfung zum Out-GridView-Fenster zu erstellen. Ohne den Wait-Parameter würde Windows PowerShell beendet werden, sobald das Out-GridView-Fenster geöffnet wird, wodurch das Out-GridView-Fenster fast sofort geschlossen wird.

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.

Sie können ein beliebiges Objekt an dieses Cmdlet senden.

Out-GridView gibt keine Objekte zurück.

• In Windows PowerShell 2.0 wird das Cmdlet Out-GridView standardmäßig in Clientversionen von Windows installiert, ist jedoch ein optionales Feature in Serverversionen von Windows. In Windows PowerShell 3.0 wird sie standardmäßig auf allen Systemen installiert. Wenn Sie jedoch das Windows PowerShell ISE-Feature deaktivieren oder entfernen, wird auch das Cmdlet Out-GridView deaktiviert oder entfernt.

• Sie können keinen Remotebefehl verwenden, um ein Rasteransichtsfenster auf einem anderen Computer zu öffnen.

• Die Befehlsausgabe, die Sie an Out-GridView senden, kann nicht formatiert werden, z. B. mithilfe der Cmdlets Format-Table oder Format-Wide. 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ür Out-GridView

  Mit den folgenden Tastenkombinationen können Sie viele Aufgaben schnell ausführen.

  Verwenden Sie diesen Schlüssel:Um diese Aktion auszuführen:

  TAB Verschiebt den Cursor vom Feld Filter in das Menü Kriterien hinzufügen, in die Tabelle und zurück.

  NACH-OBEN-TASTE Bewegen Sie sich eine Zeile nach oben. Wird zu Spaltenüberschriften verschoben.

  NACH-UNTEN-TASTE Eine Zeile nach unten verschieben.

  PFEIL NACH LINKS In der Zeile der Spaltenüberschrift eine Spalte nach links verschieben.

  PFEIL NACH RECHTS: In der Zeile der Spaltenüberschrift eine Spalte nach rechts verschieben.

  KONTEXTMENÜ-TASTE In der Zeile der Spaltenüberschrift wird die Option Spalten auswählen angezeigt.

  EINGABETASTE oder LEERTASTE Sortieren Sie in der Zeile der Spaltenüberschrift die Spaltendaten (Umschalten A-Z, Z-A).

  So verwenden Sie die Funktionen des Rasteransichtsfensters

  In den folgenden Themen wird erläutert, wie die Features des Fensters verwendet werden, das in Out-GridView angezeigt wird.

  Ausblenden, Anzeigen und Neuanordnen von Spalten

  So blenden Sie eine Spalte ein oder aus:

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 die Spalten im Feld Ausgewählte Spalten angezeigt.

So ordnen Sie Spalten neu an:

• Ziehen Sie die Spalte per Drag & Drop an die gewünschte Stelle.

• oder-

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 und 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.

So wählen Sie Tabellendaten aus

• Um eine Zeile auszuwählen, klicken Sie auf die Zeile, oder verwenden Sie den Pfeil nach oben oder unten, um zu der Zeile zu navigieren.

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

• Um nicht aufeinanderfolgende 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.

So kopieren Sie 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.

So suchen Sie 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 (logisches 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> [<Spalte>:<Text>] ...

Wenn Sie z. B. "Net" in der Spalte "DisplayName" suchen möchten, geben Sie im Feld "Filter" Folgendes ein:

Anzeigename:NET

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

Anzeigename:Netzname:NET

• Suche deaktivieren. Um wieder die gesamte Tabelle anzuzeigen, klicken Sie auf die rote X-Schaltfläche in der oberen rechten Ecke des Filterfelds 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 bestimmt, die im Rasteransichtsfenster und den .NET Framework-Typen dieser Eigenschaften angezeigt werden.

Jedes Kriterium weist das folgende Format auf:

< > <Wert des Spaltenoperators><>

Kriterien für verschiedene Eigenschaften werden durch UND verbunden. Kriterien für dieselbe Eigenschaft werden durch ODER verbunden. 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 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 der Auswahl der Eigenschaften fertig sind, klicken Sie auf die Schaltfläche Hinzufügen.

5. Um die Ergänzungen zu verwerfen, klicken Sie auf Abbrechen.

6. Um weitere Kriterien hinzuzufügen, 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 Dropdown-Liste 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.

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.