Format-Table

參考

模組:: Microsoft.PowerShell.Utility

將輸出格式化為表格。

Syntax

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

Description

Cmdlet 會將 Format-Table 命令的輸出格式化為數據表，其中包含每個數據行中對象的選取屬性。物件類型會決定每個數據行中顯示的預設配置和屬性。您可以使用 Property 參數來選取您想要顯示的屬性。

PowerShell 會使用預設格式器來定義物件類型的顯示方式。您可以使用 .ps1xml 檔案來建立自定義檢視，以顯示具有指定屬性的輸出數據表。建立自定義檢視之後，請使用 View 參數，以自定義檢視顯示數據表。如需檢視的詳細資訊，請參閱 about_Format.ps1xml。

您可以使用哈希表將匯出屬性新增至物件，再顯示該物件，並在數據表中指定數據行標題。若要新增導出屬性，請使用 Property 或 GroupBy 參數。如需雜湊表的相關詳細資訊，請參閱 about_Hash_Tables。

範例

範例 1：格式化 PowerShell 主機

本範例會顯示數據表中 PowerShell 主機程式的相關信息。

Get-Host | Format-Table -AutoSize

Cmdlet Get-Host 會取得 代表主機的 System.Management.Automation.Internal.Host.InternalHost 物件。物件會向下傳送至管線 Format-Table ，並顯示在數據表中。 AutoSize 參數會調整數據行寬度，以最小化截斷。

範例 2：依BasePriority 格式化進程

在此範例中，進程會顯示在具有相同 BasePriority屬性的 群組中。

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

Cmdlet Get-Process 會取得對象，這些物件代表電腦上的每個進程，並將管線向下傳送至 Sort-Object。物件會依 BasePriority 屬性的順序排序。

排序的物件會向下傳送至 Format-Table管線。 GroupBy 參數會根據其BasePriority屬性的值，將進程數據排列成群組。 Wrap 參數可確保不會截斷數據。

範例 3：依開始日期格式化進程

此範例會顯示計算機上執行之進程的相關信息。物件會排序，並使用 Format-Table 檢視依其開始日期將物件分組。

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

Get-Process 會取得 System.Diagnostics.Process 物件，代表計算機上執行的進程。物件會向下傳送至管線， Sort-Object並根據 StartTime 屬性排序。

排序的物件會向下傳送至 Format-Table管線。 View 參數會指定 System.Diagnostics.Process 物件之 PowerShell DotNetTypes.format.ps1xml 檔案中定義的 StartTime 檢視。 StartTime 檢視會將每個進程的開始時間轉換成簡短的日期，然後依開始日期將進程分組。

檔案 DotNetTypes.format.ps1xml 包含進程的 優先順序 檢視。您可以使用自定義檢視建立自己的 format.ps1xml 檔案。

範例 4：針對數據表輸出使用自定義檢視

在此範例中，自定義檢視會顯示目錄的內容。自定義檢視會將 CreationTime 數據行加入 System.IO.DirectoryInfo 和 System.IO.FileInfo 物件所建立的 Get-ChildItem數據表輸出中。

此範例中的自定義檢視是從 PowerShell 原始碼中定義的檢視建立的。如需檢視和用來建立此範例檢視的程式代碼詳細資訊，請參閱 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取得目前目錄的內容。 C:\Test System.IO.DirectoryInfo 和 System.IO.FileInfo 物件會在管線下傳送。 Format-Table會使用 View 參數來指定包含 CreationTime 數據行的自定義檢視 mygciview。

的預設 Format-Table 輸出 Get-ChildItem 不包含 CreationTime 資料行。

範例 5：使用資料表輸出的屬性

這個範例會使用 Property 參數，在兩欄數據表中顯示所有計算機服務，其中顯示 屬性 Name 和 DependentServices。

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

