Tee-Object 帮助信息_tee-obiect-优快云博客

如下说明是翻译: 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