Tee-Object 帮助信息

 

如下说明是翻译: help Tee-Object 产生的帮助信息.

译者: Edengundam(马涛)

 

Tee-Object

 

大纲

将管道输入的对象保存在文件或变量中, 同时将该对象沿着管道继续传递.

 

语法

Tee-Object [-filePath] <string> [-inputObject <psobject>] [<CommonParameters>]

 

Tee-Object -variable <string> [-inputObject <psobject>] [<CommonParameters>]

 

详细描述

将管道输入的对象保存在文件或变量中, 同时将该对象沿着管道继续传递.

 

需要指定FilePath参数来讲输入的对象保存到文件中. 这些将被保存在文件中的对象使用默认的格式器(formatter)进行处理.

 

通过Variable参数可以指定将输入对象存储到变量的变量名称(译者注: 原文此处说明了引用, 但是根据本人实验, 此处值得推敲. ).

 

参数

 

-inputObject <psobject>

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

 

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

 

-filePath <string>

指定此cmdlet存储对象使用的文件. 允许使用通配符, 但是通配符被替换后, 不允许产生多个文件.

 

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

 

-variable <string>

指定将存储对象的变量名称.

 

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

 

<公共参数>

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

 

输入类型

任意对象

 

返回类型

对象

 

注意

 

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

 

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

 

使用Tee-Object的FilePath参数操作等价于如下脚本块: {$_ | out-file FilePath }.

 

例1

 

C:/PS>get-process | tee-object -filepath C:/Test1/testfile2.txt

 

此命令获得在计算机上运行的进程列表, 并存储到文件中. (译者注: 此处还有一句: Since there is no second path listed, the result will be displayed in the console. –filepath参数不接受数组, 也不允许指定多个文件, 故本人认为可能是帮助文件内容有误.)

 

Handles  NPM(K)PM(K)  WS(K) VM(M)   CPU(s) Id   ProcessName

-------  -----------  ----- -----   ------ --   -----------

83       4            2300  452039  0.30   4032 Hotkey

272      6            1400  394434  0.06   3088 alg

81       3            804   328421  2.45   148  ApntEx

81       4            2008  580838  0.75   3684 Apoint

...

 

例2

 

C:/PS>get-process notepad | tee-object -variable proc |

select-object processname,handles

 

此命令获得在计算机上运行的notepad进程列表, 并将结果保存到名叫proc的变量中. Tee-object将结果沿着管道传递给Select-Object, 此命令只选取Processname和handles信息. 注意变量$proc包含的是Get-Process返回的默认信息.

 

ProcessName  Handles

-----------  -------

notepad      43

notepad      37

notepad      38

notepad      38

 

相关链接

Write-Output

Out-File