Tee-Object

参考

模块:: Microsoft.PowerShell.Utility

将命令输出保存在文件或变量中，并将其发送到管道。

语法

Tee-Object
   [-InputObject <PSObject>]
   [-FilePath] <String>
   [-Append]
   [<CommonParameters>]

Tee-Object
   [-InputObject <PSObject>]
   -LiteralPath <String>
   [<CommonParameters>]

Tee-Object
   [-InputObject <PSObject>]
   -Variable <String>
   [<CommonParameters>]

说明

Tee-Object cmdlet 将重定向输出，也就是说，它会以两个方向（如字母 T）发送命令的输出。它将输出存储在文件或变量中，并将其发送到管道。如果 Tee-Object 是管道中的最后一个命令，则会在提示符处显示命令输出。

示例

示例 1：将进程输出到文件和控制台

此示例获取计算机上运行的进程列表，并将结果发送到文件。由于未指定第二个路径，因此进程也会显示在控制台中。

Get-Process | Tee-Object -FilePath "C:\Test1\testfile2.txt"

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)    Id ProcessName
-------  ------    -----      ----- -----   ------    -- -----------
83       4     2300       4520    39     0.30    4032 00THotkey
272      6     1400       3944    34     0.06    3088 alg
81       3      804       3284    21     2.45     148 ApntEx
81       4     2008       5808    38     0.75    3684 Apoint
...

示例 2：将进程输出到变量和“Select-Object”

此示例获取计算机上运行的进程的列表，将其保存到 $proc 变量，并通过管道将其传递给 Select-Object。

Get-Process notepad | Tee-Object -Variable proc | Select-Object ProcessName, Handles

ProcessName                              Handles
-----------                              -------
notepad                                  43
notepad                                  37
notepad                                  38
notepad                                  38

Select-Object cmdlet 选择 ProcessName，并句柄属性。请注意，$proc 变量包括 Get-Process返回的默认信息。

示例 3：将系统文件输出到两个日志文件

本示例将系统文件的列表保存在两个日志文件中，一个累积文件和一个当前文件。

Get-ChildItem -Path D: -File -System -Recurse |
  Tee-Object -FilePath "C:\test\AllSystemFiles.txt" -Append |
    Out-File C:\test\NewSystemFiles.txt

该命令使用 Get-ChildItem cmdlet 对 D：驱动器上的系统文件执行递归搜索。管道运算符（|）将列表发送到 Tee-Object，该列表将列表追加到 AllSystemFiles.txt 文件中，并将该列表向下传递到 Out-File cmdlet，该 cmdlet 将列表保存在 NewSystemFiles.txt file中。

参数

-Append

指示 cmdlet 将输出追加到指定的文件中。如果没有此参数，新内容将替换文件中的任何现有内容，而不会发出警告。

此参数是在 Windows PowerShell 3.0 中引入的。

类型:	SwitchParameter
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-FilePath

指定允许此 cmdlet 将对象保存到通配符的文件，但必须解析为单个文件。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	True

-InputObject

指定要保存和显示的对象。输入包含对象或键入获取对象的命令或表达式的变量。还可以通过管道将对象传递给 Tee-Object。

将 InputObject 参数用于 Tee-Object时，即使该值为集合，Tee-Object 值也会被视为单个对象，而不是将命令结果。

类型:	PSObject
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-LiteralPath

指定此 cmdlet 将对象保存到的文件。与 FilePath不同，LiteralPath 参数的值与键入时完全相同。不会将任何字符解释为通配符。如果路径包含转义字符，请将它括在单引号中。单引号告知 PowerShell 不要将任何字符解释为转义序列。

类型:	String
别名:	PSPath
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Variable

指定 cmdlet 将对象保存到的变量。输入没有上述美元符号的变量名称（$）。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

输入

PSObject

可以通过管道将对象传递给此 cmdlet。

输出

PSObject

此 cmdlet 返回它重定向的对象。

备注

Windows PowerShell 包含以下 Tee-Object别名：

tee

还可以使用 Out-File cmdlet 或重定向运算符，这两者都在文件中保存输出，但不将其发送到管道。

Tee-Object 写入文件时使用“Unicode”（UTF-16LE）编码。如果需要其他编码，请使用 Out-File cmdlet 和 Encoding 参数。

通过