如下说明是翻译PowerShell中: help Format-List 产生的帮助信息.
译者: Edengundam(马涛)
Format-List
摘要
将输出格式化为属性列表(每个属性出现在新的一行).
语法
Format-List [[-property] ] [-view ] [-groupBy
详细描述
Format-List cmdlet将输出格式化为属性列表, 每个属性将会显示在单独的一行中. 每一项显示在一个列表(list)而不是表格(table)中, 将会拥有更多的可用空间, Windows PowerShell将会在列表中显示更多对象的属性, 并且属性值被截断的情况也会更少. 你可以使用命令(format-list *)将对象的所有属性格式化为列表形式, 以查看对象的所有属性.
参数
-property
指定要在屏幕上显示的对象属性及其显示顺序. 允许使用通配符.
如果你忽略此参数, 屏幕上显示的属性将会根据需要显示的对象决定. 参数名称("-Property")为可选项. 你不能在同一个命令中同时使用Property和View参数.
|
强制参数? |
false |
|
参数位置? |
1 |
|
默认值 |
|
|
允许从管道绑定输入? |
false |
|
允许通配符扩展? |
false |
-view
指定其他的表格式(或视图). 你不能在同一个命令中同时使用Property和View参数.
|
强制参数? |
false |
|
参数位置? |
named |
|
默认值 |
|
|
允许从管道绑定输入? |
false |
|
允许通配符扩展? |
false |
-groupBy
根据共享的属性或值将输出结果进行分组. 输入一个表达式或输出的属性.
|
强制参数? |
false |
|
参数位置? |
named |
|
默认值 |
|
|
允许从管道绑定输入? |
false |
|
允许通配符扩展? |
false |
-force
在不破坏安全前提下, 能够避免影响命令成功执行的限制条件. 例如: Force参数能够覆盖具有只读属性的文件或创建路径中的必要成分, 但是不会改变人和文件的权限.
|
强制参数? |
false |
|
参数位置? |
named |
|
默认值 |
|
|
允许从管道绑定输入? |
false |
|
允许通配符扩展? |
false |
指定需要格式化的对象. 输入一个包含对象的变量, 或者一个能够产生对象的命令或表达式.
|
强制参数? |
false |
|
参数位置? |
named |
|
默认值 |
|
|
允许从管道绑定输入? |
true (根据值) |
|
允许通配符扩展? |
false |
-expand
格式化集合和集合中元素. 设计此参数用于格式化那些支持ICollection(System.Collections)接口的对象.
合法取值:
· Enum (默认): 显示集合中元素的属性.
· Core: 显示集合对象的属性.
· Both: 显示集合和集合中元素的属性.
|
强制参数? |
false |
|
参数位置? |
named |
|
默认值 |
|
|
允许从管道绑定输入? |
false |
|
允许通配符扩展? |
false |
-displayError
在命令行上显示错误.
|
强制参数? |
false |
|
参数位置? |
named |
|
默认值 |
|
|
允许从管道绑定输入? |
false |
|
允许通配符扩展? |
false |
-showError
通过管道发送错误.
|
强制参数? |
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".
如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如: " , ".
你可以使用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
阅读(2377) | 评论(0) | 转发(0) |
