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 Out-File ，cmdlet 会将列表保存在 中 NewSystemFiles.txt file。
示例 4：将输出打印到控制台并在管道中使用
此示例获取文件夹中的文件，将其打印到控制台，然后筛选具有定义的前端元数据块的文件。 最后，它列出了具有前题的文章的名称。
$consoleDevice = if ($IsWindows) {
'\\.\CON'
} else {
'/dev/tty'
$frontMatterPattern = '(?s)^---(?<FrontMatter>.+)---'
$articles = Get-ChildItem -Path .\reference\7.4\PSReadLine\About\ |
Tee-Object -FilePath $consoleDevice |
Where-Object {
(Get-Content $_ -Raw) -match $frontMatterPattern
$articles.Name
Directory: C:\code\docs\PowerShell-Docs\reference\7.4\PSReadLine\About
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 12/13/2022 11:37 AM 384 .markdownlint.yaml
-a--- 4/25/2023 11:28 AM 40194 about_PSReadLine_Functions.md
-a--- 4/25/2023 10:58 AM 10064 about_PSReadLine.md
about_PSReadLine_Functions.md
about_PSReadLine.md
该示例将 $consoleDevice 变量设置为当前终端的控制台设备的值。 在 Windows 上，可以通过将输出重定向到文件路径来 \\.\CON 写入当前控制台设备。 在非 Windows 系统上，使用 /dev/tty 文件路径。
然后，它将变量设置为 $frontMatterPattern 正则表达式，该正则表达式与字符串以三个短划线开头时匹配， --- () ，并在另外三个短划线之前包含任何内容。 当此模式与文章的内容匹配时，文章具有定义的前端元数据块。
接下来，该示例使用 Get-ChildItem 检索 文件夹中的每个文件 About 。 Tee-Object 使用 FileName 参数将管道结果打印到控制台。 Where-Object 通过使用 Raw 参数 Get-Content 将文件的内容作为单个字符串获取，并将该字符串与 $frontMatterPattern进行比较来筛选文件。
最后，该示例打印文件夹中具有定义的前端元数据块的文件的名称。
-Append
指示 cmdlet 将输出追加到指定的文件。 在没有此参数的情况下，新内容将替换文件中的所有现有内容，而不显示警告。
已在 Windows PowerShell 3.0 中引入了此参数。
Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Encoding
指定目标文件的编码类型。 默认值是 utf8NoBOM。
此参数的可接受值如下所示：
ascii：使用 ASCII (7 位) 字符集的编码。
bigendianunicode：使用 big-endian 字节顺序以 UTF-16 格式进行编码。
oem：使用 MS-DOS 和控制台程序的默认编码。
unicode：使用 little-endian 字节顺序以 UTF-16 格式进行编码。
utf7：以 UTF-7 格式进行编码。
utf8：以 UTF-8 格式进行编码。
utf8BOM：使用字节顺序标记 (BOM) 以 UTF-8 格式进行编码
utf8NoBOM：以 UTF-8 格式编码，不带字节顺序标记 (BOM)
utf32：以 UTF-32 格式进行编码。
从 PowerShell 6.2 开始， Encoding 参数还允许使用已注册代码页的数字 ID (如 -Encoding 1251) 或已注册代码页的字符串名称 () -Encoding "windows-1251" 。 有关详细信息，请参阅 Encoding.CodePage 的 .NET 文档。
此参数是在 PowerShell 7.2 中引入的。
不再建议使用 UTF-7*。 从 PowerShell 7.1 起，如果为 Encoding 参数指定utf7，则会写入警告。
Type:Encoding
Accepted values:ASCII, BigEndianUnicode, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:1
Default value:UTF8NoBOM
Accept pipeline input:False
Accept wildcard characters:False
-FilePath
指定允许此 cmdlet 将对象保存到通配符但必须解析为单个文件的文件。
从 PowerShell 7 开始，在 Windows 或/dev/tty非 Windows 系统上将 FilePath 指定为 \\.\CON 时，将在控制台中打印 InputObject。 这些文件路径对应于系统上的当前终端的控制台设备，使你能够打印 InputObject ，并使用一个命令将其发送到输出流。
Type:String
Aliases:Path
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:True
-InputObject
指定要保存和显示的对象。 输入一个包含对象的变量，或键入可获取对象的命令或表达式。 还可以通过管道将对象传递给 Tee-Object。
如果将 InputObject 参数与 一起使用 Tee-Object，而不是将命令结果传递给 Tee-Object，则即使该值是集合， InputObject 值也会被视为单个对象。
Type:PSObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-LiteralPath
指定此 cmdlet 将对象保存到的文件。 与 FilePath 不同，LiteralPath 参数的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符，请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Variable
指定 cmdlet 将对象保存到的变量。 输入不带前面美元符号的变量名称 ($) 。
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
PSObject
可以通过管道将对象传递给此 cmdlet。
PSObject
此 cmdlet 返回它重定向的对象。
PowerShell 包含以下别名 Tee-Object：
Windows：