Get-Service 會取得計算機上的所有服務，並將 System.ServiceProcess.ServiceController 物件傳送至管線。 Format-Table 會使用 Property 參數來指定 Name 和 DependentServices 屬性會顯示在數據表中。

Name 和 DependentServices 是物件類型的兩個屬性。若要檢視所有屬性： Get-Service | Get-Member -MemberType Properties。

範例 6：格式化進程並計算其運行時間

本範例會顯示數據表，其中包含本機計算機 記事本 進程的進程名稱和總運行時間。總執行時間是從目前時間減去每個處理程序開始時間計算得來的。

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 會取得所有本機計算機的 記事本 進程，並將對象傳送至管線。 Format-Table 會顯示具有兩個數據行的數據表： ProcessName、 Get-Process 屬性和 TotalRunningTime，這是導出屬性。

TotalRunningTime 屬性是由具有兩個索引鍵、Label 和 Expression 的哈希表所指定。 Label 索引鍵會指定屬性名稱。 Expression 索引鍵會指定計算。表達式會取得每個進程物件的 StartTime 屬性，並從命令的結果 Get-Date 減去它，以取得目前的日期和時間。

範例 7：格式化記事本程式

此範例會使用 Get-CimInstance 來取得本機計算機上所有 記事本 進程的運行時間。您可以使用 Get-CimInstanceComputerName 參數，從遠端電腦取得資訊。

$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 會取得 WMI Win32_Process 類別的實例，這個類別會描述所有名為 notepad.exe的本機計算機進程。進程物件會儲存在變數中 $Processes 。

變數中的 $Processes 進程物件會向下傳送至 Format-Table，其會顯示 ProcessName 屬性和新的計算屬性 Total Running Time。

此命令會將新匯出屬性的名稱[ 總運行時間] 指派給 [卷標 ] 索引鍵。 Expression 索引鍵的腳本區塊會計算進程執行的時間長度，方法是從目前日期減去進程建立日期。 Cmdlet Get-Date 會取得目前的日期。建立日期會從目前日期減去。結果是 總運行時間的值。

範例 8：針對格式錯誤進行疑難解答

下列範例顯示使用表示式新增 DisplayError 或 ShowError 參數的結果。

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

參數

-AutoSize

表示 Cmdlet 會根據數據的寬度調整數據行大小和數據行數。根據預設，欄大小和欄數是由檢視決定。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayError

表示 Cmdlet 會在命令行上顯示錯誤。當您在命令中 Format-Table 設定表達式的格式，且需要針對表達式進行疑難解答時，可以使用此參數作為偵錯輔助功能。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Expand

指定集合物件和集合中的物件格式。此參數的設計目的是格式化支援 ICollection (System.Collections) 介面的物件。預設值為 EnumOnly。此參數可接受的值如下所示：

EnumOnly：顯示集合中對象的屬性。
CoreOnly：顯示集合對象的屬性。
兩者：顯示集合對象的屬性和集合中對象的屬性。

Type:	String
Accepted values:	CoreOnly, EnumOnly, Both
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

表示 Cmdlet 會指示 Cmdlet 顯示所有錯誤資訊。搭配 DisplayError 或 ShowError 參數使用。根據預設，將錯誤物件寫入錯誤或顯示串流時，只會顯示某些錯誤資訊。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GroupBy

根據屬性值，在個別數據表中指定已排序的輸出。例如，您可以使用 GroupBy 根據其狀態，將服務列在個別數據表中。

輸入表達式或屬性。 GroupBy 參數預期物件已排序。使用之前， Sort-Object 請先使用 Format-Table Cmdlet 來分組物件。

GroupBy 參數的值可以是新的導出屬性。匯出屬性可以是腳本區塊或哈希表。有效的機碼/值組為：

名稱 (或標籤) - <string>
表達式 - <string> 或 <script block>
FormatString - <string>

如需詳細資訊，請參閱 about_Calculated_Properties。

Type:	Object
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HideTableHeaders

