Format-List 帮助信息

 

如下说明是翻译 PowerShell 中 : help Format-List 产生的帮助信息 .

译者 : Edengundam( 马涛 )

 

Format-List

 

摘要

将输出格式化为属性列表 ( 每个属性出现在新的一行 ).

 

语法

Format-List [[-property] <Object[]>] [-view <string>] [-groupBy <Object>] [-force] [-inputObject <psobject>] [-expand <string>] [-displayError] [-showError] [<CommonParameters>]

 

详细描述

Format-List cmdlet 将输出格式化为属性列表 , 每个属性将会显示在单独的一行中 . 每一项显示在一个列表 (list) 而不是表格 (table) 中 , 将会拥有更多的可用空间 , Windows PowerShell 将会在列表中显示更多对象的属性 , 并且属性值被截断的情况也会更少 . 你可以使用命令 (format-list *) 将对象的所有属性格式化为列表形式 , 以查看对象的所有属性 .

 

参数

 

-property <Object[]>

指定要在屏幕上显示的对象属性及其显示顺序 . 允许使用通配符 . 

 

如果你忽略此参数 , 屏幕上显示的属性将会根据需要显示的对象决定 . 参数名称 ("-Property") 为可选项 . 你不能在同一个命令中同时使用 Property 和 View 参数 .

 

强制参数 ?	false
参数位置 ?	1
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-view <string>

指定其他的表格式 ( 或视图 ). 你不能在同一个命令中同时使用 Property 和 View 参数 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-groupBy <Object>

根据共享的属性或值将输出结果进行分组 . 输入一个表达式或输出的属性 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-force <SwitchParameter>

在不破坏安全前提下 , 能够避免影响命令成功执行的限制条件 . 例如 : Force 参数能够覆盖具有只读属性的文件或创建路径中的必要成分 , 但是不会改变人和文件的权限 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-inputObject <psobject>

指定需要格式化的对象 . 输入一个包含对象的变量 , 或者一个能够产生对象的命令或表达式 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	true ( 根据值 )
允许通配符扩展 ?	false

 

-expand <string>

格式化集合和集合中元素 . 设计此参数用于格式化那些支持 ICollection(System.Collections) 接口的对象 .

 

合法取值 :

 

·          Enum ( 默认 ): 显示集合中元素的属性 .

·          Core: 显示集合对象的属性 .

·          Both: 显示集合和集合中元素的属性 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-displayError <SwitchParameter>

在命令行上显示错误 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-showError <SwitchParameter>

通过管道发送错误 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

 

输入类型

Object

 

返回类型

被格式化的对象

 

注意

 

格式化 cmdlets, 例如 : format-list, 能够重新排列需要显示的数据 , 但是并不会显示它 . 数据是通过 Windows PowerShell 的输出机制以及 out-* cmdlets, 例如 : Out-Host, Out-File 和 Out-Printer 进行显示的 .

 

如果你没有使用格式化 cmdlet, Windows PowerShell 将会对被显示对象应用该对象的默认格式化命令进行显示 .

 

更多信息 , 输入 "Get-Help Format-List -detailed". 需要技术信息 , 输入 "Get-Help Format-List -full".

 

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 : "<parameter-name> <value1>, <value2>".

 

你可以使用 Format-List 内建别名 : "FL". 需要更多信息 , 查看 About_Alias .

 

参数 -Groupby 假设对象已经排序 . 在使用 Format-Custom 对对象进行分组前 , 使用 Sort-Object 将它们排序 .

 

参数 -View 允许您指定表的可选格式 . 你可以使用定义在 Windows PowerShell 目录中 *.format.PS1XML 文件中的格式 , 或者创建属于你自己的 PS1XML 文件 , 并使用 Update-FormatData cmdlet 将它们添加到 Windows PowerShell 中 .

 

参数 View 使用的可选视图必须是表格式 ; 如果不是 , 命令将会执行失败 . 如果可选视图为列表 , 使用 Format-List . 如果可选视图既不是列表也不是表 , 使用 Format-Custom .

 

例 1

 

C:/PS>get-service | format-list

 

此命令将计算机上的服务信息格式化为列表 . 默认情况下 , 服务被格式化为表格 . Get-Service cmdlet 取得表示计算机上服务的对象 . 管道运算符 (|) 将结果通过管道发送给 Format-List. 接下来 , Format-List 命令将服务信息格式化为列表 , 并将它发送给输出器进行显示 .

 

例 2

 

C:/PS>$a = get-childitem $pshome/*.ps1xml

 

C:/PS>format-list -InputObject $a

 

此命令将会以列表形式显示 Windows PowerShell 目录中 PS1XML 文件 . 第一个命令取得表示这些文件的对象 , 并将它们存储在变量 $a 中 . 第二个命令使用 Format-List 来格式化并显示存储在变量 $a 中的对象信息 . 此命令使用 InputObject 参数将变量的值传递给 Format-List, 后者将格式化后的输出发送给输出器进行显示 .

 

例 3

 

C:/PS>get-process | format-list -property name, basepriority, priorityclass

 

此命令显示本地计算机上运行进程的 name, base priority 和 priority class 属性 . 它使用 Get-Process cmdlet 取得表示每个进程的对象 . 管道运算符 (|) 将进程对象通过管道传递给 Format-List. Format-List 将进程格式化为具有指定属性的列表形式 . 参数 "-property" 的名称是可选项 , 所以这个例子中你可以省略它 .

 

例 4

 

C:/PS>get-process winlogon | format-list -property *

 

此命令显示 Winlogon 进程的所有属性 . 它使用 Get-Process cmdlet 取得表示 Winlogon 进程的对象 . 管道运算符 (|) 将表示 Winlogon 进程的对象传通过管道递给 Format-List. 此命令使用参数 Property 指定要显示的对象属性 , 星号 * 指出显示对象的全部属性 . 因为参数 -property 的名称为可选项 , 你可以省略它 , 你可以输入 : "format-list *". Format-List 自动将结果发送给输出器进行显示 .

 

相关链接

Format-Custom

Format-Table

Format-Wide

Out-Host

Out-File