Megosztás a következőn keresztül:

Format-List

Modul:
Microsoft.PowerShell.Utility Module

Formázja a kimenetet azon tulajdonságok listájaként, amelyekben minden tulajdonság megjelenik egy új sorban.

Syntax

Default (Alapértelmezett) 

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

Description

A Format-List parancsmag a parancs kimenetét azon tulajdonságok listájaként formázja, amelyekben az egyes tulajdonságok külön sorban jelennek meg. A Format-List használatával listaként formázhatja és megjelenítheti az objektumok összes vagy kijelölt tulajdonságát (Format-List -Property *).

Mivel a lista minden eleméhez több hely áll rendelkezésre, mint egy táblában, a PowerShell az objektum több tulajdonságát jeleníti meg a listában, és a tulajdonságértékek kisebb valószínűséggel lesznek csonkva.

Példák

1. példa: Számítógép-szolgáltatások formázása

Get-Service | Format-List

Ez a parancs listaként formázja a számítógépen található szolgáltatások adatait. Alapértelmezés szerint a szolgáltatások táblázatként vannak formázva. A Get-Service parancsmag a számítógépen található szolgáltatásokat képviselő objektumokat kapja meg. A folyamatkezelő (|) átadja az eredményeket a folyamaton keresztül a Format-List. Ezután a Format-List parancs formázja a szolgáltatásadatokat egy listában, és elküldi azokat az alapértelmezett kimeneti parancsmagnak megjelenítésre.

2. példa: PS1XML-fájlok formázása

Ezek a parancsok listaként jelenítik meg a Ps1XML-fájlok adatait a PowerShell-címtárban.

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

Az első parancs lekéri a fájlokat képviselő objektumokat, és a $A változóban tárolja őket.

A második parancs Format-List használatával formázza a $Atárolt objektumokkal kapcsolatos információkat. Ez a parancs a InputObject paramétert használja a változó Format-Listvaló átadásához, amely ezután elküldi a formázott kimenetet az alapértelmezett kimeneti parancsmagnak a megjelenítéshez.

3. példa: Folyamattulajdonságok formázása név szerint

Ez a parancs megjeleníti a számítógépen található egyes folyamatok nevét, alap prioritását és prioritási osztályát.

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

A Get-Process parancsmagot használja az egyes folyamatokat képviselő objektumok lekéréséhez. A csővezeték-üzemeltető (|) a folyamatobjektumokat a csővezetéken keresztül továbbítja Format-List-hez. Format-List formázza a folyamatokat a megadott tulajdonságok listájaként. A tulajdonság paraméter neve nem kötelező, ezért kihagyhatja.

4. példa: Folyamat összes tulajdonságának formázása

Ez a parancs megjeleníti a Winlogon-folyamat összes tulajdonságát.

Get-Process winlogon | Format-List -Property *

A Get-Process parancsmagot használja a Winlogon-folyamatot képviselő objektum lekéréséhez. A csővezeték operátor (|) a csővezetéken keresztül átadja a Winlogon folyamatobjektumot a Format-List-nek. A parancs a Tulajdonság paraméter használatával adja meg a tulajdonságokat, a * pedig az összes tulajdonságot. Mivel a tulajdonság paraméter neve nem kötelező, kihagyhatja, és beírhatja a parancsot Format-List *. Format-List automatikusan elküldi az eredményeket az alapértelmezett kimeneti parancsmagnak megjelenítésre.

5. példa: Formátumhibák elhárítása

Az alábbi példák a DisplayError vagy ShowError paraméterek kifejezéssel való hozzáadásának eredményeit mutatják be.

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

Paraméterek

-DisplayError

Azt jelzi, hogy ez a parancsmag hibákat jelenít meg a parancssorban. Ezt a paramétert ritkán használják, de hibakeresési segédként is használható, ha kifejezéseket formáz egy Format-List parancsban, és úgy tűnik, hogy a kifejezések nem működnek.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Expand

Megadja a formázott gyűjteményobjektumot, valamint a gyűjteményben lévő objektumokat. Ez a paraméter a System.Collections.ICollection interfészt támogató objektumok formázására szolgál. Az alapértelmezett érték a EnumOnly. A paraméter elfogadható értékei a következők:

  • EnumOnly. Megjeleníti a gyűjtemény objektumainak tulajdonságait.
  • CoreOnly. Megjeleníti a gyűjteményobjektum tulajdonságait.
  • Both. Megjeleníti a gyűjteményobjektum tulajdonságait és a gyűjteményben lévő objektumok tulajdonságait.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:CoreOnly, EnumOnly, Both
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Force

