Format-Table

Odwołanie

Moduł:: Microsoft.PowerShell.Utility

Formatuje dane wyjściowe jako tabelę.

Składnia

Format-Table
      [[-Property] <Object[]>]
      [-AutoSize]
      [-RepeatHeader]
      [-HideTableHeaders]
      [-Wrap]
      [-GroupBy <Object>]
      [-View <string>]
      [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>]
      [<CommonParameters>]

Opis

Polecenie cmdlet Format-Table formatuje dane wyjściowe polecenia jako tabelę z wybranymi właściwościami obiektu w każdej kolumnie. Typ obiektu określa domyślny układ i właściwości wyświetlane w każdej kolumnie. Możesz użyć parametru Property, aby wybrać właściwości, które chcesz wyświetlić.

Program PowerShell używa domyślnych formaterów do definiowania sposobu wyświetlania typów obiektów. Za pomocą plików .ps1xml można tworzyć widoki niestandardowe, które wyświetlają tabelę wyjściową z określonymi właściwościami. Po utworzeniu widoku niestandardowego użyj parametru View, aby wyświetlić tabelę z widokiem niestandardowym. Aby uzyskać więcej informacji na temat widoków, zobacz about_Format.ps1xml.

Możesz użyć tabeli skrótów, aby dodać właściwości obliczeniowe do obiektu przed jego wyświetleniem i określić nagłówki kolumn w tabeli. Aby dodać właściwość obliczeniową, użyj parametru właściwości lub GroupBy. Aby uzyskać więcej informacji na temat tabel skrótów, zobacz about_Hash_Tables.

Przykłady

Przykład 1. Formatowanie hosta programu PowerShell

W tym przykładzie przedstawiono informacje o programie hosta dla programu PowerShell w tabeli.

Get-Host | Format-Table -AutoSize

Polecenie cmdlet Get-Host pobiera obiekty System.Management.Automation.Internal.Host.InternalHost obiektów reprezentujących hosta. Obiekty są wysyłane w dół potoku do Format-Table i wyświetlane w tabeli. Parametr AutoSize dostosowuje szerokość kolumny, aby zminimalizować obcinanie.

Przykład 2. Formatowanie procesów według parametru BasePriority

W tym przykładzie procesy są wyświetlane w grupach, które mają tę samą właściwość BasePriority.

Get-Process | Sort-Object -Property BasePriority | Format-Table -GroupBy BasePriority -Wrap

Polecenie cmdlet Get-Process pobiera obiekty reprezentujące każdy proces na komputerze i wysyła je w dół potoku do Sort-Object. Obiekty są sortowane w kolejności ich właściwości BasePriority.

Posortowane obiekty są wysyłane w dół potoku do Format-Table. Parametr GroupBy rozmieszcza dane procesu w grupy na podstawie ich wartości właściwości BasePriority. Parametr Zawijanie gwarantuje, że dane nie są obcięte.

Przykład 3. Formatowanie procesów według daty rozpoczęcia

W tym przykładzie są wyświetlane informacje o procesach uruchomionych na komputerze. Obiekty są sortowane i Format-Table używają widoku do grupowania obiektów według daty rozpoczęcia.

Get-Process | Sort-Object StartTime | Format-Table -View StartTime

Get-Process pobiera obiekty System.Diagnostics.Process reprezentujące procesy uruchomione na komputerze. Obiekty są wysyłane w dół potoku do Sort-Objecti są sortowane na podstawie właściwości StartTime.

Posortowane obiekty są wysyłane w dół potoku do Format-Table. Parametr View określa widok StartTime zdefiniowany w pliku DotNetTypes.format.ps1xml programu PowerShell dla obiektów System.Diagnostics.Process. Widok StartTime konwertuje czas rozpoczęcia każdego procesu na datę krótką, a następnie grupuje procesy według daty rozpoczęcia.

Plik DotNetTypes.format.ps1xml zawiera widok priorytetu dla procesów. Możesz utworzyć własne pliki format.ps1xml z dostosowanymi widokami.

Przykład 4. Używanie widoku niestandardowego dla danych wyjściowych tabeli

W tym przykładzie widok niestandardowy wyświetla zawartość katalogu. Widok niestandardowy dodaje kolumnę CreationTime do danych wyjściowych tabeli dla obiektów System.IO.DirectoryInfo i System.IO.FileInfo obiektów utworzonych przez Get-ChildItem.

Widok niestandardowy w tym przykładzie został utworzony na podstawie widoku zdefiniowanego w kodzie źródłowym programu PowerShell. Aby uzyskać więcej informacji o widokach i kodzie użytym do utworzenia widoku tego przykładu, zobacz about_Format.ps1xml.

Get-ChildItem  -Path C:\Test | Format-Table -View mygciview

Directory: C:\Test

Mode                LastWriteTime              CreationTime         Length Name
----                -------------              ------------         ------ ----
d-----        11/4/2019     15:54       9/24/2019     15:54                Archives
d-----        8/27/2019     14:22       8/27/2019     14:22                Drawings
d-----       10/23/2019     09:38       2/25/2019     09:38                Files
-a----        11/7/2019     11:07       11/7/2019     11:07          11345 Alias.txt
-a----        2/27/2019     15:15       2/27/2019     15:15            258 alias_out.txt
-a----        2/27/2019     15:16       2/27/2019     15:16            258 alias_out2.txt

Get-ChildItem pobiera zawartość bieżącego katalogu, C:\Test. Obiekty System.IO.DirectoryInfo i System.IO.FileInfo są wysyłane w dół potoku. Format-Table używa parametru View, aby określić widok niestandardowy mygciview, który zawiera kolumnę CreationTime.

Domyślne dane wyjściowe Format-Table dla Get-ChildItem nie obejmują kolumny CreationTime.

Przykład 5. Używanie właściwości dla danych wyjściowych tabeli

W tym przykładzie użyto parametru property, aby wyświetlić wszystkie usługi komputera w dwukolumnach tabeli zawierającej właściwości Name i DependentServices.

Get-Service | Format-Table -Property Name, DependentServices

Get-Service pobiera wszystkie usługi na komputerze i wysyła obiekty System.ServiceProcess.ServiceController potoku. Format-Table używa parametru Property, aby określić, że właściwości Name i DependentServices są wyświetlane w tabeli.

Name i DependentServices są dwiema właściwościami typu obiektu. Aby wyświetlić wszystkie właściwości: Get-Service | Get-Member -MemberType Properties.

Przykład 6. Formatowanie procesu i obliczanie czasu działania

W tym przykładzie zostanie wyświetlona tabela z nazwą procesu i łącznym czasem działania notatnika procesów komputera lokalnego. Łączny czas wykonywania jest obliczany przez odjęcie czasu rozpoczęcia każdego procesu od bieżącego czasu.

Get-Process notepad |
  Format-Table ProcessName, @{Label="TotalRunningTime"; Expression={(Get-Date) - $_.StartTime}}

ProcessName TotalRunningTime
----------- ----------------
notepad     03:20:00.2751767
notepad     00:00:16.7710520

Get-Process pobiera wszystkie notatnika komputera lokalnego procesy i wysyła obiekty w dół potoku. Format-Table wyświetla tabelę z dwiema kolumnami: ProcessName, właściwość Get-Process i TotalRunningTime, właściwość obliczeniową.

Właściwość totalRunningTime jest określana przez tabelę skrótów z dwoma kluczami, Label i Expression. Klucz Label określa nazwę właściwości. Klucz Expression określa obliczenie. Wyrażenie pobiera właściwość StartTime każdego obiektu procesu i odejmuje ją z wyniku polecenia Get-Date, które pobiera bieżącą datę i godzinę.

Przykład 7. Formatowanie procesów Notatnika

W tym przykładzie użyto Get-CimInstance, aby uzyskać czas działania dla wszystkich Notatnik procesów na komputerze lokalnym. Można użyć Get-CimInstance z parametrem ComputerName, aby uzyskać informacje z komputerów zdalnych.

$Processes = Get-CimInstance -Class win32_process -Filter "name='notepad.exe'"
$Processes | Format-Table ProcessName, @{
    Label = "Total Running Time"
    Expression={(Get-Date) - $_.CreationDate}
}

ProcessName Total Running Time
----------- ------------------
notepad.exe 03:39:39.6260693
notepad.exe 00:19:56.1376922

Get-CimInstance pobiera wystąpienia klasy Win32_Process WMI, która opisuje wszystkie procesy komputera lokalnego o nazwie notepad.exe. Obiekty procesu są przechowywane w zmiennej $Processes.

Obiekty procesu w zmiennej $Processes są wysyłane w dół potoku do Format-Table, który wyświetla właściwość ProcessName i nową właściwość obliczeniową, Total Running Time.

Polecenie przypisuje nazwę nowej właściwości obliczeniowej, Total Running Time, do klucza etykieta. Blok skryptu klucza expression oblicza, jak długo proces został uruchomiony, odejmując datę utworzenia procesów od bieżącej daty. Polecenie cmdlet Get-Date pobiera bieżącą datę. Data utworzenia jest odejmowana od bieżącej daty. Wynikiem jest wartość łącznego czasu działania.

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

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

Get-Date | Format-Table DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek  $_ / $null
--------- ------------
Wednesday #ERR

Get-Date | Format-Table DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek  $_ / $null
--------- ------------
Wednesday

InvalidArgument: Failed to evaluate expression " $_ / $null ".

Parametry

-AutoSize

Wskazuje, że polecenie cmdlet dostosowuje rozmiar kolumn i liczbę kolumn na podstawie szerokości danych. Domyślnie rozmiar i liczba kolumn są określane przez widok.

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

-DisplayError

Wskazuje, że polecenie cmdlet wyświetla błędy w wierszu polecenia. Ten parametr może służyć jako pomoc debugowania podczas formatowania wyrażeń w Format-Table polecenia i należy rozwiązać problemy z wyrażeniami.

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

-Expand

Określa format obiektu kolekcji i obiektów 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 są następujące:

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.

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 polecenie cmdlet kieruje polecenie cmdlet, aby wyświetlić wszystkie informacje o błędzie. Użyj parametru DisplayError lub ShowError. Domyślnie, gdy obiekt błędu jest zapisywany w strumieniu błędu lub jest wyświetlany tylko niektóre informacje o błędzie.

Wymagane również podczas formatowania niektórych typów platformy .NET. Aby uzyskać więcej informacji, zobacz sekcję Notes.

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

-GroupBy

Określa posortowane dane wyjściowe w osobnych tabelach na podstawie wartości właściwości. Na przykład można użyć GroupBy do wyświetlania listy usług w osobnych tabelach na podstawie ich stanu.

Wprowadź wyrażenie lub właściwość. Parametr GroupBy oczekuje sortowania obiektów. Przed użyciem Format-Table 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:

Nazwa (lub etykieta) — <string>
Wyrażenie — <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

-HideTableHeaders

Pomija nagłówki kolumn z tabeli.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
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ści obiektu wyświetlane na ekranie i kolejność ich wyświetlania. Wpisz co najmniej jedną nazwę właściwości rozdzieloną przecinkami lub użyj tabeli skrótów, aby wyświetlić właściwość obliczeniową. Dozwolone są symbole wieloznaczne.

Jeśli pominiesz ten parametr, właściwości wyświetlane na ekranie zależą od właściwości pierwszego obiektu. Jeśli na przykład pierwszy obiekt ma PropertyA i PropertyB, ale kolejne obiekty mają PropertyA, PropertyBi PropertyC, zostaną wyświetlone tylko nagłówki PropertyA i PropertyB.

Parametr właściwości jest opcjonalny. Nie można użyć parametrów właściwości i View 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:

Nazwa (lub etykieta) <string>
Wyrażenie — <string> lub <script block>
FormatString — <string>
Szerokość — <int32> — musi być większa niż 0
Wyrównanie — wartość może być Left, Centerlub Right

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

-RepeatHeader

Powtarza wyświetlanie nagłówka tabeli po pełnym ekranie. Powtarzany nagłówek jest przydatny, gdy dane wyjściowe są przesyłane potokiem do stronicowania, takiego jak less lub more lub stronicowanie za pomocą czytnika zawartości ekranu.

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

-ShowError

Ten parametr wysyła błędy za pośrednictwem potoku. Ten parametr może służyć jako pomoc debugowania podczas formatowania wyrażeń w Format-Table polecenia i należy rozwiązać problemy z wyrażeniami.

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

-View

