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

Rutina Get-ChildItem získá objekty představující klíče. Cesta se zadává jako HKCU:, jedna z jednotek vystavených poskytovatelem registru PowerShellu, 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. Ve stejném příkazu nelze použít parametry Automatické nastavení velikosti a sloupec.

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é nastavení velikosti 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 pomůcku ladění při formátování výrazů v příkazu Format-Wide a výrazy se zdá, že 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í ICollection (System.Collections) rozhraní. Výchozí hodnota je EnumOnly.

Platné hodnoty jsou:

  • EnumOnly: Zobrazí vlastnosti objektů v kolekci.
  • CoreOnly: Zobrazí vlastnosti objektu kolekce.
  • Obojí: 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.

Hodnota parametru GroupBy může být nová počítaná vlastnost. Pokud chcete vytvořit počítanou vlastnost, použijte tabulku hash. Přijatelné hodnoty pro tento parametr jsou:

  • Název (nebo popisek) <řetězcové>
  • > bloku skriptu <výrazu> nebo bloku skriptu <
  • Formátovací řetězec <>
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 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. Název parametru "Property" je volitelný. Ve stejném příkazu nelze použít parametry vlastnosti a Zobrazit.

Hodnota parametru Vlastnost může být nová počítaná vlastnost. K vytvoření počítané vlastnosti použijte tabulku hash. Platné klíče jsou:

  • > bloku skriptu <výrazu> nebo bloku skriptu <
  • Formátovací řetězec <>
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 kanálu. Tento parametr se používá zřídka, ale lze ho použít jako pomůcku ladění při formátování výrazů v příkazu Format-Wide a výrazy se zdá, že 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í. Ve stejném příkazu nelze použít parametry vlastnosti a Zobrazit.

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

Do Format-Widemůžete převést libovolný objekt .

Výstupy

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide vrátí objekty formátu, které představují tabulku.

Poznámky

Můžete také odkazovat na Format-Wide jeho předdefinovaný alias fw. Další informace naleznete v tématu about_Aliases.

Parametr GroupBy předpokládá, že objekty jsou seřazené. Před použitím Format-Custom 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í 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 příkaz Format-Custom.