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