Tee-Object

Tee-Object
    [-FilePath] <String>
    [[-Encoding] <Encoding>]
    [-InputObject <PSObject>]
    [-Append]
    [<CommonParameters>]

Tee-Object
    [[-Encoding] <Encoding>]
    -LiteralPath <String>
    [-InputObject <PSObject>]
    [<CommonParameters>]

Tee-Object
    -Variable <String>
    [-InputObject <PSObject>]
    [<CommonParameters>]

cmdlet Tee-Object 以两个方向写入输出。 它将输出存储在文件或变量中，并将其发送到管道。 如果 Tee-Object 管道中的最后一个命令，则命令输出将显示在控制台中。

在内部， Tee-Object 使用 Set-Variable 和 Out-File 命令。 这些命令支持 WhatIf 参数。 该 Tee-Object 命令不支持 WhatIf 参数。 但是，如果包装 Tee-Object 在支持 WhatIf 参数的脚本或函数中， Tee-Object 请将 WhatIf 的状态传递给 Set-Variable 命令 Out-File 。

此示例获取计算机上运行的进程列表，并将结果发送到文件。 由于未指定第二个路径，因此进程也会显示在控制台中。

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

此示例获取计算机上运行的进程的列表，将其保存到 $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，并 句柄 属性。 请注意，$proc 变量包括 Get-Process返回的默认信息。

本示例将系统文件的列表保存在两个日志文件中，一个累积文件和一个当前文件。

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 file中。

本示例获取文件夹中的文件，将其打印到控制台，然后筛选具有定义的前端元数据块的文件。 最后，它列出了具有前线的文章的名称。

$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 通过使用 的 Get-Content 参数获取其内容并将其内容与 $frontMatterPattern进行比较来筛选文件。

最后，该示例打印文件夹中具有定义的前端元数据块的文件的名称。

该 Tee-Object 命令不支持 WhatIf 参数。 但是，如果包装Tee-Object在支持 WhatIf 参数的脚本或函数中，Tee-Object请将 WhatIf 的状态传递给Set-VariableOut-File它在内部使用的命令。

PS> function Test-Tee {
    [Cmdletbinding(SupportsShouldProcess)]
    Param()
    $true|tee -Variable b
    "Variable `$b is set to '$b'"
}

PS> Test-Tee

True
Variable $b is set to 'True'

PS> Test-Tee -WhatIf
True
What if: Performing the operation "Set variable" on target "Name: b Value: True".
Variable $b is set to ''

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

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

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

PowerShell 包含以下与 Tee-Object相关的别名：

• 窗户：
  • tee

还可以使用 Out-File cmdlet 或重定向运算符，这两者都在文件中保存输出，但不将其发送到管道。

从 PowerShell 6 开始，Tee-Object 写入文件时使用无 BOM UTF-8 编码。 如果需要其他编码，请使用 Out-File cmdlet 和 Encoding 参数。