Format-Table

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

Das cmdlet Format-Table 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 jedoch den Parameter Property verwenden, um die anzuzeigenden Eigenschaften auszuwählen.

Sie können auch eine Hashtabelle verwenden, um berechnete Eigenschaften zu einem Objekt hinzuzufügen, bevor Sie es anzeigen und die Spaltenüberschriften in der Tabelle angeben. Um eine berechnete Eigenschaft hinzuzufügen, verwenden Sie den Parameter Property oder GroupBy.

Dieser Befehl zeigt Informationen zum Hostprogramm für PowerShell in einer Tabelle an. Standardmäßig sind sie in einer Liste formatiert.

Get-Host | Format-Table -AutoSize

Das Cmdlet Get-Host ruft Objekte ab, die den Host darstellen. Der Pipelineoperator (|) übergibt das Objekt an das Cmdlet Format-Table. Das cmdlet Format-Table formatiert die Objekte in einer Tabelle. Mit dem AutoSize-Parameter werden die Spaltenbreiten angepasst, um Abschneidungen zu minimieren.

Mit diesem Befehl werden die Prozesse auf dem Computer in Gruppen mit derselben Basispriorität angezeigt.

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

Das Cmdlet Get-Process ruft Objekte ab, die jeden Prozess auf dem Computer darstellen. Der Pipelineoperator (|) übergibt das Objekt an das Cmdlet Sort-Object, das die Objekte in der Reihenfolge ihrer Basispriorität sortiert.

Ein anderer Pipelineoperator übergibt die Ergebnisse an das Cmdlet Format-Table. Der parameter GroupBy ordnet die Daten zu den Prozessen in Gruppen basierend auf dem Wert ihrer BasePriority-Eigenschaft an. Der parameter Wrap stellt sicher, dass Daten nicht abgeschnitten werden.

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

Mit diesem Befehl werden Informationen zu den Prozessen auf dem Computer in der Gruppe basierend auf dem Startdatum des Prozesses angezeigt. Es verwendet das Cmdlet Get-Process, um Objekte abzurufen, die die Prozesse auf dem Computer darstellen. Der Pipelineoperator (|) sendet die Ausgabe von Get-Process an das Cmdlet Sort-Object, das sie basierend auf der StartTime-Eigenschaft sortiert. Ein anderer Pipelineoperator sendet die sortierten Ergebnisse an Format-Table.

Der parameter View wird verwendet, um die StartTime Ansicht auszuwählen, die in der datei DotNetTypes.format.ps1xml für System.Diagnostics.Process--Objekte definiert ist, z. B. die von Get-Processzurückgegebenen Objekte. In dieser Ansicht werden die StartTime- des Prozesses in ein kurzes Datum konvertiert und dann die Prozesse nach Startdatum gruppiert.

Die datei DotNetTypes.format.ps1xml enthält auch eine Priority ansicht für Prozesse. Sie können eigene format.ps1xml-Dateien mit angepassten Ansichten erstellen.

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

Mit diesem Befehl werden alle Dienste auf dem Computer in einer Tabelle mit zwei Spalten Name und DependentServices-angezeigt. Das Cmdlet Get-Service ruft alle Dienste auf dem Computer ab. Der Pipelineoperator (|) sendet die Ergebnisse an das Cmdlet Format-Table, das die Ausgabe in einer Tabelle formatiert. Der parameter Property gibt die Eigenschaften an, die in der Tabelle als Spalten angezeigt werden. Der Name des Property-Parameters ist optional, sodass Sie ihn weglassen können, z. B. Format-Table Name, DependentServices.

Name und DependentServices sind nur zwei der Eigenschaften von Dienstobjekten. Geben Sie Get-Service | Get-Member -MemberType Propertiesein, um alle Eigenschaften anzuzeigen.

Dieser Befehl zeigt, wie sie eine berechnete Eigenschaft in einer Tabelle verwenden.

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

