Format-Wide
將物件格式化為每個物件僅顯示一個屬性的寬表格。
語法
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 參數則調整欄的大小以提高可讀性。