Dela via

Format-List

  • Referens
Modul:
Microsoft.PowerShell.Utility

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 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

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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Expand

Anger det formaterade samlingsobjektet samt objekten i samlingen. Den här parametern är utformad för att formatera objekt som stöder System.Collections.ICollection-gränssnittet. Standardvärdet är EnumOnly. De godtagbara 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.
Typ:String
Godkända värden:CoreOnly, EnumOnly, Both
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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. Parametern GroupBy förväntar sig att objekten sorteras. Använd cmdleten Sort-Object innan du använder Format-List för att gruppera objekten.

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.

Typ:Object
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:PSObject
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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. Parameternamnet egenskap är valfritt. Du kan inte använda parametrarna Property och View i samma kommando.

Värdet för parametern Property 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.

Typ:Object[]
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-View

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 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: