Format-Wide
將物件以每個物件只顯示一個屬性的寬型表格方式格式化。
Syntax
Format-Wide
[[-Property] <Object>]
[-AutoSize]
[-Column <int>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]Description
Cmdlet 會將 Format-Wide 物件格式化為寬數據表，只顯示每個物件的一個屬性。 您可以使用 Property 參數來判斷要顯示的屬性。
範例
範例 1：格式化目前目錄中的檔名
這個命令會在螢幕上以三欄顯示目前目錄中檔案的名稱。
Get-ChildItem | Format-Wide -Column 3Get-ChildItem Cmdlet 會取得代表目錄中每個檔案的物件。 管線運算子 (|) 會將檔案物件透過管線傳遞至 Format-Wide，以將其格式化為輸出。 Column 參數會指定數據行數目。
範例 2：格式化登錄機碼的名稱
這個命令會顯示 HKEY_CURRENT_USER\Software\Microsoft 機碼中登錄機碼的名稱。
Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSizeGet-ChildItem Cmdlet 會取得代表機碼的物件。 路徑會指定為 HKCU：，這是 PowerShell 登錄提供者所公開的其中一個磁碟驅動器，後面接著機碼路徑。 管線運算子 (|) 會將登錄機碼物件透過管線傳遞至 Format-Wide，以將其格式化為輸出。 Property 參數會指定屬性的名稱，而 AutoSize 參數會調整數據行以供可讀性。
範例 3：針對格式錯誤進行疑難解答
下列範例顯示使用表示式新增 DisplayError 或 ShowError 參數的結果。
PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError
#ERR
PS /> Get-Date | Format-Wide { $_ / $null } -ShowError
Failed to evaluate expression " $_ / $null ".
+ CategoryInfo : InvalidArgument: (12/21/2018 8:18:01 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError參數
-AutoSize
根據資料的寬度調整欄大小和欄數。 根據預設，欄大小和欄數是由檢視決定。 您無法在相同的命令中使用 AutoSize 和 Column 參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Column
指定畫面上顯示的欄數。 您無法在相同的命令中使用 AutoSize 和 Column 參數。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayError
在命令列中顯示錯誤。 這個參數很少使用，但當您在命令中 Format-Wide 格式化表達式時，可以做為偵錯輔助功能，而且表達式似乎無法運作。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Expand
將集合物件以及集合中的物件格式化。 這個參數是設計來將支援 ICollection (System.Collections) 介面的物件格式化。 預設值為 EnumOnly。
有效值為：
- EnumOnly：顯示集合中物件的屬性。
- CoreOnly：顯示集合物件的屬性。
- Both：顯示集合物件的屬性及集合中物件的屬性。
| Type: | String |
| Accepted values: | CoreOnly, EnumOnly, Both |
| Position: | Named |
| Default value: | EnumOnly |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
指出此 Cmdlet 會覆寫防止命令成功的限制，因此變更不會危害安全性。 例如，Force 會覆寫唯讀屬性或建立目錄來完成檔案路徑，但不會嘗試變更檔案權限。
| 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>或<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
透過管線傳送錯誤。 這個參數很少使用，但當您在命令中 Format-Wide 格式化表達式時，可以做為偵錯輔助功能，而且表達式似乎無法運作。
| 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-Wide。
輸出
Microsoft.PowerShell.Commands.Internal.Format
Format-Wide 會傳回代表數據表的格式物件。
備註
您也可以Format-Wide參考其內建別名 。 fw 如需詳細資訊，請參閱 about_Aliases。
GroupBy 參數會假設物件已排序。 使用 Sort-Object 之前 Format-Custom 使用 來群組物件。
View 參數可讓您指定資料表的替代格式。 您可以使用 PowerShell 目錄中檔案中 *.format.PS1XML 定義的檢視，也可以在新的 PS1XML 檔案中建立自己的檢視，並使用 Update-FormatData Cmdlet 將它們包含在 PowerShell 中。
View 參數的替代檢視必須使用數據表格式;如果沒有，命令就會失敗。 如果替代檢視是清單，請使用 Format-List。 如果替代檢視既非清單也非表格，請使用 Format-Custom。