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

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

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

Format-Custom (Microsoft.PowerShell.Utility)

Format-Custom

模块 ：Microsoft.PowerShell.Utility

使用自定义视图来格式化输出。

句法

Format-Custom
      [[-Property] <Object[]>]
      [-Depth <Int32>]
      [-GroupBy <Object>]
      [-View <String>]
      [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <String>]
      [-InputObject <PSObject>]
      [<CommonParameters>]

描述

Format-Custom cmdlet 按照备用视图中的定义格式化命令的输出。 Format-Custom 旨在显示不仅仅是表格或列表的视图。您可以使用 PowerShell 中定义的视图，也可以在新的 format.ps1xml 文件中创建自己的视图，并使用 Update-FormatData cmdlet 将它们添加到 PowerShell。

示例

示例 1：使用自定义视图格式化输出

Get-Command Start-Transcript | Format-Custom -View MyView

此命令将有关 Start-Transcript cmdlet 的信息格式化为 MyView 视图（用户创建的自定义视图）定义的格式。要成功运行此命令，您必须首先创建一个新的 PS1XML 文件，定义 MyView 视图，然后使用 Update-FormatData 命令将 PS1XML 文件添加到 PowerShell。

示例 2：使用默认视图格式化输出

Get-Process Winlogon | Format-Custom

此命令在备用自定义视图中格式化有关 Winlogon 进程的信息。由于该命令不使用 View 参数，因此 Format-Custom 使用默认的自定义视图来格式化数据。

示例 3：格式错误故障排除

以下示例显示了使用表达式添加 DisplayError 或 ShowError 参数的结果。

PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -DisplayError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  = #ERR
}


PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -ShowError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  =
}

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 8:01:04 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

参数

-Depth

指定显示中的列数。

类型 ：

整数32

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-DisplayError

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

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Expand

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

有效值为：

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

String

接受的值：

仅核心、仅枚举、两者

位置：

命名

默认值：

EnumOnly

必需的：

False

接受管道输入：

False

接受通配符：

False

-Force

指示 cmdlet 显示所有错误信息。与 DisplayError 或 ShowError 参数一起使用。默认情况下，当错误对象写入错误或显示流时，仅显示部分错误信息。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-GroupBy

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

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

  • 名称（或标签）- <string>
  • 表达式 - <string> 或 <script; block>
  • 格式字符串 - <string>

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

类型 ：

目的

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-InputObject

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

类型 ：

PS对象

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-Property

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

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

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

  • 表达式 - <string> 或 <script; block>
  • 深度 - <int32>

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

类型 ：

Object[]

位置：

0

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

True

-ShowError

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

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-View

指定备用格式或视图的名称。如果省略此参数，Format-Custom 将使用默认自定义视图。您不能在同一命令中使用属性和视图参数。

类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

输入

PSObject

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

输出

Microsoft.PowerShell.Commands.Internal.Format

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

笔记

PowerShell 包含以下 Format-Custom 别名：

  • 所有平台：

      fc

    Format-Custom 旨在显示不仅仅是表格或列表的视图。要显示备用表格视图，请使用Format-Table。要显示备用列表视图，请使用Format-List。

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

    猜你还喜欢

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

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

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

      关灯