Format-Table

Referenz

Modul:: Microsoft.PowerShell.Utility

Formatiert die Ausgabe als Tabelle.

Syntax

Format-Table
      [[-Property] <Object[]>]
      [-AutoSize]
      [-RepeatHeader]
      [-HideTableHeaders]
      [-Wrap]
      [-GroupBy <Object>]
      [-View <string>]
      [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>]
      [<CommonParameters>]

Beschreibung

Das Format-Table Cmdlet formatiert die Ausgabe eines Befehls als Tabelle mit den ausgewählten Eigenschaften des Objekts in jeder Spalte. Der Objekttyp bestimmt das Standardlayout und die Eigenschaften, die in jeder Spalte angezeigt werden. Sie können den Parameter Property verwenden, um die anzuzeigenden Eigenschaften auszuwählen.

PowerShell verwendet Standardformatierer, um zu definieren, wie Objekttypen angezeigt werden. Sie können Dateien verwenden .ps1xml , um benutzerdefinierte Ansichten zu erstellen, die eine Ausgabetabelle mit angegebenen Eigenschaften anzeigen. Nachdem eine benutzerdefinierte Ansicht erstellt wurde, verwenden Sie den View-Parameter , um die Tabelle mit Ihrer benutzerdefinierten Ansicht anzuzeigen. Weitere Informationen zu Ansichten finden Sie unter about_Format.ps1xml.

Sie können eine Hashtabelle verwenden, um einem Objekt vor der Anzeige berechnete Eigenschaften hinzuzufügen und die Spaltenüberschriften in der Tabelle anzugeben. Um eine berechnete Eigenschaft hinzuzufügen, verwenden Sie den Parameter Property oder GroupBy . Weitere Informationen zu Hashtabellen finden Sie unter about_Hash_Tables (Informationen zu Hashtabellen).

Beispiele

Beispiel 1: Formatieren des PowerShell-Hosts

In diesem Beispiel werden Informationen zum Hostprogramm für PowerShell in einer Tabelle angezeigt.

Get-Host | Format-Table -AutoSize

Das Get-Host Cmdlet ruft System.Management.Automation.Internal.Host.InternalHost-Objekte ab, die den Host darstellen. Die Objekte werden an die Pipeline Format-Table gesendet und in einer Tabelle angezeigt. Der AutoSize-Parameter passt die Spaltenbreite an, um die Abschneidung zu minimieren.

Beispiel 2: Formatieren von Prozessen nach BasePriority

In diesem Beispiel werden Prozesse in Gruppen mit derselben BasePriority-Eigenschaft angezeigt.

Get-Process | Sort-Object -Property BasePriority | Format-Table -GroupBy BasePriority -Wrap

Das Get-Process Cmdlet ruft Objekte ab, die die einzelnen Prozesse auf dem Computer darstellen, und sendet sie in der Pipeline an Sort-Object. Die Objekte werden in der Reihenfolge ihrer BasePriority-Eigenschaft sortiert.

Die sortierten Objekte werden an die Pipeline Format-Tablegesendet. Der GroupBy-Parameter ordnet die Prozessdaten basierend auf dem Wert ihrer BasePriority-Eigenschaft in Gruppen an. Der Wrap-Parameter stellt sicher, dass Daten nicht abgeschnitten werden.

Beispiel 3: Formatieren von Prozessen nach Startdatum

In diesem Beispiel werden Informationen zu den Prozessen angezeigt, die auf dem Computer ausgeführt werden. Die Objekte werden sortiert und Format-Table verwenden eine Ansicht, um die Objekte nach ihrem Startdatum zu gruppieren.

Get-Process | Sort-Object StartTime | Format-Table -View StartTime

Get-Process ruft die System.Diagnostics.Process-Objekte ab, die die auf dem Computer ausgeführten Prozesse darstellen. Die Objekte werden an die Pipeline Sort-Objectgesendet und basierend auf der StartTime-Eigenschaft sortiert.

Die sortierten Objekte werden an die Pipeline Format-Tablegesendet. Der View-Parameter gibt die StartTime-Ansicht an, die in der PowerShell-Datei DotNetTypes.format.ps1xml für System.Diagnostics.Process-Objekte definiert ist. Die StartTime-Ansicht konvertiert die Startzeit jedes Prozesses in ein kurzes Datum und gruppiert die Prozesse dann nach dem Startdatum.

