共用方式為


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 使用預設的自訂檢視來格式化資料。