Format-Wide
Formátuje objekty jako širokou tabulku, která zobrazuje pouze jednu vlastnost každého objektu.
Syntax
Default (Výchozí)
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 reprezentující klíče. Cesta je zadána jako HKCU:, což je jeden z disků zpřístupněný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, když jsou parametry DisplayError nebo ShowError přidány k výrazu.
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.
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 |
-Column
Určuje počet sloupců v zobrazení. Nelze použít parametry Automatické nastavení velikosti a Sloupec ve stejném příkazu.
Vlastnosti parametru
| Typ: | Int32 |
| 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 |
-DisplayError
Zobrazí 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-Wide 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
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.
Vlastnosti parametru
| Typ: | String |
| Default value: | EnumOnly |
| 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 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.
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
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. Počítaná vlastnost může být blok skriptu nebo tabulka hash. Platné páry klíč-hodnota jsou:
-
Name(neboLabel) –<string> -
Expression-<string>nebo<script block> FormatString-<string>
Další informace naleznete v dokumentaci about_Calculated_Properties.
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é se mají formátovat. Zadejte proměnnou, která obsahuje 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 vlastnost objektu, která se zobrazí v zobrazení. 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 Vlastnost je nepovinný. Nelze použít parametry vlastnosti a zobrazení ve stejném příkazu.
Hodnota parametru Vlastnost 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 dokumentaci about_Calculated_Properties.
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
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-Wide 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 tabulky nebo zobrazení. 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
K tomuto cmdletu můžete přesměrovat libovolný objekt.
Výstupy
Microsoft.PowerShell.Commands.Internal.Format
Tato rutina vrátí objekty formátu, které představují tabulku.
Poznámky
PowerShell obsahuje následující aliasy pro Format-Wide:
- Všechny platformy:
fw
Parametr GroupBy předpokládá, že objekty jsou seřazené. Před použitím Sort-Object seskupte objekty pomocí Format-Custom.
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.