Share via

Format-List

  • Reference
Modul:
Microsoft.PowerShell.Utility

Formátuje výstup jako seznam vlastností, ve kterých se každá vlastnost zobrazuje na novém řádku.

Syntax

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 zobrazuje na samostatném řádku. Můžete použít Format-List k formátování a zobrazení všech nebo vybraných vlastností objektu jako seznamu (Format-List -Property *).

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. Rutina 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 do Format-List. Format-List Příkaz pak 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 použije parametr InputObject k předání proměnné 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 formátuje procesy jako seznam zadaných vlastností. Název parametru Property 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ává objekt procesu Winlogon prostřednictvím kanálu do Format-List. Příkaz používá parametr Property k určení vlastností a * k označení všech vlastností. Protože název parametru Property je volitelný, můžete jej vynechat a zadat příkaz jako Format-List *. Format-List automaticky odešle výsledky do výchozí výstupní rutiny pro zobrazení.

Příklad 5: Řešení chyb formátu

Následující příklady ukazují výsledky přidání parametrů DisplayError nebo ShowError s výrazem.

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 jej použít jako pomůcku ladění při formátování výrazů v Format-List příkazu a výrazy se zdá, že nefungují.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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í System.Collections.ICollection rozhraní. Výchozí hodnota je EnumOnly. Tento parametr přijímá tyto hodnoty:

  • EnumOnly. Zobrazí vlastnosti objektů v kolekci.
  • CoreOnly. Zobrazí vlastnosti objektu kolekce.
  • Both. Zobrazí vlastnosti objektu kolekce a vlastnosti objektů v kolekci.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Označuje, že tato rutina zobrazí všechny informace o chybě. Používá se s parametrem DisplayError nebo ShowError . Ve výchozím nastavení se při zápisu objektu chyby do chyby nebo zobrazení datových proudů zobrazí pouze některé informace o chybě.

Vyžaduje se také při formátování určitých typů .NET. Další informace najdete v části Poznámky .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Počítaná vlastnost může být blok skriptu nebo tabulka hash. Platné páry klíč-hodnota jsou:

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

Další informace najdete v tématu about_Calculated_Properties.

Type:Object
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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á.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Property

Určuje vlastnosti objektu, které se zobrazí v zobrazení, a pořadí, ve kterém se zobrazí. Jsou povoleny zástupné cardy.

Pokud tento parametr vynecháte, vlastnosti, které se zobrazí na displeji, závisí na zobrazeném objektu. Vlastnost názvu parametru je volitelná. Ve stejném příkazu nelze použít parametry vlastnosti a zobrazení .

Hodnota parametru Property může být nová počítaná vlastnost. Počítaná vlastnost může být blok skriptu nebo tabulka hash. Platné páry klíč-hodnota jsou:

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

Další informace najdete v tématu about_Calculated_Properties.

Type:Object[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ShowError

Označuje, že rutina odesílá chyby prostřednictvím kanálu. Tento parametr se používá zřídka, ale lze jej použít jako pomůcku ladění při formátování výrazů v Format-List příkazu a výrazy se zdá, že nefungují.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-View

Určuje název alternativního formátu nebo zobrazení seznamu. Ve stejném příkazu nelze použít parametry vlastnosti a zobrazení .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

PSObject

Do této rutiny můžete převést libovolný objekt.

Výstupy

Microsoft.PowerShell.Commands.Internal.Format

Tato rutina vrátí objekty formátu, které představují seznam.

Poznámky

PowerShell obsahuje následující aliasy pro Format-List:

  • Všechny platformy:
    • fl

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í Out příkaz ( Out rutiny), 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řazeny. Před Sort-Object použitím Format-List seskupte objekty.

Parametr View umožňuje zadat alternativní formát tabulky. Můžete použít zobrazení definovaná v souborech v *.format.PS1XML adresáři PowerShellu nebo můžete vytvořit vlastní zobrazení v nových souborech PS1XML a pomocí rutiny je zahrnout do PowerShellu Update-FormatData .

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.

Pokud chcete použít Format-List s parametrem Property, musíte parametr Force zahrnout za některé z následujících podmínek: