Format-List
Formatiert die Ausgabe als eine Liste der Eigenschaften, in der jede Eigenschaft in einer neuen Zeile angezeigt wird.
Syntax
Format-List
[[-Property] <Object[]>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]
Beschreibung
Das Format-List
Cmdlet formatiert die Ausgabe eines Befehls als Liste von Eigenschaften, in denen jede Eigenschaft in einer separaten Zeile angezeigt wird. Sie können verwenden Format-List
, um alle oder ausgewählte Eigenschaften eines Objekts als Liste (Format-List -Property *
) zu formatieren und anzuzeigen.
Da für jedes Element in einer Liste mehr Speicherplatz als in einer Tabelle verfügbar ist, zeigt PowerShell mehr Eigenschaften des Objekts in der Liste an, und die Eigenschaftswerte werden weniger wahrscheinlich abgeschnitten.
Beispiele
Beispiel 1: Formatieren von Computerdiensten
Get-Service | Format-List
Dieser Befehl formatiert Informationen zu Diensten auf dem Computer als Liste. Standardmäßig sind die Dienste als Tabelle formatiert. Das Get-Service
Cmdlet ruft Objekte ab, die die Dienste auf dem Computer darstellen. Der Pipelineoperator (|
) übergibt die Ergebnisse an die Pipeline Format-List
.
Anschließend formatiert der Format-List
Befehl die Dienstinformationen in einer Liste und sendet sie zur Anzeige an das Standardausgabe-Cmdlet.
Beispiel 2: Formatieren von PS1XML-Dateien
Diese Befehle zeigen Informationen zu den PS1XML-Dateien im PowerShell-Verzeichnis als Liste an.
$A = Get-ChildItem $pshome\*.ps1xml
Format-List -InputObject $A
Der erste Befehl ruft die Objekte ab, die die Dateien darstellen, und speichert sie in der $A
Variablen.
Der zweite Befehl verwendet Format-List
zum Formatieren von Informationen zu Objekten, die in $A
gespeichert sind. Dieser Befehl verwendet den InputObject-Parameter , um die Variable an zu Format-List
übergeben, die dann die formatierte Ausgabe zur Anzeige an das Standardausgabe-Cmdlet sendet.
Beispiel 3: Formatieren von Prozesseigenschaften nach Name
Dieser Befehl zeigt Name, Basispriorität und Prioritätsklasse für jeden Prozess auf dem Computer an.
Get-Process | Format-List -Property Name, BasePriority, PriorityClass
Es verwendet das Get-Process
Cmdlet, um ein Objekt abzurufen, das jeden Prozess darstellt. Der Pipelineoperator (|
) übergibt die Prozessobjekte durch die Pipeline an Format-List
. Format-List
formatiert die Prozesse als Liste der angegebenen Eigenschaften. Der Name des Eigenschaftsparameters ist optional, sodass Sie ihn weglassen können.
Beispiel 4: Formatieren aller Eigenschaften für einen Prozess
Dieser Befehl zeigt alle Eigenschaften des Winlogon-Prozesses an.
Get-Process winlogon | Format-List -Property *
Er verwendet das Get-Process-Cmdlet zum Abrufen eines Objekts, das den Winlogon-Prozess darstellt. Der Pipelineoperator (|
) übergibt das Winlogon-Prozessobjekt durch die Pipeline an Format-List
. Der Befehl verwendet den Parameter Property , um die Eigenschaften anzugeben, und den *
, um alle Eigenschaften anzugeben.
Da der Name des Property-Parameters optional ist, können Sie ihn weglassen und den Befehl als Format-List *
eingeben. Format-List
Sendet die Ergebnisse automatisch zur Anzeige an das Standardausgabe-Cmdlet.
Beispiel 5: Problembehandlung bei Formatfehlern
Die folgenden Beispiele zeigen die Ergebnisse des Hinzufügens der Parameter DisplayError oder ShowError mit einem Ausdruck.
PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -DisplayError
DayOfWeek : Friday
$_ / $null : #ERR
PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError
DayOfWeek : Friday
$_ / $null :
Failed to evaluate expression " $_ / $null ".
+ CategoryInfo : InvalidArgument: (12/21/2018 7:59:23 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError
Parameter
-DisplayError
Gibt an, dass dieses Cmdlet Fehler an der Befehlszeile anzeigt. Dieser Parameter wird selten verwendet, kann aber als Debughilfe verwendet werden, wenn Sie Ausdrücke in einem Format-List
Befehl formatieren, und die Ausdrücke scheinen nicht zu funktionieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Expand
Gibt das formatierte Auflistungsobjekt sowie die Objekte in der Auflistung an. Dieser Parameter ist zum Formatieren von Objekten konzipiert, die die System.Collections.ICollection-Schnittstelle unterstützen. Standardwert: EnumOnly
. Zulässige Werte für diesen Parameter:
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 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 dieses Cmdlet alle Fehlerinformationen anzeigt. Verwenden Sie mit dem Parameter DisplayError oder ShowError . Wenn ein Fehlerobjekt in die Fehler- oder Anzeigedatenströme geschrieben wird, werden standardmäßig nur einige der Fehlerinformationen angezeigt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GroupBy
Gibt die Ausgabe in Gruppen basierend auf einer freigegebenen Eigenschaft oder einem freigegebenen Wert an. Geben Sie einen Ausdruck oder eine Eigenschaft der Ausgabe ein.
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
(oderLabel
) -<string>
Expression
-<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 |
-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, durch den 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. Platzhalter sind zulässig.
Wenn Sie diesen Parameter weglassen, hängen die in der Anzeige dargestellten Eigenschaften von dem angezeigten Objekt ab. Die Parametername-Eigenschaft 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
(oderLabel
) -<string>
Expression
-<string>
oder<script block>
FormatString
-<string>
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 |
-ShowError
Gibt an, dass das Cmdlet Fehler über die Pipeline sendet. Dieser Parameter wird selten verwendet, kann aber als Debughilfe verwendet werden, wenn Sie Ausdrücke in einem Format-List
Befehl formatieren, und die Ausdrücke scheinen nicht zu funktionieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-View
Gibt den Namen eines alternativen Listenformats oder einer alternativen Ansicht an. 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 |
Eingaben
Sie können jedes Objekt an übergeben Format-List
.
Ausgaben
Microsoft.PowerShell.Commands.Internal.Format
Format-List
gibt die Formatobjekte zurück, die die Liste darstellen.
Hinweise
Sie können auch auf den Format-List
integrierten Alias verweisen. fl
Weitere Informationen finden Sie unter about_Aliases.
Die Format-Cmdlets, z Format-List
. B. , ordnen die Angezeigten Daten an, zeigen sie aber nicht an.
Die Daten werden durch die Ausgabefeatures von PowerShell und durch die Cmdlets angezeigt, die das Out
Verb (die Out
Cmdlets) enthalten, z Out-Host
. B. oder Out-File
.
Wenn Sie kein Format-Cmdlet verwenden, wendet PowerShell dieses Standardformat für jedes angezeigte Objekt an.
Der GroupBy-Parameter geht davon aus, dass die Objekte sortiert sind. Verwenden Sie Sort-Object
vor der Verwendung Format-List
, um die Objekte zu gruppieren.
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 PowerShell-Verzeichnis definierten Ansichten verwenden, oder Sie können Ihre eigenen Ansichten in neuen PS1XML-Dateien erstellen und das Cmdlet Update-FormatData verwenden, um sie in PowerShell einzuschließen.
Die alternative Ansicht für den View-Parameter muss das Listenformat verwenden, andernfalls schlägt der Befehl fehl. Wenn es sich bei der alternativen Ansicht um eine Tabelle handelt, verwenden Sie Format-Table
. Wenn die alternative Ansicht keine Liste oder Tabelle ist, verwenden Sie Format-Custom
.