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：将进程输出到文件和控制台

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，后者将列表保存在 NewSystemFiles.txt 文件中。

参数

-Append

指示 cmdlet 将输出追加到指定的文件。在没有此参数的情况下，新内容将替换文件中的所有现有内容，而不显示警告。

已在 Windows PowerShell 3.0 中引入了此参数。

Type:	SwitchParameter
Position:	Named
Default value:	None
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 一起使用时，而不是将命令结果传递给 Tee-Object，而是 将 InputObject 值（即使该值是命令结果的集合，如 InputObject (Get-Process)-）视为单个对象。由于 InputObject 无法从数组或对象的集合返回单个属性，因此建议如果使用 Tee-Object 对定义属性中具有特定值的对象的集合执行操作，请在管道中使用 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

可以通过管道将对象传递给 Tee-Object。

输出