Począwszy od programu PowerShell 6, widoki domyślne są definiowane w programie PowerShell C# kodzie źródłowym. Pliki *.format.ps1xml z programu PowerShell 5.1 i starszych wersji nie istnieją w programie PowerShell 6 i nowszych wersjach.

Parametr View umożliwia określenie alternatywnego formatu lub widoku niestandardowego dla tabeli. Możesz użyć domyślnych widoków programu PowerShell lub utworzyć widoki niestandardowe. Aby uzyskać więcej informacji na temat tworzenia widoku niestandardowego, zobacz about_Format.ps1xml.

Alternatywne i niestandardowe widoki dla parametru View muszą używać formatu tabeli, w przeciwnym razie Format-Table kończy się niepowodzeniem. Jeśli widok alternatywny jest listą, użyj polecenia cmdlet Format-List. Jeśli widok alternatywny nie jest listą lub tabelą, użyj polecenia cmdlet Format-Custom.

Nie można użyć parametrów właściwości 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

-Wrap

Wyświetla tekst, który przekracza szerokość kolumny w następnym wierszu. Domyślnie tekst przekraczający szerokość kolumny jest obcinany.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
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 Format-Table:

Wszystkie platformy:
- ft

Program PowerShell 7.2 wprowadził nowe funkcje do kolorowania danych wyjściowych. Kolory można zarządzać przy użyciu $PSStyle zmiennej automatycznej. Właściwość $PSStyle.Formatting.TableHeader definiuje kolor używany dla nagłówka tabeli wyświetlanej przez Format-Table. Aby uzyskać więcej informacji na temat tego ustawienia, zobacz about_ANSI_Terminals.

Jeśli chcesz użyć Format-Table z parametrem property, należy uwzględnić parametr Force w dowolnym z następujących warunków:

Obiekty wejściowe są zwykle formatowane poza pasmem przy użyciu metody ToString(). Dotyczy to typów pierwotnych [string] i .NET, które są nadzbiorem wbudowanych typów liczbowych, takich jak [int], [long]i inne.
Obiekty wejściowe nie mają właściwości publicznych.
Obiekty wejściowe są wystąpieniami typów otoki używanych przez program PowerShell dla strumieni wyjściowych innych niż strumień wyjściowy Powodzenie. Ma to zastosowanie tylko wtedy, gdy te typy otoki są wysyłane do strumienia wyjściowego Powodzenie, który wymaga przechwycenia ich za pośrednictwem typowych parametrów, takich jak ErrorVariable najpierw lub przy użyciu przekierowania, takiego jak *>&1.
- Otoki obejmują:

Udostępnij za pośrednictwem

Format-Table

Składnia

Opis

Przykłady

Przykład 1. Formatowanie hosta programu PowerShell

Przykład 2. Formatowanie procesów według parametru BasePriority

Przykład 3. Formatowanie procesów według daty rozpoczęcia

Przykład 4. Używanie widoku niestandardowego dla danych wyjściowych tabeli

Przykład 5. Używanie właściwości dla danych wyjściowych tabeli

Przykład 6. Formatowanie procesu i obliczanie czasu działania

Przykład 7. Formatowanie procesów Notatnika

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

Parametry

-AutoSize

-DisplayError

-Expand

-Force

-GroupBy

-HideTableHeaders

-InputObject

-Property

-RepeatHeader

-ShowError

-View

-Wrap

Dane wejściowe

Dane wyjściowe

Uwagi

Dodatkowe zasoby

Udostępnij za pośrednictwem

Format-Table

Składnia

Opis

Przykłady

Przykład 1. Formatowanie hosta programu PowerShell

Przykład 2. Formatowanie procesów według parametru BasePriority

Przykład 3. Formatowanie procesów według daty rozpoczęcia

Przykład 4. Używanie widoku niestandardowego dla danych wyjściowych tabeli

Przykład 5. Używanie właściwości dla danych wyjściowych tabeli

Przykład 6. Formatowanie procesu i obliczanie czasu działania

Przykład 7. Formatowanie procesów Notatnika

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

Parametry

-AutoSize

-DisplayError

-Expand

-Force

-GroupBy

-HideTableHeaders

-InputObject

-Property

-RepeatHeader

-ShowError

-View

-Wrap

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby