Format-Wide
Formatuje obiekty jako szeroką tabelę, która wyświetla tylko jedną właściwość każdego obiektu.
Składnia
Default (domyślnie)
Format-Wide
[[-Property] <Object>]
[-AutoSize]
[-Column <int>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]
Opis
Polecenie cmdlet Format-Wide formatuje obiekty jako szeroką tabelę, która wyświetla tylko jedną właściwość każdego obiektu. Aby określić, która właściwość ma być wyświetlana, można użyć parametru właściwości .
Przykłady
Przykład 1: Formatowanie nazw plików w bieżącym katalogu
To polecenie wyświetla nazwy plików w bieżącym katalogu w trzech kolumnach na ekranie.
Get-ChildItem | Format-Wide -Column 3
Polecenie cmdlet Get-ChildItem pobiera obiekty reprezentujące każdy plik w katalogu. Operator potoku (|) przekazuje obiekty plików za pośrednictwem potoku do Format-Wide, który formatuje je dla danych wyjściowych. Parametr Column określa liczbę kolumn.
Przykład 2. Formatowanie nazw kluczy rejestru
To polecenie wyświetla nazwy kluczy rejestru w kluczu HKEY_CURRENT_USER\Software\Microsoft.
Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize
Polecenie cmdlet Get-ChildItem pobiera obiekty reprezentujące klucze. Ścieżka jest określana jako HKCU:, jeden z dysków uwidocznionych przez dostawcę rejestru programu PowerShell, a następnie ścieżkę klucza. Operator potoku (|) przekazuje obiekty kluczy rejestru za pośrednictwem potoku do Format-Wide, który formatuje je dla danych wyjściowych. Parametr Property określa nazwę właściwości, a parametr AutoSize dostosowuje kolumny pod kątem czytelności.
Przykład 3. Rozwiązywanie problemów z błędami formatu
W poniższych przykładach pokazano wyniki dodawania parametrów DisplayError lub ShowError z wyrażeniem.
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
Dostosowuje rozmiar kolumn i liczbę kolumn na podstawie szerokości danych. Domyślnie rozmiar i liczba kolumn są określane przez widok. W tym samym poleceniu nie można użyć parametrów AutoSize i Column.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Column
Określa liczbę kolumn na ekranie. W tym samym poleceniu nie można użyć parametrów AutoSize i Column.
Właściwości parametru
| Typ: | Int32 |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-DisplayError
Wyświetla błędy w wierszu polecenia. Ten parametr jest rzadko używany, ale może być używany jako pomoc w debugowaniu podczas formatowania wyrażeń w poleceniu Format-Wide, jeżeli wyrażenia nie wydają się działać.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Expand
Formatuje obiekt kolekcji, a także obiekty w kolekcji. Ten parametr jest przeznaczony do formatowania obiektów obsługujących interfejs ICollection (System.Collections). Wartość domyślna to EnumOnly.
Prawidłowe wartości to:
- EnumOnly: wyświetla właściwości obiektów w kolekcji.
- CoreOnly: wyświetla właściwości obiektu kolekcji.
- Oba: wyświetla właściwości obiektu kolekcji i właściwości obiektów w kolekcji.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | EnumOnly |
| Dopuszczalne wartości: | CoreOnly, EnumOnly, Both |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Force
Wskazuje, że to polecenie cmdlet zastępuje ograniczenia, które uniemożliwiają pomyślne wykonanie polecenia, dzięki czemu zmiany nie powodują naruszenia zabezpieczeń. Na przykład Force zastąpi atrybut tylko do odczytu lub stworzy katalogi, aby uzupełnić ścieżkę pliku, ale nie podejmie próby zmiany uprawnień do pliku.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-GroupBy
Formatuje dane wyjściowe w grupach na podstawie właściwości udostępnionej lub wartości. Wprowadź wyrażenie lub właściwość danych wyjściowych.
Wartość parametru GroupBy może być nową właściwością obliczeniową. Aby utworzyć tabelę obliczeniową, użyj tabeli skrótów. Dopuszczalne wartości tego parametru to:
- Ciąg <nazwa (lub etykieta)>
- Blok<> lub blok skryptu <>wyrażeń
- < ciągów >FormatString
Właściwości parametru
| Typ: | Object |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InputObject
Określa obiekty do formatowania. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.
Właściwości parametru
| Typ: | PSObject |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Property
Określa właściwości obiektu wyświetlane na ekranie i kolejność ich wyświetlania. Symbole wieloznaczne są dozwolone.
Jeśli pominiesz ten parametr, właściwości wyświetlane na ekranie zależą od wyświetlanego obiektu. Nazwa parametru "Property" jest opcjonalna. Nie można użyć parametru właściwości i parametru widoku w tym samym poleceniu.
Wartość parametru Property może być nową właściwością obliczeniową. Aby utworzyć właściwość obliczeniową, użyj tabeli skrótów. Prawidłowe klucze to:
- Blok<> lub blok skryptu <>wyrażeń
- < ciągów >FormatString
Właściwości parametru
| Typ: | Object |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ShowError
Wysyła błędy przez szlak przetwarzania. Ten parametr jest rzadko używany, ale może być używany jako pomoc w debugowaniu podczas formatowania wyrażeń w poleceniu Format-Wide, jeżeli wyrażenia nie wydają się działać.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-View
Określa nazwę alternatywnego formatu tabeli lub widoku. Nie można użyć parametru właściwości i parametru widoku w tym samym poleceniu.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
PSObject
Możesz przekazać dowolny obiekt do Format-Wide.
Dane wyjściowe
Microsoft.PowerShell.Commands.Internal.Format
Format-Wide zwraca obiekty formatu reprezentujące tabelę.
Uwagi
Możesz również odwołać się do Format-Wide za pomocą wbudowanego aliasu fw. Aby uzyskać więcej informacji, zobacz about_Aliases.
Parametr GroupBy zakłada, że obiekty są sortowane. Użyj Sort-Object przed użyciem Format-Custom do grupowania obiektów.
Parametr View umożliwia określenie alternatywnego formatu tabeli. Możesz użyć widoków zdefiniowanych w plikach *.format.PS1XML w katalogu programu PowerShell lub utworzyć własne widoki w nowych plikach PS1XML i użyć polecenia cmdlet Update-FormatData, aby uwzględnić je w programie PowerShell.
Alternatywny widok View parametru musi używać formatu tabeli; jeśli tak nie jest, polecenie zakończy się niepowodzeniem. Jeśli widok alternatywny jest listą, użyj Format-List. Jeśli widok alternatywny nie jest listą ani tabelą, użyj polecenia Format-Custom.