Format-List
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. Az Format-List használatával listaként formázhatja és megjelenítheti egy objektum összes vagy kijelölt tulajdonságát (formátumlista *).
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 operátora (|) á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 folyamatkezelő (|) átadja a folyamatobjektumokat a folyamaton keresztül a Format-List.
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 folyamatkezelő (|) átadja a Winlogon folyamatobjektumot a folyamaton keresztül a Format-List. 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 az ICollection (System.Collections) felületet támogató objektumok formázására szolgál. Az alapértelmezett érték az EnumOnly. A paraméter elfogadható értékei a következők:
- Csak enumOnly. Megjeleníti a gyűjtemény objektumainak tulajdonságait.
- CoreOnly. Megjeleníti a gyűjteményobjektum tulajdonságait.
- Mindkettő. 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 írunk a hiba- vagy kijelzőfolyamokba, csak néhány hibainformáció jelenik meg.
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 értéke új számított tulajdonság lehet. Számított tulajdonság létrehozásához használjon kivonattáblát. Az érvényes kulcsok a következők:
- Név (vagy címke) <sztring>
- Kifejezés <sztring> vagy <szkriptblokkoló>
- FormatString <sztring>
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 "Tulajdonság" paraméternév megadása 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. Számított tulajdonság létrehozásához használjon kivonattáblát. Az érvényes kulcsok a következők:
- Név (vagy címke) <sztring>
- Kifejezés <sztring> vagy <szkriptblokkoló>
- FormatString <sztring>
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
Bármilyen objektumot becsúszthat Format-List.
Kimenetek
Microsoft.PowerShell.Commands.Internal.Format
Format-List a listát képviselő formátumobjektumokat adja vissza.
Jegyzetek
A Format-List is hivatkozhat a beépített fl aliasára. További információ: about_Aliases.
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 a Out (Out) parancsmagokat tartalmazó parancsmagok jelenítik meg, 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 GroupBy paraméter feltételezi, hogy az objektumok rendezve vannak. Az objektumok csoportosításához használja Sort-Object a Format-List használata előtt.
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.