Format-Wide

参考

模块:: Microsoft.PowerShell.Utility

将对象格式化为仅显示每个对象的一个属性的宽表。

语法

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 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，该对象为输出设置格式。属性参数指定属性的名称，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

设置集合对象以及集合中的对象的格式。此参数旨在设置支持 ICollection （System.Collections）接口的对象的格式。默认值为 enumOnly。

有效值为：

枚举：显示集合中对象的属性。
CoreOnly：显示集合对象的属性。
两者：显示集合对象的属性和集合中对象的属性。

类型:	String
接受的值:	CoreOnly, EnumOnly, Both
Position:	Named
默认值:	EnumOnly
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

指示此 cmdlet 会替代阻止命令成功的限制，因此更改不会危及安全性。例如，Force 将替代只读属性或创建目录以完成文件路径，但不会尝试更改文件权限。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-GroupBy

根据共享属性或值在组中设置输出的格式。输入输出的表达式或属性。

GroupBy 参数的值可以是新的计算属性。若要创建计算属性，请使用哈希表。此参数的可接受值为：

名称（或标签）<字符串>
表达式 <字符串> 或 <脚本块>
FormatString <字符串>

类型:	Object
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

指定要设置格式的对象。输入包含对象的变量，或键入获取对象的命令或表达式。

类型:	PSObject
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Property

指定显示在显示中的对象属性及其显示顺序。允许通配符。

如果省略此参数，显示中显示的属性取决于所显示的对象。参数名称“Property”是可选的。不能在同一命令中使用属性和视图参数。

属性参数的值可以是新的计算属性。若要创建计算属性，请使用哈希表。有效密钥包括：

表达式 <字符串> 或 <脚本块>
FormatString <字符串>

类型:	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

可以通过管道将任何对象传递给 Format-Wide。

输出

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide 返回表示表的格式对象。

备注

还可以通过其内置别名 fw来引用 Format-Wide。有关详细信息，请参阅 about_Aliases。

GroupBy 参数假定对象已排序。使用 Format-Custom 对对象进行分组之前，请使用 Sort-Object。

使用 View 参数可以指定表的备用格式。可以使用 PowerShell 目录中 *.format.PS1XML 文件中定义的视图，也可以在新的 PS1XML 文件中创建自己的视图，并使用 Update-FormatData cmdlet 将其包含在 PowerShell 中。

View 参数的备用视图必须使用表格式;如果未这样做，命令将失败。如果备用视图是列表，请使用 Format-List。如果备用视图既不是列表也不是表，请使用 Format-Custom。

通过