登录  |  注册
当前位置：网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] Format-Wide (Microsoft.PowerShell.Utility)

作者：精品下载站 日期：2024-12-14 02:07:24 浏览：13 分类：玩电脑

Format-Wide (Microsoft.PowerShell.Utility)

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，后者将它们格式化以供输出。 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

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Column

指定显示中的列数。您不能在同一命令中使用AutoSize 和Column 参数。

类型 ：

整数32

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-DisplayError

在命令行中显示错误。此参数很少使用，但当您在 Format-Wide 命令中格式化表达式并且表达式似乎不起作用时，可以将其用作调试辅助工具。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Expand

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

有效值为：

  • EnumOnly：显示集合中对象的属性。
  • CoreOnly：显示集合对象的属性。
  • Both：显示集合对象的属性和集合中对象的属性。
类型 ：

String

接受的值：

仅核心、仅枚举、两者

位置：

命名

默认值：

EnumOnly

必需的：

False

接受管道输入：

False

接受通配符：

False

-Force

指示此 cmdlet 会覆盖阻止命令成功的限制，以便更改不会损害安全性。例如，强制将覆盖只读属性或创建目录来完成文件路径，但它不会尝试更改文件权限。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-GroupBy

根据共享属性或值对输出进行分组格式化。输入输出的表达式或属性。

GroupBy 参数的值可以是新的计算属性。计算的属性可以是脚本块或哈希表。有效的键值对是：

  • 名称（或标签）- <string>
  • 表达式 - <字符串> 或 <脚本块>
  • 格式字符串 - <字符串>

有关详细信息，请参阅 about_Calculated_Properties。

类型 ：

目的

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-InputObject

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

类型 ：

PS对象

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-Property

指定显示中出现的对象属性。允许使用通配符。

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

Property 参数的值可以是新的计算属性。计算的属性可以是脚本块或哈希表。有效的键值对是：

  • 表达式 - <字符串> 或 <脚本块>
  • 格式字符串 - <字符串>

有关详细信息，请参阅 about_Calculated_Properties。

类型 ：

目的

位置：

0

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

True

-ShowError

通过管道发送错误。此参数很少使用，但当您在 Format-Wide 命令中格式化表达式并且表达式似乎不起作用时，可以将其用作调试辅助工具。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-View

指定备用表格式或视图的名称。您不能在同一命令中使用属性和视图参数。

类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

输入

PSObject

您可以通过管道将任何对象传递给此 cmdlet。

输出

Microsoft.PowerShell.Commands.Internal.Format

此 cmdlet 返回表示表的格式对象。

笔记

PowerShell 包含以下 Format-Wide 别名：

  • 所有平台：

      fw

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

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

    View参数的备用视图必须使用表格格式；如果不存在，则该命令失败。如果备用视图是列表，请使用Format-List。如果备用视图既不是列表也不是表格，请使用Format-Custom。

    猜你还喜欢

    您需要 登录账户 后才能发表评论

    取消回复欢迎 你 发表评论:

    精品推荐！
    欢迎 访客 登录没有账号？
    • 最新文章
    • 热门文章
    • 热评文章
    最新评论
      热门tag
      友情链接

      关灯