Format-List

Format-List
    [[-Property] <Object[]>]
    [-GroupBy <Object>]
    [-View <string>]
    [-ShowError]
    [-DisplayError]
    [-Force]
    [-Expand <string>]
    [-InputObject <psobject>]
    [<CommonParameters>]

Cmdleten Format-List formaterar utdata från ett kommando som en lista över egenskaper där varje egenskap visas på en separat rad. Du kan använda Format-List för att formatera och visa alla eller markerade egenskaper för ett objekt som en lista (Format-List -Property *).

Eftersom det finns mer utrymme för varje objekt i en lista än i en tabell, visar PowerShell fler egenskaper för objektet i listan och egenskapsvärdena är mindre benägna att trunkeras.

Get-Service | Format-List

Det här kommandot formaterar information om tjänster på datorn som en lista. Som standard formateras tjänsterna som en tabell. Cmdleten Get-Service hämtar objekt som representerar tjänsterna på datorn. Pipelineoperatorn (|) skickar resultatet via pipelinen till Format-List. Sedan formaterar kommandot Format-List tjänstinformationen i en lista och skickar den till standardutdata-cmdleten för visning.

Dessa kommandon visar information om PS1XML-filerna i PowerShell-katalogen som en lista.

$A = Get-ChildItem $PSHOME\*.ps1xml
Format-List -InputObject $A

Det första kommandot hämtar objekten som representerar filerna och lagrar dem i variabeln $A.

Det andra kommandot använder Format-List för att formatera information om objekt som lagras i $A. Det här kommandot använder parametern InputObject för att skicka variabeln till Format-List, som sedan skickar formaterade utdata till standardutdata-cmdleten för visning.

Det här kommandot visar namn, basprioritet och prioritetsklass för varje process på datorn.

Get-Process | Format-List -Property Name, BasePriority, PriorityClass

Den använder cmdleten Get-Process för att hämta ett objekt som representerar varje process. Pipelineoperatorn (|) skickar processobjekten via pipelinen till Format-List. Format-List formaterar processerna som en lista över de angivna egenskaperna. Parameternamnet egenskap är valfritt, så du kan utelämna det.

Det här kommandot visar alla egenskaper för Winlogon-processen.

Get-Process winlogon | Format-List -Property *

Den använder cmdleten Get-Process för att hämta ett objekt som representerar Winlogon-processen. Pipelineoperatorn (|) skickar Winlogon-processobjektet via pipelinen till Format-List. Kommandot använder parametern Property för att ange egenskaperna och * för att ange alla egenskaper. Eftersom namnet på parametern Egenskap är valfritt kan du utelämna det och ange kommandot som Format-List *. Format-List skickar automatiskt resultatet till standardutdata-cmdleten för visning.

Följande exempel visar resultatet av att lägga till parametrarna DisplayError eller ShowError med ett uttryck.

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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka valfritt objekt till den här cmdleten.

Den här cmdleten returnerar formatobjekten som representerar listan.

Windows PowerShell innehåller följande alias för Format-List:

• fl

Format-cmdletarna, till exempel Format-List, ordnar de data som ska visas men visar dem inte. Data visas av utdatafunktionerna i PowerShell och av de cmdletar som innehåller Out verbet (Out cmdletar), till exempel Out-Host eller Out-File.

Om du inte använder en format-cmdlet använder PowerShell det standardformatet för varje objekt som visas.

Med parametern View kan du ange ett alternativt format för tabellen. Du kan använda vyerna som definierats i *.format.ps1xml-filerna i PowerShell-katalogen, eller så kan du skapa egna vyer i nya PS1XML-filer och använda cmdleten Update-FormatData för att inkludera dem i PowerShell.

Den alternativa vyn för parametern View måste använda listformatet, annars misslyckas kommandot. Om den alternativa vyn är en tabell använder du Format-Table. Om den alternativa vyn inte är en lista eller en tabell använder du Format-Custom.

Om du vill använda Format-List med parametern Property måste du ta med parametern Force under något av följande villkor:

• Indataobjekten formateras utanför bandet med hjälp av metoden ToString(). Detta gäller för primitiva typer av [string] och .NET som är en supermängd av de inbyggda numeriska typerna, till exempel [int], [long]och andra.

• Indataobjekten har inga offentliga egenskaper.

• Indataobjekten är instanser av de omslutningstyper som PowerShell använder för andra typer av outputströmmar än den lyckade resultatutströmmen. Detta gäller endast när dessa omslutningstyper skickas till Success-utdataströmmen, vilket kräver att de antingen har fångats via vanliga parametrar som ErrorVariable först, eller genom att använda en omdirigering, till exempel *>&1.

  • Omslutningstyperna omfattar:

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