將物件格式化為每個物件僅顯示一個屬性的寬表格。

語法

Format-Wide [[-屬性] <Object>] [-AutoSize] [-Column <int>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]

描述

Format-Wide Cmdlet 會將物件格式化為寬表格，只顯示每個物件中的一個屬性。您可以使用 Property 參數來決定顯示哪一個屬性。

參數

-AutoSize

根據資料的寬度來調整欄大小和欄數。預設情況下，欄大小和欄數是由檢視決定。同一個命令不能同時使用 AutoSize 和 Column 參數。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Column <int>

指定畫面上顯示的欄數。同一個命令不能同時使用 AutoSize 和 Column 參數。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-DisplayError

在命令列顯示錯誤。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Expand <string>

將集合物件連同集合中的物件一併格式化。此參數係設計為對支援 ICollection (System.Collections) 介面的物件進行格式化。預設值為 EnumOnly。

有效的值包括：

-- EnumOnly：顯示集合中各物件的屬性。

-- CoreOnly：顯示集合物件的屬性。

-- Both：顯示集合物件的屬性，以及集合中各物件的屬性。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Force

覆蓋限制以免命令無法成功執行，但僅限於變更不會危害安全性的部分。例如，Force 將會覆蓋唯讀屬性，或建立目錄以構成完整的檔案路徑，但不會嘗試變更檔案權限。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-GroupBy <Object>

依據共用屬性或值，將輸出格式化為群組。請輸入運算式或指定輸出的屬性。

GroupBy 參數的值可以是新的計算屬性。若要建立計算屬性，請使用雜湊表。有效的索引鍵包括：

-- Name (或 Label) <字串>

-- Expression <字串> 或 <指令碼區塊>

-- FormatString <字串>

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-InputObject <psobject>

指定要格式化的物件。請輸入包含物件的變數，或輸入可取得物件的命令或運算式。

必要?

false

位置?

named

預設值

接受管線輸入?

true (ByValue)

接受萬用字元?

false

-屬性 <Object>

指定呈現在畫面上的物件屬性及其呈現的順序。允許使用萬用字元。

如果省略此參數，呈現在畫面上的屬性將依所顯示的物件而定。參數名稱 ("Property") 為選擇項。同一個命令不能同時使用 Property 和 View 參數。

Property 參數的值可以是新的計算屬性。若要建立計算屬性，請使用雜湊表。有效的索引鍵包括：

-- 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-Wide。

輸出

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide 會傳回代表表格的格式物件。

附註

您也可以利用內建的別名 "fw" 來參照 Format-Wide。如需詳細資訊，請參閱 about_Aliases。

GroupBy 參數會假設物件已經過排序。在使用 Format-Custom 將物件分組之前，請先使用 Sort-Object 將物件排序。

使用 -View 參數可以為表格指定替代格式。您可以使用 Windows PowerShell 目錄中 *.format.PS1XML 檔案所定義的檢視，也可以在新的 PS1XML 檔案中自行建立檢視，再使用 Update-FormatData Cmdlet 將所建立的檢視包含在 Windows PowerShell 中。

View 參數的替代檢視必須使用表格格式，否則此命令會失敗。如果替代檢視是一份清單，請使用 Format-List。如果替代檢視既不是清單也不是表格，請使用 Format-Custom。

範例 1

C:\PS>get-childitem | format-wide -column 3

描述
-----------
這個命令在螢幕上的三欄中顯示目前目錄中的檔案名稱。Get-ChildItem Cmdlet 會取得代表目錄中每個檔案的物件。管線運算子 (|) 透過管線將檔案物件傳遞給 Format-Wide，後者再將它們格式化以供輸出。Column 參數可指定欄數。

範例 2

C:\PS>get-childitem HKCU:\software\microsoft | format-wide -property pschildname -autosize

描述
-----------
這個命令顯示 HKEY_CURRENT_USER\Software\Microsoft 機碼中的登錄機碼名稱。Get-ChildItem Cmdlet 會取得代表機碼的物件。路徑指定為 "HKCU:" (Windows PowerShell 登錄提供者所公開的其中一個磁碟機)，後面接著機碼路徑。管線運算子 (|) 會透過管線將登錄機碼物件傳遞給 Format-Wide，後者再將它們格式化以供輸出。Property 參數會指定屬性的名稱，而 AutoSize 參數則調整欄的大小以提高可讀性。



目錄