Format-Wide
将对象格式化为仅显示每个对象的一个属性的宽表。
语法
Format-Wide
[[-Property] <Object>]
[-AutoSize]
[-Column <int>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]说明
Format-Wide cmdlet 将对象格式化为仅显示每个对象的一个属性的宽表。 可以使用 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 Registry 提供程序公开，其后跟项路径。 管道运算符（|）通过管道将注册表项对象传递到 Format-Wide，它将这些对象格式化以供输出。 属性 参数指定属性的名称，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
指定显示在显示中的对象属性。 允许使用通配符。
如果省略此参数，显示中显示的属性取决于所显示的对象。 属性 的参数名称是可选的。 不能在同一命令中使用 属性 和 视图 参数。
属性的 参数值可以是一个新计算出来的属性。 计算属性可以是脚本块或哈希表。 有效的键值对包括：
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 |
输入
你可以通过管道将任何对象传递给此 cmdlet。
输出
Microsoft.PowerShell.Commands.Internal.Format
此命令返回代表表格的格式化对象。
备注
Windows PowerShell 包含以下与 Format-Wide相关的别名：
fw
使用 View 参数可以指定表的备用格式。 可以使用 PowerShell 目录中 *.format.PS1XML 文件中定义的视图，也可以在新的 PS1XML 文件中创建自己的视图，并使用 Update-FormatData cmdlet 将其包含在 PowerShell 中。
View 参数的备用视图必须使用表格式;如果未这样做，命令将失败。 如果备用视图是列表，请使用 Format-List。 如果备用视图既不是列表也不是表，请使用 Format-Custom。
