Format-List

Syntax

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

Description

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.

Exempel

Exempel 1: Formatera datortjänster

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.

Exempel 2: Formatera PS1XML-filer

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.

Exempel 3: Formatera processegenskaper efter namn

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.

Exempel 4: Formatera alla egenskaper för en process

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.

Exempel 5: Felsöka formatfel

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

Parametrar

-DisplayError

-Expand

-Force

-GroupBy

-InputObject

-Property

-ShowError

-View

Indata

PSObject

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

Utdata

Microsoft.PowerShell.Commands.Internal.Format

Den här cmdleten returnerar formatobjekten som representerar listan.

Kommentarer

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 wrappertyper som PowerShell använder för strömmar, bortsett från framgångsströmmen. Detta gäller endast när dessa omslutningstyper skickas till framgångsudataströmmen, vilket kräver att de har fångats antingen via vanliga parametrar som ErrorVariable först eller genom att använda en omdirigering som *>&1.

  • Omslutningstyperna omfattar:

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

Relaterade länkar

• om_Beräknade_Egenskaper
• Format-Custom
• Format-Hex
• Format-Table
• Format-Wide