Format-List
Formátuje výstup jako seznam vlastností, ve kterých se každá vlastnost zobrazuje na novém řádku.
Syntax
Default (Výchozí)
Format-List
[[-Property] <Object[]>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]
Description
Rutina Format-List formátuje výstup příkazu jako seznam vlastností, ve kterých se každá vlastnost zobrazí na samostatném řádku. Pomocí Format-List můžete formátovat a zobrazovat všechny nebo vybrané vlastnosti objektu jako seznam (formát-seznam *).
Vzhledem k tomu, že pro každou položku v seznamu je k dispozici více místa než v tabulce, PowerShell zobrazí více vlastností objektu v seznamu a hodnoty vlastností budou méně pravděpodobné, že budou zkráceny.
Příklady
Příklad 1: Formátování počítačových služeb
Get-Service | Format-List
Tento příkaz formátuje informace o službách v počítači jako seznam. Ve výchozím nastavení jsou služby formátované jako tabulka. Příkaz Get-Service získá objekty představující služby v počítači. Operátor kanálu (|) předává výsledky prostřednictvím kanálu Format-List.
Potom Format-List příkaz naformátuje informace o službě v seznamu a odešle je do výchozí výstupní rutiny pro zobrazení.
Příklad 2: Formátování souborů PS1XML
Tyto příkazy zobrazují informace o souborech PS1XML v adresáři PowerShellu jako seznam.
$A = Get-ChildItem $pshome\*.ps1xml
Format-List -InputObject $A
První příkaz získá objekty představující soubory a uloží je do $A proměnné.
Druhý příkaz používá Format-List k formátování informací o objektech uložených v $A. Tento příkaz pomocí parametru InputObject předá proměnnou Format-List, která pak odešle formátovaný výstup do výchozí výstupní rutiny pro zobrazení.
Příklad 3: Formátování vlastností procesu podle názvu
Tento příkaz zobrazí název, základní prioritu a třídu priority každého procesu v počítači.
Get-Process | Format-List -Property name, basepriority, priorityclass
Pomocí rutiny Get-Process získá objekt představující jednotlivé procesy. Operátor kanálu (|) předává objekty procesu prostřednictvím kanálu do Format-List.
Format-List procesy formátuje jako seznam zadaných vlastností. Název parametru vlastnost je volitelný, takže ho můžete vynechat.
Příklad 4: Formátování všech vlastností procesu
Tento příkaz zobrazí všechny vlastnosti procesu Winlogon.
Get-Process winlogon | Format-List -Property *
Používá rutinu Get-Process k získání objektu představujícího proces Winlogon. Operátor kanálu (|) předá objekt procesu Winlogon prostřednictvím kanálu Format-List. Příkaz pomocí parametru Vlastnost určuje vlastnosti a * k označení všech vlastností.
Protože název parametru Vlastnost je volitelný, můžete ho vynechat a zadat příkaz jako Format-List *.
Format-List výsledky automaticky odešle do výchozí výstupní rutiny pro zobrazení.
Příklad 5: Řešení chyb formátu
Následující příklady ukazují výsledky, když jsou parametry DisplayError nebo ShowError přidány k výrazu.
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
Parametry
-DisplayError
Označuje, že tato rutina zobrazuje chyby na příkazovém řádku. Tento parametr se používá zřídka, ale lze ho použít jako pomůcku při ladění, když formátujete výrazy v příkazu Format-List a zdá se, že výrazy nefungují.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Expand
Určuje formátovaný objekt kolekce a také objekty v kolekci. Tento parametr je navržen pro formátování objektů, které podporují ICollection (System.Collections) rozhraní. Výchozí hodnota je EnumOnly. Přijatelné hodnoty pro tento parametr jsou:
- VýčetOnly. Zobrazí vlastnosti objektů v kolekci.
- Pouze jádro. Zobrazí vlastnosti objektu kolekce.
- Oba. Zobrazí vlastnosti objektu kolekce a vlastnosti objektů v kolekci.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Přípustné hodnoty: | CoreOnly, EnumOnly, Both |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Označuje, že tato rutina zobrazí všechny informace o chybě. Použijte s parametrem DisplayError nebo ShowError. Ve výchozím nastavení se při zápisu objektu chyby do chybového nebo zobrazovacího datového proudu zobrazí pouze některé informace o chybě.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-GroupBy
Určuje výstup ve skupinách na základě sdílené vlastnosti nebo hodnoty. Zadejte výraz nebo vlastnost výstupu.
Hodnota parametru GroupBy může být nová počítaná vlastnost. Pokud chcete vytvořit počítanou vlastnost, použijte tabulku hash. Platné klíče jsou:
- Název (nebo popisek) <řetězcové>
- < bloku skriptu >výrazu< nebo bloku skriptu >
- Formátovací řetězec <>
Vlastnosti parametru
| Typ: | Object |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Určuje objekty, které mají být formátovány. Zadejte proměnnou obsahující objekty nebo zadejte příkaz nebo výraz, který objekty získá.
Vlastnosti parametru
| Typ: | PSObject |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Property
Určuje vlastnosti objektu, které se zobrazí v zobrazení, a pořadí, ve kterém se zobrazí. Jsou povoleny zástupné symboly.
Pokud tento parametr vynecháte, vlastnosti, které se zobrazí na displeji, závisí na zobrazeném objektu. Název parametru "Property" je volitelný. Nelze použít parametry vlastnosti a zobrazení ve stejném příkazu.
Hodnota parametru Vlastnost může být nově vypočítaná vlastnost. K vytvoření počítané vlastnosti použijte tabulku hash. Platné klíče jsou:
- Název (nebo popisek) <řetězcové>
- < bloku skriptu >výrazu< nebo bloku skriptu >
- Formátovací řetězec <>
Vlastnosti parametru
| Typ: | Object[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ShowError
Označuje, že cmdlet odesílá chyby prostřednictvím potrubí. Tento parametr se používá zřídka, ale lze ho použít jako pomůcku při ladění, když formátujete výrazy v příkazu Format-List a zdá se, že výrazy nefungují.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-View
Určuje název alternativního formátu nebo zobrazení seznamu. Nelze použít parametry vlastnosti a zobrazení ve stejném příkazu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
PSObject
Do Format-Listmůžete převést libovolný objekt .
Výstupy
Microsoft.PowerShell.Commands.Internal.Format
Format-List vrátí objekty formátu, které představují seznam.
Poznámky
Můžete také odkazovat na Format-List pomocí integrovaného aliasu FL. Další informace viz about_Aliases.
Rutiny formátu, například Format-List, uspořádávají data, která se mají zobrazit, ale nezobrazují je.
Data se zobrazují výstupními funkcemi PowerShellu a rutinami, které obsahují příkaz Out (rutiny Out), například Out-Host nebo Out-File.
Pokud nepoužíváte rutinu formátu, Použije PowerShell tento výchozí formát pro každý zobrazený objekt.
Parametr GroupBy předpokládá, že objekty jsou seřazené. Před použitím Format-List seskupte objekty pomocí Sort-Object.
Parametr View umožňuje zadat alternativní formát tabulky. Můžete použít zobrazení definovaná v *.format.PS1XML souborech v adresáři PowerShellu nebo můžete vytvořit vlastní zobrazení v nových souborech PS1XML a pomocí rutiny Update-FormatData je zahrnout do PowerShellu.
Alternativní zobrazení parametru View musí používat formát seznamu, jinak příkaz selže. Pokud je alternativním zobrazením tabulka, použijte Format-Table. Pokud alternativní zobrazení není seznam nebo tabulka, použijte Format-Custom.