Format-Wide
将对象的格式设置为只能显示每个对象的一个属性的宽表。
语法
Format-Wide [[-Property] <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 |
-Property <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 返回表示表的格式对象。 |
说明
还可以使用 Format-Wide 的内置别名“fw”来对其进行引用。有关详细信息，请参阅 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 参数用于调整列以增加可读性。