共用方式為

Format-Wide

  • 參考
模組:
Microsoft.PowerShell.Utility

將物件格式化為寬數據表，只顯示每個物件的一個屬性。

語法

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

Description

Format-Wide Cmdlet 會將物件格式化為只顯示每個物件的一個屬性的寬數據表。 您可以使用 Property 參數來判斷要顯示的屬性。

範例

範例 1：格式化目前目錄中的檔名

此命令會在畫面的三個數據行中顯示目前目錄中的檔名。

Get-ChildItem | Format-Wide -Column 3

Get-ChildItem Cmdlet 會取得代表目錄中每個檔案的物件。 管線運算子 （|） 會透過管線將檔案對象傳遞至 Format-Wide，以將其格式化為輸出。 Column 參數會指定資料行數目。

範例 2：格式化登錄機碼的名稱

此命令會顯示 HKEY_CURRENT_USER\Software\Microsoft 鍵中的註冊表機碼名稱。

Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize

Get-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 參數。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Column

指定顯示中的數據行數目。 您不能在相同的命令中使用 AutoSize 和 Column 參數。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisplayError

在命令列上顯示錯誤。 這個參數很少使用，但是當您在 Format-Wide 命令中格式化表達式時，可以用來做為偵錯輔助，而且表達式似乎無法運作。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Expand

格式化集合物件以及其中的物件。 此參數的設計目的是要格式化支援 System.Collections.ICollection 介面的物件。 預設值為 EnumOnly。

有效值為：

  • EnumOnly：顯示集合中對象的屬性。
  • CoreOnly：顯示集合對象的屬性。
  • Both：顯示集合物件的屬性和集合中對象的屬性。
類型:String
接受的值:CoreOnly, EnumOnly, Both
Position:Named
預設值:EnumOnly
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

指出此 Cmdlet 會覆寫那些防止命令成功的限制，且確保這些變更不會危害安全性。 例如，Force 會覆寫唯讀屬性或建立目錄以完成檔案路徑，但不會嘗試變更檔案許可權。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-GroupBy

根據共用屬性或值，將輸出格式化為群組。 輸入輸出的表達式或屬性。 GroupBy 參數預期物件已排序。 使用 Format-Wide 來群組物件之前，請先使用 Sort-Object Cmdlet。

GroupBy 參數的值可以是新的計算屬性。 匯出屬性可以是腳本區塊或哈希表。 有效的鍵值對如下：

  • Name （或 Label） - <string>
  • Expression - <string> 或 <script block>
  • FormatString - <string>

如需詳細資訊，請參閱 about_Calculated_Properties。

類型:Object
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InputObject

指定要格式化的物件。 輸入包含 物件的變數，或輸入取得物件的命令或表達式。

類型:PSObject
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Property

指定顯示中顯示的物件屬性。 允許通配符。

如果您省略此參數，顯示中顯示的屬性取決於所顯示的物件。 參數名稱 屬性 是選擇性的。 您不能在相同的命令中使用 屬性 和 檢視 參數。

Property 參數的值可以是新的計算屬性。 匯出屬性可以是腳本區塊或哈希表。 有效的鍵-值對如下：

  • Expression - <string> 或 <script block>
  • FormatString - <string>

若需進一步資訊，請參閱 about_Calculated_Properties。

類型:Object
Position:0
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

-ShowError

透過管線傳送錯誤。 這個參數很少使用，但是當您在 Format-Wide 命令中格式化表達式時，可以用來做為偵錯輔助，而且表達式似乎無法運作。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-View

指定替代數據表格式或檢視的名稱。 您不能在相同的命令中使用 屬性 和 檢視 參數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

PSObject

您可以使用管道將任何物件傳送至此 cmdlet。

輸出

Microsoft.PowerShell.Commands.Internal.Format

此 Cmdlet 會傳回代表數據表的格式物件。

備註

Windows PowerShell 包含下列 Format-Wide別名：

  • fw

View 參數可讓您指定資料表的替代格式。 您可以使用PowerShell目錄中 *.format.PS1XML 檔案中定義的檢視，也可以在新的 PS1XML 檔案中建立自己的檢視，並使用 Update-FormatData Cmdlet 將它們包含在 PowerShell 中。

View 參數的替代檢視必須使用數據表格式;如果沒有，命令會失敗。 如果替代檢視是清單，請使用 Format-List。 如果替代檢視不是清單或資料表，請使用 Format-Custom。