Tee-Object
将命令输出保存在文件或变量中，并将其发送到管道。
语法
File （默认值）
Tee-Object
[-FilePath] <String>
[-InputObject <PSObject>]
[-Append]
[<CommonParameters>]
LiteralFile
Tee-Object
-LiteralPath <String>
[-InputObject <PSObject>]
[<CommonParameters>]
Variable
Tee-Object
-Variable <String>
[-InputObject <PSObject>]
[<CommonParameters>]
说明
Tee-Object cmdlet 将重定向输出，即，它会以两个方向（如字母 T）发送命令的输出。 它将输出存储在文件或变量中，并将其发送到管道。 如果 Tee-Object 是管道中的最后一个命令，则会在提示符处显示命令输出。
示例
示例 1：将进程输出到文件和控制台
PS C:\> 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
PS C:\> Get-Process notepad | Tee-Object -Variable proc | Select-Object processname,handles
ProcessName Handles
----------- -------
notepad 43
notepad 37
notepad 38
notepad 38
此命令获取计算机上运行的进程的列表，并将结果发送到名为 proc 的变量。 然后，它将生成的对象通过管道传递给 Select-Object，后者选择 ProcessName 和 Handles 属性。 请注意，$proc变量包括 Get-Process 返回的默认信息。
示例 3：将系统文件输出到两个日志文件
PS C:\> 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 文件中。
参数
-Append
指示 cmdlet 将输出追加到指定的文件中。 如果没有此参数，新内容将替换文件中的任何现有内容，而不会发出警告。
此参数是在 Windows PowerShell 3.0 中引入的。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
File
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FilePath
指定允许此 cmdlet 将对象保存到通配符的文件，但必须解析为单个文件。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
File
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-InputObject
指定要保存和显示的对象。 输入一个包含对象的变量，或键入一个获取对象的命令或表达式。 还可以通过管道将对象传递给 Tee-Object。
将 InputObject 参数与 Tee-Object一起使用时，即使该值是命令的结果（如 -） 被视为单个对象，InputObject 值，也不会将命令结果 InputObject (Get-Process)。
由于 InputObject 无法从数组或对象集合中返回单个属性，因此，如果使用 Tee-Object 对那些在定义属性中具有特定值的对象的集合执行操作，则可以在管道中使用 Tee-Object，如本主题中的示例所示。
参数属性
| 类型: | PSObject |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-LiteralPath
指定此 cmdlet 将对象保存到的文件。 与 FilePath不同，LiteralPath 参数的值被按其键入的形式使用。 不会将任何字符解释为通配符。 如果路径包含转义字符，请将它括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | PSPath |
参数集
LiteralFile
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Variable
指定 cmdlet 将对象保存到的变量。 输入没有上述美元符号的变量名称（$）。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Variable
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
PSObject
可以通过管道将对象传递给 Tee-Object。
输出
PSObject
Tee-Object 返回其重定向的对象。
备注
- 还可以使用 Out-File cmdlet 或重定向运算符，这两者都在文件中保存输出，但不将其发送到管道。
- Tee-Object 写入文件时使用 Unicode 编码。 因此，输出在具有不同编码的文件中可能无法正确设置格式。 若要指定编码，请使用 Out-File cmdlet。