Die DotNetTypes.format.ps1xml Datei enthält eine Prioritätsansicht für Prozesse. Sie können Ihre eigenen format.ps1xml Dateien mit benutzerdefinierten Ansichten erstellen.

Beispiel 4: Verwenden einer benutzerdefinierten Ansicht für die Tabellenausgabe

In diesem Beispiel zeigt eine benutzerdefinierte Ansicht den Inhalt eines Verzeichnisses an. Die benutzerdefinierte Ansicht fügt die CreationTime-Spalte der Tabellenausgabe für system.IO.DirectoryInfo - und System.IO.FileInfo-Objekte hinzu, die von erstellt wurden Get-ChildItem.

Die benutzerdefinierte Ansicht in diesem Beispiel wurde aus der im PowerShell-Quellcode definierten Ansicht erstellt. Weitere Informationen zu Ansichten und dem Code, der zum Erstellen der Ansicht dieses Beispiels verwendet wird, finden Sie unter about_Format.ps1xml.

Get-ChildItem  -Path C:\Test | Format-Table -View mygciview

Directory: C:\Test

Mode                LastWriteTime              CreationTime         Length Name
----                -------------              ------------         ------ ----
d-----        11/4/2019     15:54       9/24/2019     15:54                Archives
d-----        8/27/2019     14:22       8/27/2019     14:22                Drawings
d-----       10/23/2019     09:38       2/25/2019     09:38                Files
-a----        11/7/2019     11:07       11/7/2019     11:07          11345 Alias.txt
-a----        2/27/2019     15:15       2/27/2019     15:15            258 alias_out.txt
-a----        2/27/2019     15:16       2/27/2019     15:16            258 alias_out2.txt

Get-ChildItemruft den Inhalt des aktuellen Verzeichnisses ab. C:\Test Die Objekte System.IO.DirectoryInfo und System.IO.FileInfo werden über die Pipeline gesendet. Format-Table verwendet den View-Parameter , um die benutzerdefinierte Ansicht mygciview anzugeben, die die CreationTime-Spalte enthält.

Die Standardausgabe Format-Table für Get-ChildItem enthält nicht die CreationTime-Spalte .

Beispiel 5: Verwenden von Eigenschaften für die Tabellenausgabe

In diesem Beispiel wird der Property-Parameter verwendet, um alle Dienste des Computers in einer zweispaltigen Tabelle anzuzeigen, in der die Eigenschaften Name und DependentServices angezeigt werden.

Get-Service | Format-Table -Property Name, DependentServices

Get-Service ruft alle Dienste auf dem Computer ab und sendet die System.ServiceProcess.ServiceController-Objekte in der Pipeline. Format-Table verwendet den Property-Parameter , um anzugeben, dass die Eigenschaften Name und DependentServices in der Tabelle angezeigt werden.

Name und DependentServices sind zwei eigenschaften des Objekttyps. So zeigen Sie alle Eigenschaften an: Get-Service | Get-Member -MemberType Properties.

Beispiel 6: Formatieren eines Prozesses und Berechnen der Laufzeit

In diesem Beispiel wird eine Tabelle mit dem Prozessnamen und der Gesamtlaufzeit für die Editorprozesse des lokalen Computers angezeigt. Die Gesamtausführungszeit wird durch Subtrahieren der Startzeit der einzelnen Prozesses von der aktuellen Zeit berechnet.

Get-Process notepad |
  Format-Table ProcessName, @{Label="TotalRunningTime"; Expression={(Get-Date) - $_.StartTime}}

ProcessName TotalRunningTime
----------- ----------------
notepad     03:20:00.2751767
notepad     00:00:16.7710520

Get-Process ruft alle Notizblockprozesse des lokalen Computers ab und sendet die Objekte in die Pipeline. Format-Table zeigt eine Tabelle mit zwei Spalten an: ProcessName, eine Get-Process Eigenschaft, und TotalRunningTime, eine berechnete Eigenschaft.

Die TotalRunningTime-Eigenschaft wird durch eine Hashtabelle mit den beiden Schlüsseln Label und Expression angegeben. Der Label-Schlüssel gibt den Eigenschaftennamen an. Die Expression-Taste gibt die Berechnung an. Der Ausdruck ruft die StartTime-Eigenschaft jedes Prozessobjekts ab und subtrahiert sie vom Ergebnis eines Get-Date Befehls, der das aktuelle Datum und die aktuelle Uhrzeit abruft.

Beispiel 7: Formatieren von Editorprozessen

In diesem Beispiel wird Get-CimInstance die Laufzeit für alle Editorprozesse auf dem lokalen Computer abgerufen. Sie können Get-CimInstance mit dem ComputerName-Parameter Informationen von Remotecomputern abrufen.

$Processes = Get-CimInstance -Class win32_process -Filter "name='notepad.exe'"
$Processes | Format-Table ProcessName, @{
    Label = "Total Running Time"
    Expression={(Get-Date) - $_.CreationDate}
}

ProcessName Total Running Time
----------- ------------------
notepad.exe 03:39:39.6260693
notepad.exe 00:19:56.1376922

Get-CimInstance ruft Instanzen der WMI-Win32_Process-Klasse ab, die alle Prozesse des lokalen Computers mit dem Namen notepad.exebeschreibt. Die Prozessobjekte werden in der $Processes Variablen gespeichert.

Die Prozessobjekte in der $Processes Variablen werden in der Pipeline an Format-Tablegesendet, die die ProcessName-Eigenschaft und die neue berechnete Eigenschaft Gesamtlaufzeit anzeigt.

Der Befehl weist dem Label-Schlüssel den Namen der neuen berechneten Eigenschaft Gesamtlaufzeit zu. Der Skriptblock des Expression-Schlüssels berechnet, wie lange der Prozess ausgeführt wurde, indem das Erstellungsdatum der Prozesse vom aktuellen Datum subtrahiert wird. Das Get-Date Cmdlet ruft das aktuelle Datum ab. Das Erstellungsdatum wird vom aktuellen Datum subtrahiert. Das Ergebnis ist der Wert der Gesamtlaufzeit.

Beispiel 8: Problembehandlung bei Formatfehlern

Die folgenden Beispiele zeigen die Ergebnisse des Hinzufügens der Parameter DisplayError oder ShowError mit einem Ausdruck.

Get-Date | Format-Table DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek  $_ / $null
--------- ------------
Wednesday #ERR

Get-Date | Format-Table DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek  $_ / $null
--------- ------------
Wednesday

InvalidArgument: Failed to evaluate expression " $_ / $null ".

Parameter

-AutoSize

Gibt an, dass das Cmdlet die Spaltengröße und die Anzahl der Spalten basierend auf der Breite der Daten anpasst. Standardmäßig werden die Spaltengröße und die Anzahl von der Ansicht bestimmt.

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

-DisplayError

Gibt an, dass das Cmdlet Fehler in der Befehlszeile anzeigt. Dieser Parameter kann als Debughilfe verwendet werden, wenn Sie Ausdrücke in einem Format-Table Befehl formatieren und die Problembehandlung für die Ausdrücke ausführen müssen.

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

-Expand

Gibt das Format des Auflistungsobjekts und der Objekte in der Auflistung an. Dieser Parameter ist für das Formatieren von Objekten konzipiert, die die ICollection-Schnittstelle (System.Collections) unterstützen. Der Standardwert ist EnumOnly. Die zulässigen Werte für diesen Parameter sind wie folgt:

EnumOnly: Zeigt die Eigenschaften der -Objekte in der Auflistung an.
CoreOnly: Zeigt die Eigenschaften des Auflistungsobjekts an.
Beides: Zeigt die Eigenschaften des Auflistungsobjekts und die Eigenschaften von Objekten in der Auflistung an.

Type:	String
Accepted values:	CoreOnly, EnumOnly, Both
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Gibt an, dass das Cmdlet das Cmdlet angibt, alle Fehlerinformationen anzuzeigen. Verwenden Sie mit dem Parameter DisplayError oder ShowError . Wenn ein Fehlerobjekt in die Fehler- oder Anzeigedatenströme geschrieben wird, werden standardmäßig nur einige Fehlerinformationen angezeigt.

Auch beim Formatieren bestimmter .NET-Typen erforderlich. Weitere Informationen finden Sie im Abschnitt Hinweise.

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

-GroupBy

Gibt eine sortierte Ausgabe in separaten Tabellen basierend auf einem Eigenschaftswert an. Beispielsweise können Sie GroupBy verwenden, um Dienste basierend auf ihren status in separaten Tabellen aufzulisten.

Geben Sie einen Ausdruck oder eine Eigenschaft ein. Der GroupBy-Parameter erwartet, dass die Objekte sortiert werden. Verwenden Sie das Sort-Object Cmdlet, bevor Sie Format-Table verwenden, um die Objekte zu gruppieren.

Der Wert des GroupBy-Parameters kann eine neue berechnete Eigenschaft sein. Die berechnete Eigenschaft kann ein Skriptblock oder eine Hashtabelle sein. Gültige Schlüssel-Wert-Paare sind:

Name (oder Bezeichnung) – <string>
Ausdruck – <string> oder <script block>
Formatstring- <string>

Weitere Informationen finden Sie unter about_Calculated_Properties.

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

-HideTableHeaders

Lässt die Spaltenüberschriften in der Tabelle aus.

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

-InputObject

Gibt die zu formatierenden Objekte an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Property

Gibt die in der Anzeige angezeigten Objekteigenschaften und die Reihenfolge an, in der sie angezeigt werden. Geben Sie mindestens einen Eigenschaftsnamen ein, getrennt durch Kommas, oder verwenden Sie eine Hashtabelle, um eine berechnete Eigenschaft anzuzeigen. Platzhalter sind zulässig.

Wenn Sie diesen Parameter weglassen, hängen die Eigenschaften, die in der Anzeige angezeigt werden, von den Eigenschaften des ersten Objekts ab. Wenn das erste Objekt beispielsweise Über PropertyA und PropertyB verfügt, nachfolgende Objekte jedoch Über PropertyA, PropertyB und PropertyC verfügen, werden nur die PropertyA - und PropertyB-Header angezeigt.

Der Parameter Property ist optional. Sie können die Parameter Property und View nicht im gleichen Befehl verwenden.

Der Wert des Property-Parameters kann eine neue berechnete Eigenschaft sein. Die berechnete Eigenschaft kann ein Skriptblock oder eine Hashtabelle sein. Gültige Schlüssel-Wert-Paare sind:

Name (oder Bezeichnung) <string>
Ausdruck – <string> oder <script block>
Formatstring- <string>
Breite - <int32> - muss größer als sein 0
Ausrichtung: Der Wert kann , Centeroder seinLeft.Right

Weitere Informationen finden Sie unter about_Calculated_Properties.

Type:	Object[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-RepeatHeader

Wiederholt die Anzeige der Kopfzeile einer Tabelle nach jedem bildschirmfüllten Bildschirm. Der wiederholte Header ist nützlich, wenn die Ausgabe an einen Pager wie less oder more ein Paging mit einer Sprachausgabe weitergeleitet wird.

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

-ShowError

Dieser Parameter sendet Fehler über die Pipeline. Dieser Parameter kann als Debughilfe verwendet werden, wenn Sie Ausdrücke in einem Format-Table Befehl formatieren und die Problembehandlung für die Ausdrücke ausführen müssen.

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

-View

Ab PowerShell 6 werden die Standardansichten im PowerShell-Quellcode C# definiert. Die *.format.ps1xml Dateien aus PowerShell 5.1 und früheren Versionen sind in PowerShell 6 und höheren Versionen nicht vorhanden.

Mit dem View-Parameter können Sie ein alternatives Format oder eine benutzerdefinierte Ansicht für die Tabelle angeben. Sie können die PowerShell-Standardansichten verwenden oder benutzerdefinierte Ansichten erstellen. Weitere Informationen zum Erstellen einer benutzerdefinierten Ansicht finden Sie unter about_Format.ps1xml.

Die alternativen und benutzerdefinierten Ansichten für den View-Parameter müssen das Tabellenformat verwenden, Format-Table andernfalls tritt ein Fehler auf. Wenn die alternative Ansicht eine Liste ist, verwenden Sie das Format-List Cmdlet. Wenn die alternative Ansicht keine Liste oder Tabelle ist, verwenden Sie das Format-Custom Cmdlet.

Sie können die Parameter Property und View nicht im gleichen Befehl verwenden.

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

-Wrap

Zeigt Text an, der die Spaltenbreite in der nächsten Zeile überschreitet. Standardmäßig wird Text, der die Spaltenbreite überschreitet, abgeschnitten.

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

Ausgaben

Microsoft.PowerShell.Commands.Internal.Format

Dieses Cmdlet gibt Formatobjekte zurück, die die Tabelle darstellen.

Hinweise

PowerShell enthält die folgenden Aliase für Format-Table:

Alle Plattformen:
- ft

PowerShell 7.2 hat neue Features zum Farbigen der Ausgabe eingeführt. Die Farben können mithilfe der automatischen $PSStyle Variablen verwaltet werden. Die $PSStyle.Formatting.TableHeader -Eigenschaft definiert die Farbe, die für den Header der von angezeigten Format-TableTabelle verwendet wird. Weitere Informationen zu dieser Einstellung finden Sie unter about_ANSI_Terminals.

Wenn Sie mit dem Parameter Property verwenden Format-Table möchten, müssen Sie den Force-Parameter unter einer der folgenden Bedingungen einschließen:

Die Eingabeobjekte werden normalerweise out-of-band mit der ToString() -Methode formatiert. Dies gilt für primitive .NET- und -Typen, bei denen es sich um [string] eine Übermenge der integrierten numerischen Typen wie [int], [long]und andere handelt.
Die Eingabeobjekte verfügen über keine öffentlichen Eigenschaften.
Bei den Eingabeobjekten handelt es sich um Instanzen der Wrappertypen, die PowerShell für andere Ausgabedatenströme als den Ausgabestream Success verwendet. Dies gilt nur, wenn diese Wrappertypen an den Success-Ausgabestream gesendet werden, der entweder zuerst über gängige Parameter wie ErrorVariable erfasst oder eine Umleitung wie *>&1verwendet wird.
- Zu den Wrappertypen gehören:

Freigeben über

Format-Table

Syntax

Beschreibung

Beispiele

Beispiel 1: Formatieren des PowerShell-Hosts

Beispiel 2: Formatieren von Prozessen nach BasePriority

Beispiel 3: Formatieren von Prozessen nach Startdatum

Beispiel 4: Verwenden einer benutzerdefinierten Ansicht für die Tabellenausgabe

Beispiel 5: Verwenden von Eigenschaften für die Tabellenausgabe

Beispiel 6: Formatieren eines Prozesses und Berechnen der Laufzeit

Beispiel 7: Formatieren von Editorprozessen

Beispiel 8: Problembehandlung bei Formatfehlern

Parameter

-AutoSize

-DisplayError

-Expand

-Force

-GroupBy

-HideTableHeaders

-InputObject

-Property

-RepeatHeader

-ShowError

-View

-Wrap

Eingaben

Ausgaben

Hinweise

Zusätzliche Ressourcen

Freigeben über

Format-Table

Syntax

Beschreibung

Beispiele

Beispiel 1: Formatieren des PowerShell-Hosts

Beispiel 2: Formatieren von Prozessen nach BasePriority

Beispiel 3: Formatieren von Prozessen nach Startdatum

Beispiel 4: Verwenden einer benutzerdefinierten Ansicht für die Tabellenausgabe

Beispiel 5: Verwenden von Eigenschaften für die Tabellenausgabe

Beispiel 6: Formatieren eines Prozesses und Berechnen der Laufzeit

Beispiel 7: Formatieren von Editorprozessen

Beispiel 8: Problembehandlung bei Formatfehlern

Parameter

-AutoSize

-DisplayError

-Expand

-Force

-GroupBy

-HideTableHeaders

-InputObject

-Property

-RepeatHeader

-ShowError

-View

-Wrap

Eingaben

Ausgaben

Hinweise

Ähnliche Themen

Zusätzliche Ressourcen