Feedback

Format-List

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee wordt de uitvoer opgemaakt als een lijst met eigenschappen waarin elke eigenschap op een nieuwe regel wordt weergegeven.

Syntax

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

Description

Met Format-List de cmdlet wordt de uitvoer van een opdracht opgemaakt als een lijst met eigenschappen waarin elke eigenschap op een afzonderlijke regel wordt weergegeven. U kunt alle Format-List of geselecteerde eigenschappen van een object opmaken en weergeven als een lijst (Format-List -Property *).

Omdat er meer ruimte beschikbaar is voor elk item in een lijst dan in een tabel, worden in PowerShell meer eigenschappen van het object in de lijst weergegeven en worden de eigenschapswaarden minder snel afgekapt.

Voorbeelden

Voorbeeld 1: Computerservices opmaken

Get-Service | Format-List

Met deze opdracht wordt informatie over services op de computer opgemaakt als een lijst. De services zijn standaard opgemaakt als een tabel. De Get-Service cmdlet haalt objecten op die de services op de computer vertegenwoordigen. De pijplijnoperator (|) geeft de resultaten door via de pijplijn aan Format-List. Vervolgens wordt met de Format-List opdracht de service-informatie in een lijst opgemaakt en verzonden naar de standaarduitvoer-cmdlet voor weergave.

Voorbeeld 2: PS1XML-bestanden opmaken

Met deze opdrachten wordt informatie weergegeven over de PS1XML-bestanden in de PowerShell-map als een lijst.

$A = Get-ChildItem $pshome\*.ps1xml
Format-List -InputObject $A

Met de eerste opdracht worden de objecten opgehaald die de bestanden vertegenwoordigen en worden opgeslagen in de $A variabele.

De tweede opdracht gebruikt Format-List voor het opmaken van informatie over objecten die zijn opgeslagen in $A. Met deze opdracht wordt de parameter InputObject gebruikt om de variabele door te geven aan Format-List, waarna de opgemaakte uitvoer wordt verzonden naar de standaarduitvoer-cmdlet voor weergave.

Voorbeeld 3: Proceseigenschappen op naam opmaken

Met deze opdracht worden de naam, de basisprioriteit en de prioriteitsklasse van elk proces op de computer weergegeven.

Get-Process | Format-List -Property Name, BasePriority, PriorityClass

De cmdlet gebruikt de Get-Process cmdlet om een object op te halen dat elk proces vertegenwoordigt. De pijplijnoperator (|) geeft de procesobjecten door via de pijplijn aan Format-List. Format-List formatteert de processen als een lijst met de opgegeven eigenschappen. De parameternaam van de eigenschap is optioneel, zodat u deze kunt weglaten.

Voorbeeld 4: Alle eigenschappen voor een proces opmaken

Met deze opdracht worden alle eigenschappen van het Winlogon-proces weergegeven.

Get-Process winlogon | Format-List -Property *

Hierbij wordt de cmdlet Get-Process gebruikt om een object op te halen dat het Winlogon-proces vertegenwoordigt. De pijplijnoperator (|) geeft het Winlogon-procesobject door aan de pijplijn door aan Format-List. De opdracht gebruikt de parameter Eigenschap om de eigenschappen op te geven en de * om alle eigenschappen aan te geven. Omdat de naam van de parameter Eigenschap optioneel is, kunt u deze weglaten en de opdracht typen als Format-List *. Format-List verzendt de resultaten automatisch naar de standaarduitvoer-cmdlet voor weergave.

Voorbeeld 5: Opmaakfouten oplossen

In de volgende voorbeelden ziet u de resultaten van het toevoegen van de parameters DisplayError of ShowError met een expressie.

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

Parameters

-DisplayError

Geeft aan dat deze cmdlet fouten weergeeft op de opdrachtregel. Deze parameter wordt zelden gebruikt, maar kan worden gebruikt als foutopsporingshulp wanneer u expressies in een Format-List opdracht opmaakt en de expressies niet werken.

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

Hiermee geeft u het opgemaakte verzamelingsobject en de objecten in de verzameling. Deze parameter is ontworpen om objecten op te maken die ondersteuning bieden voor de Interface System.Collections.ICollection . De standaardwaarde is EnumOnly. De aanvaardbare waarden voor deze parameter zijn:

  • EnumOnly. Geeft de eigenschappen van de objecten in de verzameling weer.
  • CoreOnly. Geeft de eigenschappen van het verzamelingsobject weer.
  • Both. Geeft de eigenschappen van het verzamelingsobject en de eigenschappen van objecten in de verzameling weer.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

Geeft aan dat met deze cmdlet alle foutgegevens worden weergegeven. Gebruiken met de parameter DisplayError of ShowError . Wanneer een foutobject standaard naar de fout of weergavestreams wordt geschreven, wordt slechts een deel van de foutinformatie weergegeven.

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

Hiermee geeft u de uitvoer in groepen op basis van een gedeelde eigenschap of waarde. Voer een expressie of een eigenschap van de uitvoer in.

De waarde van de parameter GroupBy kan een nieuwe berekende eigenschap zijn. De berekende eigenschap kan een scriptblok of een hash-tabel zijn. Geldige sleutel-waardeparen zijn:

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

Zie about_Calculated_Properties voor meer informatie.

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

Hiermee geeft u de objecten die moeten worden opgemaakt. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.

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

Hiermee geeft u de objecteigenschappen op die worden weergegeven in de weergave en de volgorde waarin ze worden weergegeven. Jokertekens zijn toegestaan.

Als u deze parameter weglaat, zijn de eigenschappen die in de weergave worden weergegeven afhankelijk van het object dat wordt weergegeven. De eigenschap van de parameternaam is optioneel. U kunt de eigenschaps- en weergaveparameters niet gebruiken in dezelfde opdracht.

De waarde van de parameter Eigenschap kan een nieuwe berekende eigenschap zijn. De berekende eigenschap kan een scriptblok of een hash-tabel zijn. Geldige sleutel-waardeparen zijn:

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

Zie about_Calculated_Properties voor meer informatie.

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

Geeft aan dat de cmdlet fouten verzendt via de pijplijn. Deze parameter wordt zelden gebruikt, maar kan worden gebruikt als foutopsporingshulp wanneer u expressies in een Format-List opdracht opmaakt en de expressies niet werken.

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

Hiermee geeft u de naam van een alternatieve lijstindeling of weergave. U kunt de eigenschaps- en weergaveparameters niet gebruiken in dezelfde opdracht.

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

Invoerwaarden

PSObject

U kunt elk object doorsluisen naar Format-List.

Uitvoerwaarden

Microsoft.PowerShell.Commands.Internal.Format

Format-List retourneert de indelingsobjecten die de lijst vertegenwoordigen.

Notities

U kunt ook verwijzen naar Format-List de ingebouwde alias. fl Zie about_Aliases voor meer informatie.

De indelings-cmdlets, zoals Format-List, rangschikken de gegevens die moeten worden weergegeven, maar niet weergeven. De gegevens worden weergegeven door de uitvoerfuncties van PowerShell en door de cmdlets die het Out werkwoord (de Out cmdlets) bevatten, zoals Out-Host of Out-File.

Als u geen indelings-cmdlet gebruikt, past PowerShell die standaardindeling toe voor elk object dat wordt weergegeven.

Bij de parameter GroupBy wordt ervan uitgegaan dat de objecten zijn gesorteerd. Gebruik Sort-Object dit voordat u Format-List de objecten groeperen.

Met de parameter Weergave kunt u een alternatieve indeling voor de tabel opgeven. U kunt de weergaven gebruiken die zijn gedefinieerd in de *.format.PS1XML bestanden in de PowerShell-map of u kunt uw eigen weergaven maken in nieuwe PS1XML-bestanden en de Update-FormatData cmdlet gebruiken om ze op te nemen in PowerShell.

De alternatieve weergave voor de parameter Weergave moet de lijstindeling gebruiken, anders mislukt de opdracht. Als de alternatieve weergave een tabel is, gebruikt u Format-Table. Als de alternatieve weergave geen lijst of tabel is, gebruikt u Format-Custom.