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