Format-List

Formaterar utdata som en lista över egenskaper där varje egenskap visas på en ny rad.

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 mer utrymme är tillgängligt 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. Format-List Sedan formaterar kommandot 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 de objekt 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. Egenskapsparameternamnet ä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 Egenskap för att ange egenskaperna och * för att ange alla egenskaper. Eftersom namnet på egenskapsparametern är valfritt kan du utelämna det och skriva 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

Anger att den här cmdleten visar fel på kommandoraden. Den här parametern används sällan, men kan användas som felsökningshjälp när du formaterar uttryck i ett Format-List kommando och uttrycken inte verkar fungera.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Expand

Anger det formaterade samlingsobjektet samt objekten i samlingen. Den här parametern är utformad för att formatera objekt som stöder gränssnittet System.Collections.ICollection . Standardvärdet är EnumOnly. De acceptabla värdena för den här parametern är:

  • EnumOnly. Visar egenskaperna för objekten i samlingen.
  • CoreOnly. Visar egenskaperna för samlingsobjektet.
  • Both. Visar egenskaperna för samlingsobjektet och egenskaperna för objekt i samlingen.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

Anger att den här cmdleten visar all felinformation. Använd med parametern DisplayError eller ShowError . När ett felobjekt skrivs till fel- eller visningsströmmar visas som standard endast viss felinformation.

Krävs även vid formatering av vissa .NET-typer. Mer information finns i avsnittet Anteckningar .

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-GroupBy

Anger utdata i grupper baserat på en delad egenskap eller ett delat värde. Ange ett uttryck eller en egenskap för utdata.

Värdet för parametern GroupBy kan vara en ny beräknad egenskap. Den beräknade egenskapen kan vara ett skriptblock eller en hash-tabell. Giltiga nyckel/värde-par är:

  • Name (eller Label) - <string>
  • Expression - <string> Eller <script block>
  • FormatString - <string>

Mer information finns i about_Calculated_Properties.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Anger vilka objekt som ska formateras. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten.

Type:PSObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Property

Anger de objektegenskaper som visas i visningen och i vilken ordning de visas. Jokertecken tillåts.

Om du utelämnar den här parametern beror egenskaperna som visas i visningen på det objekt som visas. Parameternamnegenskapen är valfri. Du kan inte använda parametrarna Egenskap och Visa i samma kommando.

Värdet för parametern Egenskap kan vara en ny beräknad egenskap. Den beräknade egenskapen kan vara ett skriptblock eller en hash-tabell. Giltiga nyckel/värde-par är:

  • Name (eller Label) - <string>
  • Expression - <string> Eller <script block>
  • FormatString - <string>

Mer information finns i about_Calculated_Properties.

Type:Object[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-ShowError

Anger att cmdleten skickar fel via pipelinen. Den här parametern används sällan, men kan användas som felsökningshjälp när du formaterar uttryck i ett Format-List kommando och uttrycken inte verkar fungera.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-View

Anger namnet på ett alternativt listformat eller en alternativ vy. Du kan inte använda parametrarna Egenskap och Visa i samma kommando.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

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

  • Alla plattformar:
    • fl

Format-cmdletarna, till exempel Format-List, ordnar att data visas men inte visar dem. Data visas av utdatafunktionerna i PowerShell och av de cmdletar som innehåller verbet OutOut (cmdletarna), 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.

Parametern GroupBy förutsätter att objekten sorteras. Använd Sort-Object innan du använder Format-List för att gruppera objekten.

Med parametern Visa 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 view-parametern 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 Egenskap måste du inkludera parametern Force under något av följande villkor: