Tee-Object
将命令输出保存在文件或变量中,同时通过管道向下发送。
语法
Tee-Object
[-InputObject <PSObject>]
[-FilePath] <String>
[-Append]
[<CommonParameters>]
Tee-Object
[-InputObject <PSObject>]
-LiteralPath <String>
[<CommonParameters>]
Tee-Object
[-InputObject <PSObject>]
-Variable <String>
[<CommonParameters>]
说明
cmdlet Tee-Object
重定向输出,即,它向两个方向发送命令的输出, (如字母 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
cmdlet Select-Object
选择 ProcessName 和 Handles 属性。 请注意, $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 文件,并将该列表向下传递到 cmdlet,cmdlet Out-File
会将列表保存在 NewSystemFiles.txt 文件中。
参数
-Append
指示 cmdlet 将输出追加到指定的文件。 在没有此参数的情况下,新内容将替换文件中的所有现有内容,而不显示警告。
已在 Windows PowerShell 3.0 中引入了此参数。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilePath
指定允许此 cmdlet 将对象保存到通配符但必须解析为单个文件的文件。
Type: | String |
Aliases: | Path |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-InputObject
指定要保存和显示的对象。 输入一个包含对象的变量,或键入可获取对象的命令或表达式。 还可以通过管道将对象传递给 Tee-Object
。
如果将 InputObject 参数与 一起使用 Tee-Object
,而不是将命令结果传递给 Tee-Object
,则即使该值是集合, InputObject 值也会被视为单个对象。
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
指定此 cmdlet 将对象保存到的文件。 与 FilePath 不同,LiteralPath 参数的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符,请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
Type: | String |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Variable
指定 cmdlet 将对象保存到的变量。 输入不带前面美元符号的变量名称 ($
) 。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
可以通过管道将对象传递给 Tee-Object
。
输出
Tee-Object
返回它重定向的对象。
备注
还可以使用 Out-File
cmdlet 或重定向运算符,这两者将输出保存在文件中,但不会在管道中发送输出。
从 PowerShell 6 开始, Tee-Object
在写入文件时使用无 BOM UTF-8 编码。 如果需要其他编码,请使用 Out-File
具有 Encoding 参数的 cmdlet。