Format-Table

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 Eigenschaften auszuwählen, die Sie anzeigen möchten.

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 Parameter "View ", 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 berechnete Eigenschaften hinzuzufügen, bevor Sie es anzeigen und die Spaltenüberschriften in der Tabelle angeben. Verwenden Sie den Parameter Property oder GroupBy , um eine berechnete Eigenschaft hinzuzufügen. Weitere Informationen zu Hashtabellen finden Sie unter about_Hash_Tables (Informationen zu Hashtabellen).

Beispiele

Beispiel 1: Formatieren von PowerShell-Host

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 Parameter "AutoSize " passt die Spaltenbreiten an, um die Abkürzung 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 jeden Prozess auf dem Computer darstellen, und sendet sie an die Pipeline.Sort-Object Die Objekte werden in der Reihenfolge ihrer BasePriority-Eigenschaft sortiert.

Die sortierten Objekte werden an die Pipeline gesendet.Format-Table Der Parameter GroupBy ordnet die Prozessdaten basierend auf dem Wert der 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 auf dem Computer ausgeführten Prozessen angezeigt. Die Objekte werden sortiert und Format-Table verwendet 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 gesendet.Format-Table Der Parameter View gibt die StartTime-Ansicht an, die in der PowerShell-Datei DotNetTypes.format.ps1xml für System.Diagnostics.Process-Objekte definiert ist. In der Starttime-Ansicht werden die einzelnen Prozesse der Startzeit in ein kurzes Datum konvertiert und dann die Prozesse nach dem Startdatum gruppiert.

Die DotNetTypes.format.ps1xml Datei enthält eine Prioritätsansicht für Prozesse. Sie können eigene format.ps1xml Dateien mit angepassten 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 zur Tabellenausgabe für System.IO.DirectoryInfo- und System.IO.FileInfo-Objekte hinzu, die von Get-ChildItem.

Die benutzerdefinierte Ansicht in diesem Beispiel wurde aus der ansicht erstellt, die im PowerShell-Quellcode definiert ist. Weitere Informationen zu Ansichten und dem Code zum Erstellen der Ansicht dieses Beispiels 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-ChildItem ruft den Inhalt des aktuellen Verzeichnisses ab, C:\Test. Die System.IO.DirectoryInfo- und System.IO.FileInfo-Objekte werden an die Pipeline gesendet. Format-Table verwendet den Parameter View , um die benutzerdefinierte Ansicht mygciview anzugeben, die die CreationTime-Spalte enthält.

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

Beispiel 5: Verwenden von Eigenschaften für die Tabellenausgabe

In diesem Beispiel wird der Parameter Property 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 an die Pipeline. Format-Table verwendet den Parameter Property , um anzugeben, dass die Eigenschaften Name und DependentServices in der Tabelle angezeigt werden.

Name und DependentServices sind zwei der 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-Processruft alle Editorprozesse des lokalen Computers ab und sendet die Objekte an 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 zwei Schlüsseln, Bezeichnung und Ausdruck angegeben. Der Bezeichnungsschlüssel gibt den Eigenschaftennamen an. Der Ausdrucksschlüssel 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 Parameter ComputerName 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-CimInstanceruft Instanzen der WMI-Win32_Process-Klasse ab, die alle Prozesse des lokalen Computers mit dem Namen notepad.exe beschreibt. Die Prozessobjekte werden in der $Processes Variablen gespeichert.

Die Prozessobjekte in der $Processes Variablen werden an die Pipeline Format-Tablegesendet, an die die ProcessName-Eigenschaft und eine neue berechnete Eigenschaft, Total Running Time, angezeigt wird.

Der Befehl weist dem Bezeichnungsschlüssel den Namen der neuen berechneten Eigenschaft "Total Running Time" zu. Der Skriptblock des Ausdrucksschlü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 DisplayError - oder ShowError-Parameter 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

-DisplayError

-Expand

-Force

-GroupBy

-HideTableHeaders

-InputObject

-Property

-RepeatHeader

-ShowError

-View

-Wrap

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 Einfärben der Ausgabe eingeführt. Die Farben können mithilfe der $PSStyle automatischen Variablen verwaltet werden. Die $PSStyle.Formatting.TableHeader Eigenschaft definiert die Farbe, die für die Kopfzeile der Tabelle verwendet wird, die von Format-Table. Weitere Informationen zu dieser Einstellung finden Sie unter about_ANSI_Terminals.

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

• Die Eingabeobjekte werden normalerweise mit der ToString() Methode außerhalb des Bandes formatiert. Dies gilt für [string] .NET-Grundtypen, bei denen es sich um eine Obermenge der integrierten numerischen Typen wie , [long]usw[int]. handelt.

• Die Eingabeobjekte weisen keine öffentlichen Eigenschaften auf.

• Die Eingabeobjekte sind Instanzen der Wrappertypen, die PowerShell für andere Ausgabedatenströme als den Erfolgsausgabedatenstrom verwendet. Dies gilt nur, wenn diese Wrappertypen an den Erfolgsausgabedatenstrom gesendet werden, der sie entweder über allgemeine Parameter wie ErrorVariable zuerst erfasst oder eine Umleitung wie z *>&1. B. verwendet.

  • Zu den Wrappertypen gehören:

    • System.Management.Automation.ErrorRecord
    • System.Management.Automation.WarningRecord
    • System.Management.Automation.VerboseRecord
    • System.Management.Automation.DebugRecord
    • System.Management.Automation.InformationRecord

Ähnliche Themen

• about_Calculated_Properties
• about_Format.ps1xml
• about_Hash_Tables
• Export-FormatData
• Format-Custom
• Format-Hex
• Format-List
• Format-Wide
• Get-FormatData
• Get-Member
• Get-CimInstance
• Update-FormatData