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 |
Required: | False |
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 |
Required: | False |
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 en del av felinformationen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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
(ellerLabel
) -<string>
Expression
-<string>
Eller<script block>
FormatString
-<string>
Mer information finns i about_Calculated_Properties.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
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
(ellerLabel
) -<string>
Expression
-<string>
Eller<script block>
FormatString
-<string>
Mer information finns i about_Calculated_Properties.
Type: | Object[] |
Position: | 0 |
Default value: | None |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
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 att data visas men inte visar dem.
Data visas av utdatafunktionerna i PowerShell och av de cmdletar som innehåller verbet Out
Out
(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
.