Der Befehl zeigt eine Tabelle mit dem Prozessnamen und der Gesamtlaufzeit aller Editorprozesse auf dem lokalen Computer an. Die Gesamtlaufzeit wird berechnet, indem die Startzeit jedes Prozesses von der aktuellen Zeit subtrahiert wird.

Der Befehl verwendet das Cmdlet Get-Process, um alle Prozesse namens Notepad auf dem lokalen Computer abzurufen. Der Pipelineoperator (|) sendet die Ergebnisse an Format-Table, wodurch eine Tabelle mit zwei Spalten angezeigt wird: ProcessName, eine Standardeigenschaft von Prozessen und TotalRunningTime, eine berechnete Eigenschaft.

Die TotalRunningTime--Eigenschaft wird durch eine Hashtabelle mit zwei Schlüsseln angegeben, Label und Expression. Der Name der Eigenschaft wird dem schlüssel Label zugewiesen. Die Berechnung wird dem schlüssel Expression zugewiesen. 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.

Diese Befehle ähneln dem vorherigen Befehl, mit der Ausnahme, dass diese Befehle das cmdlet Get-WmiObject verwenden.

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

Der erste Befehl verwendet das Cmdlet Get-WmiObject zum Abrufen von Instanzen der WMI-Win32_Process Klasse, die alle Prozesse auf dem Server01-Computer beschreibt, die Notepad.exebenannt sind. Der Befehl speichert die Prozessinformationen in der variablen $Processes.

Der zweite Befehl verwendet einen Pipelineoperator (|), um die Prozessinformationen in der $Processes Variablen an das Cmdlet Format-Table zu senden, der die ProcessName- und eine neue berechnete Eigenschaft anzeigt.

Der Befehl weist der Bezeichnung Schlüssel den Namen der neuen berechneten Eigenschaft "Total Running Time" zu. Der Skriptblock, der dem Ausdruck Schlüssels zugewiesen ist, berechnet, wie lange der Prozess ausgeführt wurde, indem das Erstellungsdatum des Prozesses vom aktuellen Datum subtrahiert wird. Das Cmdlet Get-Date ruft das aktuelle Datum ab. Die ConvertToDateTime--Methode konvertiert die CreationDate -Eigenschaft des Win32_Process -Objekts aus einem WMI-CIM_DATETIME -Objekt in ein .NET DateTime -Objekt, das mit der Ausgabe von Get-Dateverglichen werden kann. Anschließend wird das konvertierte Erstellungsdatum vom aktuellen Datum subtrahiert. Das Ergebnis ist der Wert Gesamtlaufzeit.

Die folgenden Beispiele zeigen die Ergebnisse, wenn Sie die Parameter DisplayError oder ShowError mit einem Ausdruck hinzufügen.

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

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

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

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

Failed to evaluate expression " $_ / $null ".
    + CategoryInfo          : InvalidArgument: (10/30/2013 2:28:07 PM:PSObject) \[\], RuntimeException
    + FullyQualifiedErrorId : mshExpressionError

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 jedes Objekt an Format-Tablepfeifen.

Format-Table gibt Formatobjekte zurück, die die Tabelle darstellen.

Der parameter GroupBy geht davon aus, dass die Objekte sortiert sind. Verwenden Sie das Cmdlet Sort-Object, bevor Sie Format-Table verwenden, um die Objekte zu gruppieren.

Mit dem Parameter View können Sie ein alternatives Format für die Tabelle angeben. Sie können die in den *.format.PS1XML Dateien im PowerShell-Verzeichnis definierten Ansichten verwenden oder eigene Ansichten in neuen PS1XML-Dateien erstellen und dann das cmdlet Update-FormatData verwenden, um sie in PowerShell einzuschließen. Die alternativen Ansichten für den Parameter View müssen das Tabellenformat verwenden, andernfalls schlägt der Befehl fehl. Wenn es sich bei der alternativen Ansicht um eine Liste handelt, verwenden Sie das Cmdlet Format-List. Wenn die alternative Ansicht weder eine Liste noch eine Tabelle ist, verwenden Sie das cmdlet Format-Custom.