Formatiert die Ausgabe als Liste von Eigenschaften, in der jede Eigenschaft in einer neuen Zeile angezeigt wird.
Syntax
Format-List [[-Eigenschaft] <Object[]>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Format-List" wird die Ausgabe eines Befehls als Liste von Eigenschaften formatiert, in der jede Eigenschaft in einer eigenen Zeile angezeigt wird. Sie können mithilfe von Format-List alle oder ausgewählte Eigenschaften eines Objekts als Liste formatieren (format-list *) und anzeigen.
Weil in einer Liste mehr Platz für jedes Element als in einer Tabelle verfügbar ist, zeigt Windows PowerShell in der Liste mehr Eigenschaften des Objekts an, und die Wahrscheinlichkeit ist geringer, dass Eigenschaftenwerte abgeschnitten werden.
Parameter
-DisplayError
Zeigt Fehler in der Befehlszeile an.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Expand <string>
Formatiert das Auflistungsobjekt sowie die Objekte in der Auflistung. Mit diesem Parameter werden Objekte formatiert, die die ICollection-Schnittstelle (System.Collections) unterstützen. Der Standardwert ist "EnumOnly".
Gültige Werte:
– EnumOnly: Zeigt die Eigenschaften der Objekte in der Auflistung an.
– CoreOnly: Zeigt die Eigenschaften des Auflistungsobjekts an.
– Both: Zeigt die Eigenschaften des Auflistungsobjekts und die Eigenschaften der Objekte in der Auflistung an.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Force
Weist das Cmdlet an, alle Fehlerinformationen anzuzeigen. Wird mit dem DisplayError-Parameter oder dem ShowError-Parameter verwendet. Wenn ein Fehlerobjekt in die Fehler- oder Anzeigestreams geschrieben wird, werden standardmäßig nur einige der Fehlerinformationen angezeigt.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-GroupBy <Object>
Formatiert die Ausgabe anhand einer freigegebenen Eigenschaft oder eines freigegebenen Werts in Gruppen. Geben Sie einen Ausdruck oder eine Eigenschaft der Ausgabe ein.
Bei dem Wert des GroupBy-Parameters kann es sich um eine neu berechnete Eigenschaft handeln. Verwenden Sie zum Erstellen einer berechneten Eigenschaft eine Hashtabelle. Gültige Schlüssel sind:
– Name (oder Label) <Zeichenfolge>
– Expression <Zeichenfolge> oder <Skriptblock>
– FormatString <Zeichenfolge>
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-InputObject <psobject>
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.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
false |
-Eigenschaft <Object[]>
Gibt die Objekteigenschaften an, die angezeigt werden, sowie die Reihenfolge ihrer Anzeige. Platzhalter sind zulässig.
Wenn Sie diesen Parameter auslassen, hängen die angezeigten Eigenschaften vom angezeigten Objekt ab. Der Parametername ("Property") ist optional. Sie können den Property-Parameter nicht zusammen mit dem View-Parameter in einem Befehl verwenden.
Bei dem Wert des Property-Parameters kann es sich um eine neu berechnete Eigenschaft handeln. Verwenden Sie zum Erstellen einer berechneten Eigenschaft eine Hashtabelle.
Gültige Schlüssel sind:
– Name (oder Label) <Zeichenfolge>
– Expression <Zeichenfolge> oder <Skriptblock>
– FormatString <Zeichenfolge>
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-ShowError
Übergibt Fehler über die Pipeline.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-View <string>
Gibt den Namen eines alternativen Listenformats bzw. einer alternativen Listenansicht an. Sie können den Property-Parameter nicht zusammen mit dem View-Parameter in einem Befehl verwenden.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.Management.Automation.PSObject Sie können jedes Objekt über die Pipeline an Format-List übergeben. |
|
Ausgaben |
Microsoft.PowerShell.Commands.Internal.Format Format-List gibt die Formatobjekte zurück, die die Liste darstellen. |
Hinweise
Sie können auch über den integrierten Alias "FL" auf Format-List verweisen. Weitere Informationen finden Sie unter "about_Aliases".
Die Format-Cmdlets, z. B. "Format-List", ordnen die anzuzeigenden Daten an, zeigen sie jedoch nicht an. Die Daten werden von den Ausgabefeatures von Windows PowerShell und von den Cmdlets, die das Verb "Out" enthalten (Ausgabe-Cmdlets), angezeigt, z. B. "Out-Host", "Out-File" und "Out-Printer".
Wenn Sie kein Format-Cmdlet verwenden, wendet Windows PowerShell für jedes angezeigte Objekt das Standardformat an.
Für den GroupBy-Parameter wird vorausgesetzt, dass die Objekte sortiert sind. Bevor Sie die Objekte mit Format-Custom gruppieren, sortieren Sie sie mit Sort-Object.
Mit dem View-Parameter können Sie ein alternatives Format für die Tabelle angeben. Sie können die in den *.FORMAT.PS1XML-Dateien im Windows PowerShell-Verzeichnis definierten Ansichten verwenden oder eigene Ansichten in neuen PS1XML-Dateien erstellen und sie mit dem Cmdlet "Update-FormatData" in Windows PowerShell einfügen.
Für die alternative Ansicht für den View-Parameter muss das Listenformat verwendet werden. Andernfalls verursacht der Befehl einen Fehler. Wenn die alternative Ansicht eine Tabelle ist, verwenden Sie Format-Table. Wenn die alternative Ansicht weder eine Liste noch eine Tabelle ist, verwenden Sie Format-Custom.
Beispiel 1
C:\PS>get-service | format-list Beschreibung ----------- Mit diesem Befehl werden Informationen über die Dienste auf dem Computer als Liste formatiert. Die Dienste werden standardmäßig als Tabelle formatiert. Mit dem Cmdlet "Get-Service" werden Objekte abgerufen, die die Dienste auf dem Computer darstellen. Der Pipelineoperator (|) übergibt die Ergebnisse über die Pipeline an Format-List. Anschließend werden mit dem Befehl "Format-List" die Dienstinformationen als Liste formatiert und für die Anzeige an das standardmäßige Ausgabe-Cmdlet gesendet.
Beispiel 2
C:\PS>$a = get-childitem $pshome\*.ps1xml Beschreibung ----------- Mit diesen Befehlen werden Informationen über die PS1XML-Dateien im Windows PowerShell-Verzeichnis als Liste angezeigt. Im ersten Befehl werden die Objekte abgerufen, die die Dateien darstellen, und in der Variablen "$a" gespeichert. Im zweiten Befehl werden Informationen über in "$a" gespeicherte Objekte mit Format-List formatiert. In diesem Befehl wird die Variable mithilfe des InputObject-Parameters an Format-List übergeben, das dann die formatierte Ausgabe für die Anzeige an das standardmäßige Ausgabe-Cmdlet sendet.
Beispiel 3
C:\PS>get-process | format-list -property name, basepriority, priorityclass Beschreibung ----------- Mit diesem Befehl werden Name, Basispriorität und Prioritätsklasse der einzelnen Prozesse auf dem Computer angezeigt. Mit dem Cmdlet "Get-Process" werden Objekte abgerufen, die die einzelnen Prozesse darstellen. Der Pipelineoperator (|) übergibt die Prozessobjekte über die Pipeline an Format-List. Format-List formatiert die Prozesse als Liste der angegebenen Eigenschaften. Der Property-Parametername ist optional. Sie können ihn also auslassen.
Beispiel 4
C:\PS>get-process winlogon | format-list -property * Beschreibung ----------- Mit diesem Befehl werden alle Eigenschaften der Windows-Anmeldung angezeigt. Mit dem Cmdlet "Get-Process" wird ein Objekt abgerufen, das die Windows-Anmeldung darstellt. Der Pipelineoperator (|) übergibt das Windows-Anmeldungsobjekt über die Pipeline an Format-List. In dem Befehl werden mit dem Property-Parameter spezifische Eigenschaften und mit "*" alle Eigenschaften angegeben. Da der Name des Property-Parameters optional ist, können Sie ihn weglassen und den Befehl wie folgt eingeben: "format-list *". Format-List sendet die Ergebnisse automatisch zur Anzeige an das standardmäßige Ausgabe-Cmdlet.