通过

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 和 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 文件，然后沿管道将该列表向下传递给 Out-File cmdlet，以将其保存在 NewSystemFiles.txt file 中。

参数

-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
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

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

将 InputObject 参数用于 Tee-Object 时，InputObject 值将被视为单个对象，而不是通过管道将命令结果传递给 Tee-Object，即使该值是集合。

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
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

输入

PSObject

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

输出

PSObject

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

备注

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

  • tee

你还可以使用 Out-File cmdlet 或重定向运算符，它们都可以将输出保存在文件中，但不会通过管道向下发送。

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