Format-List
Hiermee wordt de uitvoer opgemaakt als een lijst met eigenschappen waarin elke eigenschap op een nieuwe regel wordt weergegeven.
Syntaxis
Format-List
[[-Property] <Object[]>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError][-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]Description
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 (opmaaklijst *).
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.
Voorbeelden
Voorbeeld 1: Computerservices opmaken
Get-Service | Format-ListMet 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 via de pijplijn 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.
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 $AMet 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.
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, priorityclassDe 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 de processen opmaken als een lijst met de opgegeven eigenschappen. De naam van de eigenschap parameter 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 *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 en de * op te geven 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.
Voorbeeld 5: Opmaakfouten oplossen
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 : PSPropertyExpressionErrorParameters
-DisplayError
Geeft aan dat met deze cmdlet fouten worden weergegeven op de opdrachtregel. Deze parameter wordt zelden gebruikt, maar kan worden gebruikt als foutopsporingshulpmiddel wanneer u expressies in een Format-List opdracht opmaakt en de expressies niet werken.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 ICollection (System.Collections). De standaardwaarde is EnumOnly. De acceptabele waarden voor deze parameter zijn:
- EnumOnly. Geeft de eigenschappen van de objecten in de verzameling weer.
- CoreOnly. Geeft de eigenschappen van het verzamelingsobject weer.
- Beide. Geeft de eigenschappen van het verzamelingsobject en de eigenschappen van objecten in de verzameling weer.
| Type: | String |
| Geaccepteerde waarden: | CoreOnly, EnumOnly, Both |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 foutgegevens weergegeven.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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. Als u een berekende eigenschap wilt maken, gebruikt u een hash-tabel. Geldige sleutels zijn:
- Naam (of label) <tekenreeks>
- Expressie <tekenreeks> of <scriptblok>
- FormatString <tekenreeks>
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | 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 parameternaam 'Eigenschap' is optioneel. U kunt de eigenschap en parameters weergeven in dezelfde opdracht niet gebruiken.
De waarde van de parameter eigenschap kan een nieuwe berekende eigenschap zijn. Als u een berekende eigenschap wilt maken, gebruikt u een hash-tabel. Geldige sleutels zijn:
- Naam (of label) <tekenreeks>
- Expressie <tekenreeks> of <scriptblok>
- FormatString <tekenreeks>
| Type: | Object[] |
| Position: | 0 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | True |
-ShowError
Geeft aan dat de cmdlet fouten verzendt via de pijplijn. Deze parameter wordt zelden gebruikt, maar kan worden gebruikt als foutopsporingshulpmiddel wanneer u expressies in een Format-List opdracht opmaakt en de expressies niet werken.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-View
Hiermee geeft u de naam van een alternatieve lijstindeling of weergave. U kunt de eigenschap en parameters weergeven in dezelfde opdracht niet gebruiken.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Invoerwaarden
U kunt elk object doorslangen 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 door de ingebouwde alias FL. Zie about_Aliasesvoor meer informatie.
De indelings-cmdlets, zoals Format-List, rangschikken de gegevens die moeten worden weergegeven, maar niet.
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.
Bij de parameter GroupBy wordt ervan uitgegaan dat de objecten zijn gesorteerd. Gebruik Sort-Object voordat u Format-List gebruikt om de objecten te groeperen.
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.