Format-List
Formázja a kimenetet azon tulajdonságok listájaként, amelyekben minden tulajdonság megjelenik egy új sorban.
Syntax
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. Egy objektum összes vagy kijelölt tulajdonságának formázására és megjelenítésére használható Format-List
listaként (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 folyamatüzemeltető (|
) átadja az eredményeket a folyamaton keresztül a következőnek Format-List
: .
Ezután a Format-List
parancs formázja a szolgáltatásadatokat egy listában, és elküldi 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 a benne tárolt $A
objektumokkal kapcsolatos információk formázására szolgálFormat-List
. Ez a parancs az InputObject paramétert használja a változó átadásáhozFormat-List
, 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 parancsmaggal Get-Process
lekér egy objektumot, amely az egyes folyamatokat képviseli. A folyamatkezelő (|
) átadja a folyamat objektumait a folyamatnak Format-List
. Format-List
a folyamatokat a megadott tulajdonságok listájaként formázza. 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 parancsmaggal lekér egy Winlogon-folyamatot képviselő objektumot. A folyamatkezelő (|
) átadja a Winlogon folyamatobjektumot a folyamaton keresztül.Format-List
A parancs a Tulajdonság paraméter használatával adja meg a tulajdonságokat és az *
összes tulajdonságot.
Mivel a tulajdonságparaméter neve nem kötelező, kihagyhatja, és a parancsot a következőképpen Format-List *
írhatja be: . Format-List
automatikusan elküldi az eredményeket az alapértelmezett kimeneti parancsmagnak a megjelenítéshez.
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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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 felületet támogató objektumok formázására szolgál. Az alapértelmezett érték 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.
Típus: | String |
Elfogadott értékek: | CoreOnly, EnumOnly, Both |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Force
Azt jelzi, hogy ez a parancsmag megjeleníti az összes hibainformációt. Használja a DisplayError vagy a ShowError paraméterrel. Alapértelmezés szerint, ha egy hibaobjektumot ír a hiba vagy a streamek jelennek meg, csak néhány hibainformáció jelenik meg.
Bizonyos .NET-típusok formázásához is szükséges. További információkért lásd a Jegyzetek szakaszt.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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 értéke lehet egy új számított tulajdonság. A számított tulajdonság lehet szkriptblokk vagy kivonattábla. Az érvényes kulcs-érték párok a következők:
Name
(vagyLabel
) -<string>
Expression
-<string>
vagy<script block>
FormatString
-<string>
További információ: about_Calculated_Properties.
Típus: | Object |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | PSObject |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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éternév tulajdonsága nem kötelező. A tulajdonság- és nézetparaméterek nem használhatók ugyanabban a parancsban.
A Tulajdonság paraméter értéke lehet egy új számított tulajdonság. A számított tulajdonság lehet szkriptblokk vagy kivonattábla. Az érvényes kulcs-érték párok a következők:
Name
(vagyLabel
) -<string>
Expression
-<string>
vagy<script block>
FormatString
-<string>
További információ: about_Calculated_Properties.
Típus: | Object[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-ShowError
Azt jelzi, hogy a parancsmag hibákat küld a folyamaton 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-View
Egy alternatív listaformátum vagy nézet nevét adja meg. A tulajdonság- és nézetparaméterek nem használhatók ugyanabban a parancsban.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
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 Format-List
tartalmazza:
- Minden platform:
fl
A formátumparancsmagok, például Format-List
az adatok megjelenítését rendezik, de nem jelenítik meg.
Az adatokat a PowerShell kimeneti funkciói és a parancsmagokat tartalmazó Out
parancsmagok ( Out
például Out-Host
a Out-File
parancsmagok) jelenítik meg.
Ha nem használ formátumparancsmagot, a PowerShell ezt az alapértelmezett formátumot alkalmazza minden megjelenített objektumra.
A GroupBy paraméter feltételezi, hogy az objektumok rendezve vannak. Használja Sort-Object
az objektumok csoportosítása előtt Format-List
.
A Nézet paraméter lehetővé teszi a táblázat alternatív formátumának megadását. Használhatja a PowerShell-címtár fájljaiban *.format.PS1XML
definiált nézeteket, vagy létrehozhat saját nézeteket az új PS1XML-fájlokban, és a parancsmaggal felveheti őket a Update-FormatData
PowerShellbe.
A Nézet paraméter alternatív nézetének a listaformátumot kell használnia, ellenkező esetben a parancs sikertelen. Ha a másik nézet táblázat, használja a következőt Format-Table
: . Ha a másik nézet nem lista vagy tábla, használja a következőt Format-Custom
:
Ha a Tulajdonság paraméterrel szeretné használniFormat-List
, a Force paramétert az alábbi feltételek bármelyike mellett kell megadnia:
A bemeneti objektumok sávon kívül vannak formázva a
ToString()
metódus használatával. Ez azokra a[string]
.NET primitív típusokra vonatkozik, amelyek a beépített numerikus típusok, például[int]
a ,[long]
és mások szuperhalmazai.A bemeneti objektumok nem rendelkeznek nyilvános tulajdonságokkal.
A bemeneti objektumok azon burkolótípusok példányai, amelyeket a PowerShell a Success kimeneti adatfolyamtól eltérő kimeneti streamekhez használ. Ez csak akkor érvényes, ha ezeket a burkolótípusokat a sikeres kimeneti streambe küldi a rendszer, amelyhez vagy olyan gyakori paraméterekkel rögzítette őket, mint például az ErrorVariable , vagy egy átirányítást, például
*>&1
.