省略表格中的欄標題。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定要格式化的物件。輸入包含物件的變數，或輸入可取得物件的命令或運算式。

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Property

指定顯示中出現的物件屬性及其出現順序。輸入一或多個屬性名稱、以逗號分隔，或使用哈希表來顯示匯出屬性。允許使用萬用字元。

如果您省略此參數，顯示中顯示的屬性取決於第一個對象的屬性。例如，如果第一個物件具有 PropertyA 和 PropertyB，但後續的物件有 PropertyA、PropertyB 和 PropertyC，則只會顯示 PropertyA 和 PropertyB 標頭。

Property 參數是選擇性的。您無法在相同的命令中使用 Property 和 View 參數。

Property 參數的值可以是新的導出屬性。匯出屬性可以是腳本區塊或哈希表。有效的機碼/值組為：

名稱 (或標籤) <string>
表達式 - <string> 或 <script block>
FormatString - <string>
寬度 - <int32> 必須大於 0
對齊 - 值可以是 Left、 Center或 Right

如需詳細資訊，請參閱 about_Calculated_Properties。

Type:	Object[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-RepeatHeader

在每一個螢幕滿後重複顯示數據表的標頭。當輸出透過管線傳送至螢幕助讀程式或more分頁器等less呼叫器時，重複的標頭會很有用。

此參數已在PowerShell 6.2中新增。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ShowError

此參數會透過管線傳送錯誤。當您在命令中 Format-Table 設定表達式的格式，且需要針對表達式進行疑難解答時，可以使用此參數作為偵錯輔助功能。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-View

從 PowerShell 6 開始，預設檢視會在 PowerShell C# 原始碼中定義。 *.format.ps1xml PowerShell 5.1 和舊版的檔案不存在於 PowerShell 6 和更新版本中。

View 參數可讓您指定資料表的替代格式或自定義檢視。您可以使用預設 PowerShell 檢視或建立自訂檢視。如需如何建立自定義檢視的詳細資訊，請參閱 about_Format.ps1xml。

View 參數的替代和自定義檢視必須使用數據表格式，否則Format-Table會失敗。如果替代檢視是清單，請使用 Format-List Cmdlet。如果替代檢視不是清單或數據表，請使用 Format-Custom Cmdlet。

您無法在相同的命令中使用 Property 和 View 參數。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Wrap

將超過欄寬度的文字顯示於下一行。根據預設，系統會截斷超過欄寬度的文字。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

PSObject

您可以將管線下的任何物件傳送至 Format-Table。

輸出

Microsoft.PowerShell.Commands.Internal.Format

Format-Table 會傳回代表數據表的格式物件。

共用方式為

Format-Table

Syntax

Description

範例

範例 1：格式化 PowerShell 主機

範例 2：依BasePriority 格式化進程

範例 3：依開始日期格式化進程

範例 4：針對數據表輸出使用自定義檢視

範例 5：使用資料表輸出的屬性

範例 6：格式化進程並計算其運行時間

範例 7：格式化記事本程式

範例 8：針對格式錯誤進行疑難解答

參數

-AutoSize

-DisplayError

-Expand

-Force

-GroupBy

-HideTableHeaders

-InputObject

-Property

-RepeatHeader

-ShowError

-View

-Wrap

輸入

輸出

其他資源

共用方式為

Format-Table

Syntax

Description

範例

範例 1：格式化 PowerShell 主機

範例 2：依BasePriority 格式化進程

範例 3：依開始日期格式化進程

範例 4：針對數據表輸出使用自定義檢視

範例 5：使用資料表輸出的屬性

範例 6：格式化進程並計算其運行時間

範例 7：格式化記事本程式

範例 8：針對格式錯誤進行疑難解答

參數

-AutoSize

-DisplayError

-Expand

-Force

-GroupBy

-HideTableHeaders

-InputObject

-Property

-RepeatHeader

-ShowError

-View

-Wrap

輸入

輸出

相關連結

其他資源