Udostępnij za pośrednictwem

Format-List

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

Formatuje dane wyjściowe jako listę właściwości, w których każda właściwość jest wyświetlana w nowym wierszu.

Składnia

Format-List
      [[-Property] <Object[]>]
      [-GroupBy <Object>]
      [-View <string>]
      [-ShowError][-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>]
      [<CommonParameters>]

Opis

Polecenie cmdlet Format-List formatuje dane wyjściowe polecenia jako listę właściwości, w których każda właściwość jest wyświetlana w osobnym wierszu. Można użyć Format-List do formatowania i wyświetlania wszystkich lub wybranych właściwości obiektu jako listy (format-lista *).

Ponieważ dla każdego elementu na liście jest dostępnych więcej miejsca niż w tabeli, program PowerShell wyświetla więcej właściwości obiektu na liście, a wartości właściwości są mniej prawdopodobne, aby zostać obcięte.

Przykłady

Przykład 1. Formatowanie usług komputerowych

Get-Service | Format-List

To polecenie formatuje informacje o usługach na komputerze jako liście. Domyślnie usługi są formatowane jako tabela. Polecenie cmdlet Get-Service pobiera obiekty reprezentujące usługi na komputerze. Operator potoku (|) przekazuje wyniki przez potok do Format-List. Następnie polecenie Format-List formatuje informacje o usłudze na liście i wysyła je do domyślnego polecenia cmdlet wyjściowego do wyświetlenia.

Przykład 2. Formatowanie plików PS1XML

Te polecenia wyświetlają informacje o plikach PS1XML w katalogu programu PowerShell jako listę.

$A = Get-ChildItem $pshome\*.ps1xml
Format-List -InputObject $A

Pierwsze polecenie pobiera obiekty reprezentujące pliki i przechowuje je w zmiennej $A.

Drugie polecenie używa Format-List do formatowania informacji o obiektach przechowywanych w $A. To polecenie używa parametru InputObject, aby przekazać zmienną do Format-List, która następnie wysyła sformatowane dane wyjściowe do domyślnego polecenia cmdlet wyjściowego do wyświetlenia.

Przykład 3. Formatowanie właściwości procesu według nazwy

To polecenie wyświetla nazwę, priorytet podstawowy i klasę priorytetu każdego procesu na komputerze.

Get-Process | Format-List -Property name, basepriority, priorityclass

Używa on polecenia cmdlet Get-Process, aby uzyskać obiekt reprezentujący każdy proces. Operator potoku (|) przekazuje obiekty procesu przez potok do Format-List. Format-List formatuje procesy jako listę określonych właściwości. Właściwość nazwa parametru jest opcjonalna, więc można ją pominąć.

Przykład 4. Formatowanie wszystkich właściwości procesu

To polecenie wyświetla wszystkie właściwości procesu Winlogon.

Get-Process winlogon | Format-List -Property *

Używa on polecenia cmdlet Get-Process do pobrania obiektu reprezentującego proces Winlogon. Operator potoku (|) przekazuje obiekt procesu Winlogon za pośrednictwem potoku do Format-List. Polecenie używa parametru Property, aby określić właściwości i * w celu wskazania wszystkich właściwości. Ponieważ nazwa parametru Property jest opcjonalna, można pominąć go i wpisać polecenie jako Format-List *. Format-List automatycznie wysyła wyniki do domyślnego polecenia cmdlet danych wyjściowych do wyświetlenia.

Przykład 5. Rozwiązywanie problemów z błędami formatu

W poniższych przykładach pokazano wyniki dodawania parametrów DisplayError lub ShowError z wyrażeniem.

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek    : Friday
 $_ / $null  : #ERR

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek    : Friday
 $_ / $null  :

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 7:59:23 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

Parametry

-DisplayError

Wskazuje, że to polecenie cmdlet 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-List polecenia, 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

Określa sformatowany 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. Dopuszczalne wartości tego parametru to:

  • Wyliczenie. Wyświetla właściwości obiektów w kolekcji.
  • CoreOnly. Wyświetla właściwości obiektu kolekcji.
  • Obie. 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ść:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wskazuje, że to polecenie cmdlet wyświetla wszystkie informacje o błędzie. Użyj parametru DisplayError lub ShowError. Domyślnie, gdy obiekt błędu jest zapisywany w strumieniach błędów lub wyświetlanych strumieni, wyświetlane są tylko niektóre informacje o błędzie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-GroupBy

Określa 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. Prawidłowe klucze to:

  • Ciąg <nazwa (lub etykieta)>
  • Blok>> lub blok skryptu <<wyrażeń
  • > ciągów <FormatString
Typ:Object
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Określa obiekty, które mają być sformatowane. 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ści obiektu wyświetlane na ekranie i kolejność ich wyświetlania. Dozwolone są symbole wieloznaczne.

Jeśli pominiesz ten parametr, właściwości wyświetlane na ekranie zależą od wyświetlanego obiektu. Nazwa parametru "Property" jest opcjonalna. W tym samym poleceniu nie można użyć parametrów właściwości i View.

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:

  • Ciąg <nazwa (lub etykieta)>
  • Blok>> lub blok skryptu <<wyrażeń
  • > ciągów <FormatString
Typ:Object[]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-ShowError

Wskazuje, że polecenie cmdlet 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-List polecenia, 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 listy lub widoku. W tym samym poleceniu nie można użyć parametrów właściwości i View.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSObject

Możesz przekazać dowolny obiekt do Format-List.

Dane wyjściowe

Microsoft.PowerShell.Commands.Internal.Format

Format-List zwraca obiekty formatu reprezentujące listę.

Uwagi

Możesz również odwołać się do Format-List za pomocą wbudowanego aliasu FL. Aby uzyskać więcej informacji, zobacz about_Aliases.

Polecenia cmdlet formatu, takie jak Format-List, rozmieścić dane, które mają być wyświetlane, ale nie są wyświetlane. Dane są wyświetlane przez funkcje wyjściowe programu PowerShell oraz polecenia cmdlet zawierające czasownik out (polecenia cmdlet Out), takie jak Out-Host lub Out-File.

Jeśli nie używasz polecenia cmdlet formatu, program PowerShell stosuje ten domyślny format dla każdego wyświetlanego obiektu.

Parametr GroupBy zakłada, że obiekty są sortowane. Użyj Sort-Object przed użyciem Format-List 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 dla parametru View musi używać formatu listy. W przeciwnym razie polecenie kończy się niepowodzeniem. Jeśli alternatywny widok jest tabelą, użyj Format-Table. Jeśli widok alternatywny nie jest listą lub tabelą, użyj Format-Custom.