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 Format-Table cmdlet 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 Właściwość , 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ą .ps1xml plików 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 Widok , 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 Property 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 Get-Host cmdlet pobiera obiekty System.Management.Automation.Internal.Host.InternalHost , które reprezentują 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 Get-Process cmdlet pobiera obiekty reprezentujące każdy proces na komputerze i wysyła je w dół potoku do Sort-Objectprogramu . Obiekty są sortowane w kolejności właściwości BasePriority .

Posortowane obiekty są wysyłane w dół potoku do elementu Format-Table. Parametr GroupBy rozmieszcza dane procesu w grupy na podstawie wartości właściwości BasePriority. Parametr Zawijanie zapewnia, ż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-Processpobiera obiekty System.Diagnostics.Process reprezentujące procesy uruchomione na komputerze. Obiekty są wysyłane w dół potoku do Sort-Objectelementu i są sortowane na podstawie właściwości StartTime .

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

Plik DotNetTypes.format.ps1xml zawiera widok Priorytet dla procesów. Możesz utworzyć własne format.ps1xml pliki 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 utworzonych przez Get-ChildItemprogram .

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 Widok , aby określić widok niestandardowy mygciview , który zawiera kolumnę CreationTime .

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

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

W tym przykładzie użyto parametru Właściwość , aby wyświetlić wszystkie usługi komputera w tabeli dwukolumna 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 w dół potoku. Format-Table używa parametru Property , aby określić, że właściwości Name i DependentServices są wyświetlane w tabeli.

Właściwości 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 procesów notatnika 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-Processpobiera wszystkie procesy notatnika komputera lokalnego i wysyła obiekty w dół potoku. Format-Table wyświetla tabelę z dwiema kolumnami: ProcessName, właściwością Get-Process i TotalRunningTime, właściwością obliczeniową.

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

Przykład 7. Formatowanie procesów Notatnika

W tym przykładzie użyto Get-CimInstance metody , aby uzyskać czas wykonywania dla wszystkich procesów Notatnika na komputerze lokalnym. Za pomocą Get-CimInstance parametru ComputerName można 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-CimInstancePobiera wystąpienia klasy Win32_Process WMI opisujące 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 wyrażenia oblicza, jak długo proces został uruchomiony, odejmując datę utworzenia procesów od bieżącej daty. Polecenie Get-Date cmdlet pobiera bieżącą datę. Data utworzenia jest odejmowana od bieżącej daty. Wynik jest wartością łącznego czasu działania.

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

W poniższych przykładach pokazano 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
Failed to evaluate expression " $_ / $null ".
    + CategoryInfo          : InvalidArgument: (11/27/2019 12:53:41:PSObject) [], RuntimeException
    + FullyQualifiedErrorId : mshExpressionError

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 poleceniu i konieczności rozwiązywania problemów 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 z parametrem 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ę Uwagi .

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. Można na przykład użyć grupy Według 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. Użyj polecenia cmdlet przed użyciem Sort-Object Format-Table polecenia , 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 właściwośćA i właściwośćB, ale kolejne obiekty mają właściwościA, PropertyB i PropertyC, zostaną wyświetlone tylko nagłówki PropertyA i PropertyB.

Parametr Property jest opcjonalny. 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:

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 mieć Leftwartość , 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 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 poleceniu i konieczności rozwiązywania problemów z wyrażeniami.

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

-View

W programie PowerShell 5.1 i starszych wersjach domyślne widoki są definiowane w *.format.ps1xml plikach przechowywanych w $PSHOMEprogramie .

Parametr Widok 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 parametru Widok muszą używać formatu tabeli, w przeciwnym razie Format-Table kończy się niepowodzeniem. Jeśli alternatywny widok jest listą, użyj Format-List polecenia cmdlet . Jeśli widok alternatywny nie jest listą lub tabelą, użyj Format-Custom polecenia cmdlet .

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

-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 Windows PowerShell zawiera następujące aliasy dla programu Format-Table:

ft

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

Obiekty wejściowe są zwykle formatowane poza pasmem ToString() przy użyciu metody . Dotyczy [string] to typów pierwotnych platformy .NET, które są nadzbiorem wbudowanych typów liczbowych, takich jak [int], [long]i innych.
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 first 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