Format-List

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

De Format-List cmdlet formatteert de uitvoer van een opdracht als een lijst met eigenschappen waarin elke eigenschap op een afzonderlijke regel wordt weergegeven. U kunt Format-List gebruiken om alle of geselecteerde eigenschappen van een object op te maken en weer te geven 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 zijn de eigenschapswaarden minder waarschijnlijk afgekapt.

Get-Service | Format-List

Met deze opdracht wordt informatie over services op de computer opgemaakt als een lijst. De services worden 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 aan Format-List. Vervolgens maakt de Format-List opdracht de servicegegevens in een lijst op en verzendt deze naar de standaarduitvoer-cmdlet voor weergave.

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 maakt gebruik van 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. Vervolgens wordt de opgemaakte uitvoer verzonden naar de standaarduitvoer-cmdlet voor weergave.

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 Get-Process wordt gebruikt om een object op te halen dat elk proces vertegenwoordigt. De pijplijnoperator (|) geeft de procesobjecten door aan Format-List. Format-List formatteert de processen als een lijst van de opgegeven eigenschappen. De parameternaam van de -eigenschap is optioneel, dus u kunt deze weglaten.

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

Get-Process winlogon | Format-List -Property *

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

In de volgende voorbeelden ziet u de resultaten van het toevoegen van de DisplayError- of ShowError parameters 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

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt elk object doorsluisen naar deze cmdlet.

Met deze cmdlet worden de indelingsobjecten geretourneerd die de lijst vertegenwoordigen.

PowerShell bevat de volgende aliassen voor Format-List:

• Alle platforms:
  • fl

De format-cmdlets, zoals Format-List, rangschikken de gegevens die moeten worden weergegeven, maar ze worden niet weergegeven. 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 cmdlet voor indeling gebruikt, past PowerShell die standaardindeling toe voor elk object dat wordt weergegeven.

Met de parameter View 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.

Als u Format-List wilt gebruiken met de parameter eigenschap, moet u de parameter Force onder een van de volgende voorwaarden opnemen:

• De invoerobjecten worden out-of-band geformatteerd met de methode ToString(). Dit geldt voor [string]- en .NET-primitieve typen die een superset vormen van de ingebouwde numerieke typen, zoals [int], [long]en andere.

• De invoerobjecten hebben geen openbare eigenschappen.

• De invoerobjecten zijn exemplaren van de wrappertypen die PowerShell gebruikt voor uitvoerstromen anders dan de Succes-uitvoerstroom. Dit geldt alleen wanneer deze wrappertypen naar de Succes-uitvoerstroom worden verzonden, waarvoor u ze eerst moet hebben vastgelegd via algemene parameters, zoals ErrorVariable, of een omleiding zoals *>&1moet gebruiken.

  • De wrapper-typen zijn onder andere:

    • System.Management.Automation.ErrorRecord
    • System.Management.Automation.WarningRecord
    • System.Management.Automation.VerboseRecord
    • System.Management.Automation.DebugRecord (een type debug-logboek voor systeembeheer)
    • System.Management.Automation.InformationRecord