Udostępnij za pośrednictwem

Format-Wide

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

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 Property, 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-Wideelementu , który formatuje je dla 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 klucza 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. Nie można użyć parametrów AutoSize i Column w tym samym poleceniu.

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. Nie można użyć parametrów AutoSize i Column w tym samym poleceniu.

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 Format-Wide poleceniu, a wyrażenia nie wydają się 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 . Domyślna wartość 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 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.

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.

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 (lub Label) - <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. Właściwość nazwy parametru 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.

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 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ć.

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żyć parametrów Właściwości i Wyświetl 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

PSObject

Do tego polecenia cmdlet można przekazać dowolny obiekt.

Dane wyjściowe

Microsoft.PowerShell.Commands.Internal.Format

To polecenie cmdlet zwraca obiekty formatu reprezentujące tabelę.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Format-Wide:

  • Wszystkie platformy:
    • fw

Parametr GroupBy zakłada, że obiekty są sortowane. Użyj Sort-Object polecenia przed użyciem Format-Custom , aby zgrupować obiekty.

Parametr Widok umożliwia określenie alternatywnego formatu tabeli. Możesz użyć widoków zdefiniowanych *.format.PS1XML w plikach 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.

Alternatywny widok 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.