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 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 Registry 提供程序公开,其后跟项路径。 管道运算符 (|
) 将注册表项对象通过管道传递给 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 参数的值可以是新计算属性。 计算属性可以是脚本块或哈希表。 有效的键值对包括:
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 为可选项。 不能在同一命令中使用 Property 和 View 参数。
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
指定替代表格格式或视图的名称。 不能在同一命令中使用 Property 和 View 参数。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
你可以通过管道将任何对象传递给此 cmdlet。
输出
Microsoft.PowerShell.Commands.Internal.Format
此 cmdlet 返回表示表格的格式对象。
备注
Windows PowerShell 包含 Format-Wide
的以下别名:
fw
GroupBy参数假定对象已进行排序。 使用 Format-Custom
对对象进行分组之前,请使用 Sort-Object
。
使用 View 参数可以指定表的替代格式。 可以使用 PowerShell 目录中的 *.format.PS1XML
文件中定义的视图,或者可在新的 PS1XML 文件中创建自己的视图,并使用 Update-FormatData
cmdlet 将它们包括在 PowerShell 中。
View 参数的可选视图必须使用表格式;否则,该命令将失败。 如果替代视图为列表,请使用 Format-List
。 如果替代视图既不是列表也不是表格,请使用 Format-Custom
。
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