Sdílet prostřednictvím

Format-Wide

  • Reference
Modul:
Microsoft.PowerShell.Utility

Formátuje objekty jako širokou tabulku, která zobrazuje pouze jednu vlastnost každého objektu.

Syntaxe

Format-Wide
      [[-Property] <Object>]
      [-AutoSize]
      [-Column <int>]
      [-GroupBy <Object>]
      [-View <string>]
       [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>] 
      [<CommonParameters>]

Description

Rutina Format-Wide formátuje objekty jako širokou tabulku, která zobrazuje pouze jednu vlastnost každého objektu. Pomocí parametru Property můžete určit, která vlastnost se zobrazí.

Příklady

Příklad 1: Formátování názvů souborů v aktuálním adresáři

Tento příkaz zobrazí názvy souborů v aktuálním adresáři ve třech sloupcích na obrazovce.

Get-ChildItem | Format-Wide -Column 3

Rutina Get-ChildItem získá objekty představující každý soubor v adresáři. Operátor kanálu (|) předá objekty souboru prostřednictvím kanálu Format-Wide, který je formátuje pro výstup. Parametr Column určuje počet sloupců.

Příklad 2: Formátování názvů klíčů registru

Tento příkaz zobrazí názvy klíčů registru v klíči HKEY_CURRENT_USER\Software\Microsoft.

Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize

Cmdlet Get-ChildItem získá objekty představující klíče. Cesta je specifikována jako HKCU:, což je jedna z jednotek zpřístupněná poskytovatelem registru PowerShell, následovaná cestou ke klíči. Operátor kanálu (|) předává objekty klíče registru prostřednictvím kanálu do Format-Wide, který je formátuje pro výstup. Parametr Vlastnost určuje název vlastnosti a parametr AutoSize upraví sloupce pro čitelnost.

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

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

PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError


#ERR

PS /> Get-Date | Format-Wide { $_ / $null } -ShowError


Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 8:18:01 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

Parametry

-AutoSize

Upraví velikost sloupce a počet sloupců na základě šířky dat. Ve výchozím nastavení je velikost a číslo sloupce určeny zobrazením. Nelze použít parametry Automatické nastavení velikosti a Sloupec ve stejném příkazu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Column

Určuje počet sloupců v zobrazení. Ve stejném příkazu nelze použít parametry Automatická velikost a Sloupec.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisplayError

Zobrazí chyby na příkazovém řádku. Tento parametr se používá zřídka, ale lze ho použít jako nástroj pro ladění při formátování výrazů v příkazu Format-Wide, když se zdá, že výrazy nefungují.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Expand

Formátuje objekt kolekce i objekty v kolekci. Tento parametr je navržen pro formátování objektů, které podporují rozhraní System.Collections.ICollection. Výchozí hodnota je EnumOnly.

Platné hodnoty jsou:

  • EnumOnly: Zobrazí vlastnosti objektů v kolekci.
  • CoreOnly: Zobrazí vlastnosti objektu kolekce.
  • Both: Zobrazí vlastnosti objektu kolekce a vlastnosti objektů v kolekci.
Typ:String
Přípustné hodnoty:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Označuje, že tato rutina přepíše omezení, která brání úspěšnému provedení příkazu, takže změny neohrožují zabezpečení. Například Vynutit přepíše atribut jen pro čtení nebo vytvoří adresáře pro dokončení cesty k souboru, ale nebude se pokoušet změnit oprávnění k souboru.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GroupBy

Formátuje výstup ve skupinách na základě sdílené vlastnosti nebo hodnoty. Zadejte výraz nebo vlastnost výstupu. Parametr GroupBy očekává, že se objekty seřadí. Před použitím Format-Wide použijte rutinu Sort-Object k seskupení objektů.

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 naleznete v tématu about_Calculated_Properties.

Typ:Object
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje objekty, které se mají formátovat. Zadejte proměnnou, která obsahuje objekty, nebo zadejte příkaz nebo výraz, který objekty získá.

Typ:PSObject
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Property

Určuje vlastnost objektu, která se zobrazí v zobrazení. Jsou povoleny zástupné cardy.

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

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

  • Expression - <string> nebo <script block>
  • FormatString - <string>

Další informace naleznete v tématu about_Calculated_Properties.

Typ:Object
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-ShowError

Odesílá chyby prostřednictvím pipeline. Tento parametr se používá málokdy, ale lze ho použít jako pomůcku ladění při formátování výrazů v příkazu Format-Wide, a pokud se zdá, že výrazy nefungují.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-View

Určuje název alternativního formátu tabulky nebo zobrazení. Nelze použít parametry vlastnost a pohled ve stejném příkazu.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSObject

Tento cmdlet můžete předat libovolnému objektu.

Výstupy

Microsoft.PowerShell.Commands.Internal.Format

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

Poznámky

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

  • fw

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í pro parametr View musí používat formát tabulky; pokud ne, příkaz selže. Pokud je alternativní zobrazení seznamem, použijte Format-List. Pokud alternativní zobrazení není seznam ani tabulka, použijte Format-Custom.