Format-List
將輸出格式化為屬性清單，其中每個屬性會顯示在新的一行上。
Syntax
Format-List
[[-Property] <Object[]>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError][-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]Description
Cmdlet 會將 Format-List 命令的輸出格式化為屬性清單，其中每個屬性都會顯示在個別行上。 您可以使用 Format-List 來格式化和顯示物件的所有或選取屬性，做為清單 (格式清單 *) 。
因為清單中每個專案可用的空間比數據表中還要多，所以 PowerShell 會在清單中顯示更多對象的屬性，而且屬性值不太可能被截斷。
範例
範例 1：格式化計算機服務
Get-Service | Format-List此命令將電腦上關於服務的資訊格式化為清單。 根據預設，服務會格式化為表格。 Cmdlet Get-Service 會取得物件，代表計算機上的服務。 管線運算子 (|) 透過管線將結果傳遞至 Format-List。
然後，命令會 Format-List 格式化清單中的服務資訊，並將其傳送至默認輸出 Cmdlet 以顯示。
範例 2：格式化 PS1XML 檔案
這些命令會將PowerShell目錄中 PS1XML 檔案的相關信息顯示為清單。
$A = Get-ChildItem $pshome\*.ps1xml
Format-List -InputObject $A第一個命令會取得代表檔案的物件，並將其儲存在變數中 $A 。
第二個命令會使用 Format-List 來格式化儲存在 中 $A之對象的相關信息。 此命令會使用 InputObject 參數將變數傳遞至 Format-List，然後將格式化的輸出傳送至預設輸出 Cmdlet 以供顯示。
範例 3：依名稱格式化進程屬性
此命令顯示電腦上每個處理程序的名稱、基本優先順序和優先順序類別。
Get-Process | Format-List -Property name, basepriority, priorityclass它會使用 Get-Process Cmdlet 來取得代表每個進程的物件。 管線運算子 (|) 將行程物件透過管線傳遞至 Format-List。 Format-List 將進程格式化為指定屬性的清單。 Property 參數名稱是選擇性的，因此您可以省略它。
範例 4：格式化進程的所有屬性
此命令顯示 Winlogon 處理程序的所有屬性。
Get-Process winlogon | Format-List -Property *它使用 Get-Process Cmdlet 取得代表 Winlogon 處理程序的物件。 管線運算子 (|) 將 Winlogon 行程物件透過管線傳遞至 Format-List。 此命令會使用 Property 參數來指定屬性和 * 來表示所有屬性。
因為 Property 參數的名稱是選擇性的，所以您可以省略它，並將命令輸入為 Format-List *。 Format-List 會自動將結果傳送至預設輸出 Cmdlet 以顯示。
範例 5：針對格式錯誤進行疑難解答
下列範例顯示使用表示式新增 DisplayError 或 ShowError 參數的結果。
PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -DisplayError
DayOfWeek : Friday
$_ / $null : #ERR
PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError
DayOfWeek : Friday
$_ / $null :
Failed to evaluate expression " $_ / $null ".
+ CategoryInfo : InvalidArgument: (12/21/2018 7:59:23 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError參數
-DisplayError
指出這個 Cmdlet 會在命令行上顯示錯誤。 這個參數很少使用，但當您在命令中 Format-List 格式化表達式時，可以做為偵錯輔助，而且表達式似乎無法運作。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 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 會顯示所有錯誤資訊。 搭配 DisplayError 或 ShowError 參數使用。 根據預設，將錯誤物件寫入錯誤或顯示串流時，只會顯示某些錯誤資訊。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GroupBy
根據共用屬性或值，指定群組中的輸出。 輸入輸出的運算式或屬性。
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 |
-InputObject
指定要格式化的物件。 輸入包含物件的變數，或輸入可取得物件的命令或運算式。
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Property
指定顯示中出現的物件屬性及其出現順序。 允許使用萬用字元。
如果省略這個參數，則出現在顯示中的屬性將取決於所顯示的物件。 參數名稱 「Property」 是選擇性的。 您無法在相同的命令中使用 Property 和 View 參數。
Property 參數的值可以是新的導出屬性。 匯出屬性可以是腳本區塊或哈希表。 有效的機碼/值組為：
- 名稱 (或標籤) -
<string> - 表達式 -
<string>或<script block> - FormatString -
<string>
如需詳細資訊，請參閱 about_Calculated_Properties。
| Type: | Object[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-ShowError
表示 Cmdlet 會透過管線傳送錯誤。 這個參數很少使用，但當您在命令中 Format-List 格式化表達式時，可以做為偵錯輔助，而且表達式似乎無法運作。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-View
指定替代清單格式或檢視的名稱。 您無法在相同的命令中使用 Property 和 View 參數。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
您可以使用管線將任何物件傳送至 Format-List。
輸出
Microsoft.PowerShell.Commands.Internal.Format
Format-List 會傳回代表清單的格式物件。
備註
您也可以透過內建別名 FL 參考 Format-List。 如需詳細資訊，請參閱 about_Aliases。
格式 Cmdlet，例如 Format-List，會排列要顯示但不會顯示的數據。
資料是由 PowerShell 的輸出功能，以及包含 Out 動詞的 Cmdlet (Out Cmdlet) 顯示，例如 Out-Host 或 Out-File。
如果您未使用格式 Cmdlet，PowerShell 會針對它所顯示的每個物件套用該預設格式。
GroupBy 參數假設物件已排序。 使用 Sort-Object，再使用 Format-List 來分組物件。
View 參數可讓您指定資料表的替代格式。 您可以使用PowerShell目錄中檔案中 *.format.PS1XML 定義的檢視，也可以在新的 PS1XML 檔案中建立自己的檢視，並使用 Update-FormatData Cmdlet 將它們包含在 PowerShell 中。
View 參數的替代檢視必須使用清單格式，否則命令會失敗。 如果替代檢視是資料表， 請使用 Format-Table。 如果替代檢視不是清單或資料表，請使用 Format-Custom。