Format-List
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
De Format-List
cmdlet maakt de uitvoer van een opdracht op als een lijst met eigenschappen waarin elke eigenschap op een afzonderlijke regel wordt weergegeven. U kunt gebruiken Format-List
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, geeft PowerShell meer eigenschappen van het object in de lijst weer en zijn de eigenschapswaarden minder waarschijnlijk 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 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 wordt met de Format-List
opdracht de servicegegevens in een lijst opgemaakt en verzonden naar de standaarduitvoer-cmdlet voor weergave.
Voorbeeld 2: PS1XML-bestanden opmaken
Met deze opdrachten wordt informatie over de PS1XML-bestanden in de PowerShell-map weergegeven 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 ze opgeslagen in de $A
variabele.
De tweede opdracht gebruikt Format-List
om informatie op te maken over objecten die zijn opgeslagen in $A
. Met deze opdracht wordt de parameter InputObject gebruikt om de variabele door te geven aan Format-List
, waarmee de opgemaakte uitvoer vervolgens wordt verzonden naar de standaarduitvoer-cmdlet voor weergave.
Voorbeeld 3: Proceseigenschappen op naam opmaken
Met deze opdracht worden de naam, basisprioriteit en prioriteitsklasse van elk proces op de computer weergegeven.
Get-Process | Format-List -Property Name, BasePriority, PriorityClass
De cmdlet wordt gebruikt Get-Process
om een object op te halen dat elk proces vertegenwoordigt. De pijplijnoperator (|
) geeft de procesobjecten via de pijplijn door aan Format-List
. Format-List
hiermee worden de processen opgemaakt als een lijst met de opgegeven eigenschappen. De naam van de parameter 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 *
De cmdlet Get-Process wordt gebruikt om een object op te halen dat het Winlogon-proces vertegenwoordigt. De pijplijnoperator (|
) geeft het Winlogon-procesobject via 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 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 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 op de opdrachtregel weergeeft. Deze parameter wordt zelden gebruikt, maar kan worden gebruikt als een hulpmiddel voor foutopsporing wanneer u expressies in een Format-List
opdracht opmaakt en de expressies lijken niet te werken.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Expand
Hiermee geeft u het opgemaakte verzamelingsobject, evenals de objecten in de verzameling. Deze parameter is ontworpen voor het opmaken van objecten die ondersteuning bieden voor de interface System.Collections.ICollection . De standaardwaarde is EnumOnly
. De aanvaardbare waarden voor deze parameter zijn:
EnumOnly
. Hiermee worden de eigenschappen van de objecten in de verzameling weergegeven.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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Geeft aan dat deze cmdlet alle foutinformatie weergeeft. Gebruik met de parameter DisplayError of ShowError . Wanneer een foutobject naar de fout- of weergavestreams wordt geschreven, wordt standaard slechts bepaalde foutinformatie weergegeven.
Ook vereist bij het opmaken van bepaalde .NET-typen. Zie de sectie Notities voor meer informatie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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
(ofLabel
) -<string>
Expression
-<string>
Of<script block>
FormatString
-<string>
Zie about_Calculated_Properties voor meer informatie.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Hiermee geeft u de objecten op 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 |
Required: | False |
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 deze 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 parameters Eigenschap en Weergave niet in dezelfde opdracht gebruiken.
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
(ofLabel
) -<string>
Expression
-<string>
Of<script block>
FormatString
-<string>
Zie about_Calculated_Properties voor meer informatie.
Type: | Object[] |
Position: | 0 |
Default value: | None |
Required: | False |
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 een hulpmiddel voor foutopsporing wanneer u expressies in een Format-List
opdracht opmaakt en de expressies lijken niet te werken.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-View
Hiermee geeft u de naam van een alternatieve lijstindeling of weergave. U kunt de parameters Eigenschap en Weergave niet in dezelfde opdracht gebruiken.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
U kunt elk object doorspezen naar deze cmdlet.
Uitvoerwaarden
Microsoft.PowerShell.Commands.Internal.Format
Deze cmdlet retourneert de opmaakobjecten die de lijst vertegenwoordigen.
Notities
PowerShell bevat de volgende aliassen voor Format-List
:
- Alle platformen:
fl
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 bevatten (de Out
cmdlets), zoals Out-Host
of Out-File
.
Als u geen indelings-cmdlet gebruikt, past PowerShell die standaardindeling toe op elk object dat wordt weergegeven.
Bij de parameter GroupBy wordt ervan uitgegaan dat de objecten zijn gesorteerd. Gebruik Sort-Object
voor gebruik Format-List
om de objecten te 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 deze 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 Format-Table
u . Als de alternatieve weergave geen lijst of tabel is, gebruikt Format-Custom
u .
Als u wilt gebruiken Format-List
met de parameter Eigenschap , moet u de parameter Force opnemen onder een van de volgende voorwaarden:
De invoerobjecten worden out-of-band opgemaakt met behulp van de
ToString()
methode . Dit is van toepassing op[string]
primitieve typen en .NET 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 andere uitvoerstromen dan de uitvoerstroom Geslaagd. Dit is alleen van toepassing wanneer deze wrappertypen worden verzonden naar de uitvoerstroom Geslaagd. Hiervoor moet u ze eerst vastleggen via algemene parameters zoals ErrorVariable of een omleiding zoals
*>&1
gebruiken.