Format-Custom
使用自訂檢視來格式化輸出。
語法
Format-Custom [[-Property] <Object[]>] [-Depth <int>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]
描述
Format-Custom Cmdlet 會按照替代檢視中定義的方式，格式化命令的輸出。Format-Custom 是專為顯示純粹表格或純粹清單以外的檢視而設計。您可以使用 Windows PowerShell 目錄中 *format.PS1XML 檔案所定義的檢視，也可以在新的 PS1XML 檔案中自行建立檢視，再使用 Update-FormatData Cmdlet 將所建立的檢視加入至 Windows PowerShell。
參數
-Depth <int>
指定畫面上顯示的欄數。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-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 參數的值可以是新的計算屬性。若要建立計算屬性，請使用雜湊表。有效的索引鍵包括：
-- Expression <字串> 或 <指令碼區塊>
-- Depth <int32>
必要? |
false |
位置? |
1 |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-ShowError
透過管線傳送錯誤。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-View <string>
指定替代格式或「檢視」的名稱。如果省略此參數，Format-Custom 會使用預設的自訂檢視。同一個命令不能同時使用 Property 和 View 參數。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
輸入 |
System.Management.Automation.PSObject 您可經由管道將任何物件輸出至 Format-Custom |
輸出 |
Microsoft.PowerShell.Commands.Internal.Format Format-Custom 會傳回代表顯示的格式物件。 |
附註
Format-Custom 是專為顯示純粹表格或純粹清單以外的檢視而設計。若要顯示替代表格檢視，請使用 Format-Table。若要顯示替代清單檢視，請使用 Format-List。
您也可以利用內建的別名 "fc" 來參照 Format-Custom。如需詳細資訊，請參閱 about_Aliases。
GroupBy 參數會假設物件已經過排序。在使用 Format-Custom 將物件分組之前，請先使用 Sort-Object 將物件排序。
範例 1
C:\PS>get-command start-transcript | format-custom -view MyView
描述
-----------
這個命令使用 MyView 檢視 (使用者建立的自訂檢視) 定義的格式，將有關 Start-Transcript Cmdlet 的資訊格式化。若要成功執行這個命令，必須先建立新的 PS1XML 檔案、定義 MyView 檢視，然後使用 Update-FormatData 命令將 PS1XML 檔案加入至 Windows PowerShell。
範例 2
C:\PS>get-process Winlogon | format-custom
描述
-----------
這個命令會以替代的自訂檢視來格式化 Winlogon 處理序的資訊。因為此命令沒有使用 View 參數，所以 Format-Custom 使用預設的自訂檢視來格式化資料。