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。

此命令會將新計算屬性 [ 總運行時間] 的名稱指派給 Label 索引鍵。 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
Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (11/27/2019 12:52:38:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

參數

-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呼叫器時，重複的標頭會很有用。

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

輸入

輸出

相關連結

其他資源