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 *).

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 gränssnittet ICollection (System.Collections). Standardvärdet är EnumOnly. De godtagbara värdena för den här parametern är:

  • Uppräkning. Visar egenskaperna för objekten i samlingen.
  • CoreOnly. Visar egenskaperna för samlingsobjektet.
  • Båda. 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 en del av felinformationen.

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.

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:

  • Namn (eller etikett) – <string>
  • Uttryck – <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:

  • Namn (eller etikett) – <string>
  • Uttryck – <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 Format-List.

Utdata

Microsoft.PowerShell.Commands.Internal.Format

Format-List returnerar formatobjekten som representerar listan.

Kommentarer

Du kan också referera till Format-List med dess inbyggda alias FL. Mer information finns i about_Aliases.

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 (ut-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 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.