Format-Wide
Formatuje obiekty jako szeroką tabelę, która wyświetla tylko jedną właściwość każdego obiektu.
Składnia
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ść jest 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 przez potok 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:
, co jest jednym z dysków uwidocznionych przez dostawcę rejestru programu PowerShell, a następnie podawana jest ścieżka klucza. Operator potoku (|
) przekazuje obiekty klucza rejestru przez potok 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.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Column
Określa liczbę kolumn na ekranie. W tym samym poleceniu nie można użyć parametrów AutoSize i Column.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DisplayError
Wyświetla błędy w wierszu polecenia. Ten parametr jest rzadko używany, ale może być używany jako pomoc debugowania podczas formatowania wyrażeń w poleceniu Format-Wide
, jeśli wyrażenia wydają się nie działać.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Expand
Formatuje obiekt kolekcji, a także obiekty w kolekcji. Ten parametr jest przeznaczony do formatowania obiektów obsługujących interfejs System.Collections.ICollection. 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. -
Both
: wyświetla właściwości obiektu kolekcji i właściwości obiektów w kolekcji.
Typ: | String |
Dopuszczalne wartości: | CoreOnly, EnumOnly, Both |
Position: | Named |
Domyślna wartość: | EnumOnly |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 utworzy katalogi, aby ukończyć ścieżkę pliku, ale nie podejmie próby zmiany uprawnień plików.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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. Parametr GroupBy oczekuje sortowania obiektów. Przed użyciem Format-Wide
użyj polecenia cmdlet Sort-Object
, aby zgrupować obiekty.
Wartość parametru GroupBy może być nową właściwością obliczeniową. Właściwość obliczeniowa może być blokiem skryptu lub tabelą skrótów. Prawidłowe pary klucz-wartość to:
-
Name
(lubLabel
) —<string>
-
Expression
-<string>
lub<script block>
FormatString
-<string>
Aby uzyskać więcej informacji, zobacz about_Calculated_Properties.
Typ: | Object |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-InputObject
Określa obiekty do formatowania. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.
Typ: | PSObject |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Property
Określa właściwość obiektu wyświetlaną na ekranie. Dozwolone są symbole wieloznaczne.
Jeśli pominiesz ten parametr, właściwości wyświetlane na ekranie zależą od wyświetlanego obiektu. Nazwa parametru właściwość jest opcjonalna. W tym samym poleceniu nie można użyć parametrów "Property" i "View".
Wartość parametru Property może być nową właściwością obliczeniową. Właściwość obliczeniowa może być blokiem skryptu lub tabelą skrótów. Prawidłowe pary klucz-wartość to:
-
Expression
-<string>
lub<script block>
FormatString
-<string>
Aby uzyskać więcej informacji, zobacz about_Calculated_Properties.
Typ: | Object |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | True |
-ShowError
Wysyła błędy przez kanał. Parametr ten jest rzadko używany, ale może być używany jako pomoc w debugowaniu podczas formatowania wyrażeń w poleceniu Format-Wide
, a wyrażenia wydają się nie działać.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-View
Określa nazwę alternatywnego formatu tabeli lub widoku. Nie można używać parametrów: Property i View w tym samym poleceniu.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Do tego polecenia cmdlet można przekierować dowolny obiekt.
Dane wyjściowe
Microsoft.PowerShell.Commands.Internal.Format
To polecenie cmdlet zwraca obiekty formatu reprezentujące tabelę.
Uwagi
Program Windows PowerShell zawiera następujące aliasy dla Format-Wide
:
fw
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 Format-Custom
.