Azt jelzi, hogy ez a parancsmag megjeleníti az összes hibainformációt. Használja a DisplayError vagy ShowError paraméterrel. Alapértelmezés szerint, amikor egy hibaobjektumot írnak a hiba- vagy megjelenítési folyamokba, csak bizonyos hibainformációk jelennek meg.

Bizonyos .NET-típusok formázásához is szükséges. További információkért lásd a Megjegyzések szakaszt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-GroupBy

A megosztott tulajdonságon vagy értéken alapuló csoportok kimenetét adja meg. Adja meg a kimenet kifejezését vagy tulajdonságát. A GroupBy paraméter az objektumok rendezésére számít. Használja a Sort-Object parancsmagot, mielőtt Format-List használva csoportosítja az objektumokat.

A GroupBy paraméter értéke új számított tulajdonság lehet. A számított tulajdonság lehet szkriptblokk vagy kivonattábla. Az érvényes kulcs-érték párok a következők:

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

További információkért lásd a about_Calculated_Propertiesrészt.

Paramétertulajdonságok

Típus:Object
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-InputObject

Megadja a formázandó objektumokat. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat.

Paramétertulajdonságok

Típus:PSObject
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Property

Megadja a megjelenítésben megjelenő objektumtulajdonságokat és azok megjelenési sorrendjét. Helyettesítő karakterek használata engedélyezett.

Ha kihagyja ezt a paramétert, a megjelenítésben megjelenő tulajdonságok a megjelenített objektumtól függenek. A paraméter neve tulajdonság nem kötelező. Nem használhatja ugyanabban a parancsban a tulajdonság és a View paramétereket.

A tulajdonság paraméter értéke új számított tulajdonság lehet. A számított tulajdonság lehet szkriptblokk vagy kivonattábla. Az érvényes kulcs-érték párok a következők:

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

További információkért lásd a about_Calculated_Propertiesrészt.

Paramétertulajdonságok

Típus:

Object[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:True
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ShowError

Azt jelzi, hogy a parancsmag hibákat küld a csővezetéken keresztül. Ezt a paramétert ritkán használják, de hibakeresési segédként is használható, ha kifejezéseket formáz egy Format-List parancsban, és úgy tűnik, hogy a kifejezések nem működnek.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-View

Egy alternatív listaformátum vagy nézet nevét adja meg. Nem használhatja ugyanabban a parancsban a tulajdonság és a View paramétereket.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

PSObject

A parancsmaghoz bármilyen objektumot csövezhet.

Kimenetek

Microsoft.PowerShell.Commands.Internal.Format

Ez a parancsmag a listát képviselő formátumobjektumokat adja vissza.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Format-List:

  • Minden platform:
    • fl

A formátumparancsmagok (mint például a Format-List) előkészítik az adatokat a megjelenítésre, de nem jelenítik meg azokat. Az adatokat a PowerShell kimeneti funkciói és azok a parancsmagok jelenítik meg, amelyek tartalmazzák a Out igét (azaz a Out parancsmagok), például Out-Host vagy Out-File.

Ha nem használ formátumparancsmagot, a PowerShell ezt az alapértelmezett formátumot alkalmazza minden megjelenített objektumra.

A View paraméter lehetővé teszi a táblázat alternatív formátumának megadását. Használhatja a PowerShell-címtár *.format.ps1xml fájljaiban definiált nézeteket, vagy létrehozhat saját nézeteket új PS1XML-fájlokban, és a Update-FormatData parancsmaggal felveheti őket a PowerShellbe.

A Nézet paraméter alternatív nézetének a listaformátumot kell használnia, ellenkező esetben a parancs sikertelen. Ha az alternatív nézet egy táblázat, használja a Format-Table. Ha a másik nézet nem lista vagy tábla, használja a Format-Custom.

Ha a Format-List-t a tulajdonság paraméterrel szeretné használni, a Force paramétert az alábbi feltételek valamelyike mellett kell szerepeltetnie: