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 Format-Wide
cmdlet formatuje obiekty jako szeroką tabelę, która wyświetla tylko jedną właściwość każdego obiektu. Możesz użyć parametru Właściwość , aby określić, która właściwość jest wyświetlana.
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 Get-ChildItem
cmdlet pobiera obiekty reprezentujące każdy plik w katalogu. Operator potoku (|
) przekazuje obiekty plików za pośrednictwem potoku do Format-Wide
elementu , który formatuje je na potrzeby danych wyjściowych. Parametr Kolumna 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 Get-ChildItem
cmdlet pobiera obiekty reprezentujące klucze. Ścieżka jest określona 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 do 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. Nie można użyć parametrów AutoSize i Column w tym samym poleceniu.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Column
Określa liczbę kolumn na ekranie. Nie można użyć parametrów AutoSize i Column w tym samym poleceniu.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Format-Wide
poleceniu, a wyrażenia nie wydają się działać.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Expand
Formatuje obiekt kolekcji, a także obiekty w kolekcji. Ten parametr jest przeznaczony do formatowania obiektów, które obsługują interfejs System.Collections.ICollection . Wartość domyślna to EnumOnly
.
Prawidłowe wartości:
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.
Type: | String |
Accepted values: | CoreOnly, EnumOnly, Both |
Position: | Named |
Default value: | EnumOnly |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Wskazuje, że to polecenie cmdlet zastępuje ograniczenia, które uniemożliwiają pomyślne wykonanie polecenia, tak aby zmiany nie naruszały zabezpieczeń. Na przykład wymuś zastąpienie atrybutu tylko do odczytu lub katalogów tworzenia w celu ukończenia ścieżki pliku, ale nie podejmie próby zmiany uprawnień do pliku.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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ą. 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.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Określa obiekty do formatowania. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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. Nie można użyć parametrów Właściwości i Wyświetl w tym samym poleceniu.
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.
Type: | Object |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ShowError
Wysyła błędy za pośrednictwem potoku. Ten parametr jest rzadko używany, ale może być używany jako pomoc debugowania podczas formatowania wyrażeń w Format-Wide
poleceniu, a wyrażenia nie wydają się działać.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-View
Określa nazwę alternatywnego formatu tabeli lub widoku. Nie można użyć parametrów Właściwości i Wyświetl w tym samym poleceniu.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
Możesz przekazać dowolny obiekt do Format-Wide
obiektu .
Dane wyjściowe
Microsoft.PowerShell.Commands.Internal.Format
Format-Wide
Metoda zwraca obiekty formatu reprezentujące tabelę.
Uwagi
Możesz również odwołać się do Format-Wide
jej wbudowanego aliasu , fw
. Aby uzyskać więcej informacji, zobacz about_Aliases.
Parametr GroupBy zakłada, że obiekty są sortowane. Użyj Sort-Object
polecenia przed użyciem Format-Custom
, aby pogrupować obiekty.
Parametr Widok umożliwia określenie alternatywnego formatu tabeli. Można 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ć Update-FormatData
polecenia cmdlet , aby uwzględnić je w programie PowerShell.
Widok alternatywny dla parametru Widok musi używać formatu tabeli; jeśli tak nie jest, polecenie zakończy się niepowodzeniem. Jeśli alternatywny widok jest listą, użyj polecenia Format-List
. Jeśli widok alternatywny nie jest listą ani tabelą, użyj polecenia Format-Custom
.