Format-List
將輸出格式化成屬性的清單，其中每個屬性都會在新的一行中出現。
語法
Format-List [[-屬性] <Object[]>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]
描述
Format-List Cmdlet 將命令的輸出格式化為屬性的清單，其中每個屬性都顯示在個別的一行中。您可以使用 Format-List 將物件的所有或所選屬性格式化並顯示為清單 (format-list *)。
因為每個項目在清單中，比在表格中有更多的空間可用，所以 Windows PowerShell 可在清單中顯示更多的物件屬性，而且屬性值也比較不可能被截斷。
參數
-DisplayError
在命令列顯示錯誤。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Expand <string>
將集合物件連同集合中的物件一併格式化。此參數係設計為對支援 ICollection (System.Collections) 介面的物件進行格式化。預設值為 EnumOnly。
有效的值包括：
-- EnumOnly：顯示集合中各物件的屬性。
-- CoreOnly：顯示集合物件的屬性。
-- Both：顯示集合物件的屬性，以及集合中各物件的屬性。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Force
指示 Cmdlet 顯示所有的錯誤資訊。請與 DisplayError 或 ShowError 參數搭配使用。根據預設，當錯誤物件寫入錯誤或顯示的資料流時，只會顯示一部分的錯誤資訊。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-GroupBy <Object>
依據共用屬性或值，將輸出格式化為群組。請輸入運算式或指定輸出的屬性。
GroupBy 參數的值可以是新的計算屬性。若要建立計算屬性，請使用雜湊表。有效的索引鍵包括：
-- Name (或 Label) <字串>
-- Expression <字串> 或 <指令碼區塊>
-- FormatString <字串>
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-InputObject <psobject>
指定要格式化的物件。請輸入包含物件的變數，或輸入可取得物件的命令或運算式。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
true (ByValue) |
接受萬用字元? |
false |
-Property <Object[]>
指定呈現在畫面上的物件屬性及其呈現的順序。允許使用萬用字元。
如果省略此參數，呈現在畫面上的屬性將依所顯示的物件而定。參數名稱 ("Property") 為選擇項。同一個命令不能同時使用 Property 和 View 參數。
Property 參數的值可以是新的計算屬性。若要建立計算屬性，請使用雜湊表。有效的索引鍵包括：
-- Name (或 Label) <字串>
-- Expression <字串> 或 <指令碼區塊>
-- FormatString <字串>
必要? |
false |
位置? |
1 |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-ShowError
透過管線傳送錯誤。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-View <string>
指定替代清單格式或「檢視」的名稱。同一個命令不能同時使用 Property 和 View 參數。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
輸入 |
System.Management.Automation.PSObject 您可經由管道將任何物件輸出至 Format-List。 |
輸出 |
Microsoft.PowerShell.Commands.Internal.Format Format-List 會傳回代表清單的格式物件。 |
附註
您也可以利用內建的別名 "FL" 來參照 Format-List。如需詳細資訊，請參閱 about_Aliases。
格式 Cmdlet (如 Format-List) 會排列要顯示的資料，但是不會顯示資料。資料是透過 Windows PowerShell 的輸出功能以及包含 Out 動詞 (Out Cmdlet) 的 Cmdlet 顯示出來，例如 Out-Host、Out-File 和 Out-Printer。
如果沒有使用格式 cmdlet，Windows PowerShell 便會為顯示的每個物件套用預設格式。
GroupBy 參數會假設物件已經過排序。在使用 Format-Custom 將物件分組之前，請先使用 Sort-Object 將物件排序。
使用 View 參數可為表格指定替代格式。您可以使用 Windows PowerShell 目錄中 *.format.PS1XML 檔案所定義的檢視，也可以在新的 PS1XML 檔案中自行建立檢視，再使用 Update-FormatData Cmdlet 將所建立的檢視包含在 Windows PowerShell 中。
View 參數的替代檢視必須使用清單格式，否則命令會失敗。如果替代檢視是一份表格，請使用 Format-Table。如果替代檢視既不是清單也不是表格，請使用 Format-Custom。
範例 1
C:\PS>get-service | format-list
描述
-----------
這個命令將電腦中的服務相關資訊格式化為清單。根據預設，會將服務格式化為表格。Get-Service Cmdlet 會取得在電腦中代表服務的物件。管線運算子 (|) 透過管線將結果傳遞給 Format-List。接著，Format-List 命令會將服務資訊格式化為清單，再將它傳送到預設輸出 Cmdlet 以供顯示。
範例 2
C:\PS>$a = get-childitem $pshome\*.ps1xml
描述
-----------
這些命令將 Windows PowerShell 目錄中 PS1XML 檔案的相關資訊顯示為清單。第一個命令取得代表檔案的物件，再將它們儲存在 $a 變數中。第二個命令則使用 Format-List 將 $a 中所儲存之有關物件的資訊格式化。這個命令會使用 InputObject 參數將此變數傳遞給 Format-List，然後後者會將格式化的輸出傳送到預設輸出 Cmdlet 以供顯示。
範例 3
C:\PS>get-process | format-list -property name, basepriority, priorityclass
描述
-----------
這個命令顯示電腦中每個處理序的名稱、基本優先順序和優先類別。它會使用 Get-Process Cmdlet 來取得代表每個處理序的物件。管線運算子 (|) 透過管線將處理序物件傳遞給 Format-List。Format-List 會將處理序格式化為指定的屬性清單。"Property" 參數名稱為選擇項，因此可以省略。
範例 4
C:\PS>get-process winlogon | format-list -property *
描述
-----------
這個命令顯示 Winlogon 處理序的所有屬性。它會使用 Get-Process Cmdlet 來取得代表 Winlogon 處理序的物件。管線運算子 (|) 會透過管線將 Winlogon 處理序物件傳遞給 Format-List。命令使用 Property 參數來指定屬性，並以 * 表示所有屬性。因為 Property 參數的名稱為選擇性，您可以加以省略，而將命令輸入為："format-list *"。Format-List 會自動將結果傳送到預設輸出 Cmdlet 以供顯示。