Tee-Object
將命令輸出儲存在檔案或變數中，並將它傳送至管線。
語法
Tee-Object
[-InputObject <PSObject>]
[-FilePath] <String>
[-Append]
[[-Encoding] <Encoding>]
[<CommonParameters>]Tee-Object
[-InputObject <PSObject>]
-LiteralPath <String>
[[-Encoding] <Encoding>]
[<CommonParameters>]Tee-Object
[-InputObject <PSObject>]
-Variable <String>
[<CommonParameters>]Description
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 和 句柄 屬性。 請注意，$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中。
範例 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 filepath。
然後，它會將 $frontMatterPattern 變數設定為正則表示式，該正則表示式會在字串以三個破折號 （---） 開頭時相符，並在另外三個破折號之前有任何內容。 當此模式符合發行項的內容時，發行項具有定義的前端元數據區塊。
接下來，此範例會使用 Get-ChildItem 來擷取 About 資料夾中的每個檔案。
Tee-Object 使用 fileName 參數，將管線結果列印至控制台。
Where-Object 以單一字串的形式取得其內容，並使用 的 Get-Content 參數，並將該字串與 $frontMatterPattern進行比較，以篩選檔案。
最後，此範例會列印資料夾中已定義前端元數據區塊的檔名。
參數
-Append
表示 Cmdlet 會將輸出附加至指定的檔案。 如果沒有此參數，新內容會取代檔案中任何現有的內容，而不會發出警告。
此參數是在 Windows PowerShell 3.0 中引進的。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Encoding
指定目標檔案的編碼類型。 預設值為 utf8NoBOM。
此參數可接受的值如下：
-
ascii：使用 ASCII （7 位） 字元集的編碼方式。 -
ansi：針對目前文化特性的 ANSI 代碼頁，使用 的編碼方式。 此選項已在PowerShell 7.4中新增。 -
bigendianunicode：使用 big-endian 位元組順序以 UTF-16 格式編碼。 -
oem：使用 MS-DOS 和控制台程序的預設編碼方式。 -
unicode：使用位元組順序以UTF-16格式編碼。 -
utf7：以UTF-7格式編碼。 -
utf8：以UTF-8格式編碼。 -
utf8BOM：使用位元組順序標記以 UTF-8 格式編碼（BOM） -
utf8NoBOM：以 UTF-8 格式編碼，不含位元組順序標記 （BOM） -
utf32：以UTF-32格式編碼。
從 PowerShell 6.2 開始，編碼 參數也允許已註冊代碼頁的數值識別元（例如 -Encoding 1251）或已註冊代碼頁的字串名稱（例如 -Encoding "windows-1251"）。 如需詳細資訊，請參閱 Encoding.CodePage的 .NET 檔。
從 PowerShell 7.4 開始，您可以使用 Ansi 參數的 值，傳遞目前文化特性 ANSI 代碼頁的數值標識符，而不需要手動指定。
此參數是在 PowerShell 7.2 中引進的。
注意
UTF-7* 不再建議使用。 自 PowerShell 7.1 起，如果您為 utf7 參數指定 ，則會撰寫警告。
| 類型: | Encoding |
| 接受的值: | ASCII, BigEndianUnicode, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | 1 |
| 預設值: | UTF8NoBOM |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FilePath
指定允許此 Cmdlet 將物件儲存到通配符的檔案，但必須解析為單一檔案。
從 PowerShell 7 開始，當您在 Windows 或非 Windows 系統上將 FilePath 指定為 \\.\CON/dev/tty，InputObject 會列印在控制台中。 這些檔案路徑會對應到系統上目前終端機的控制台裝置，讓您列印 InputObject，並使用一個命令將它傳送至輸出數據流。
| 類型: | String |
| 別名: | Path |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-InputObject
指定要儲存和顯示的物件。 輸入包含 物件的變數，或輸入取得物件的命令或表達式。 您也可以使用管線將 物件傳送至 Tee-Object。
當您搭配 使用 Tee-Object 參數時，Tee-Object即使值是集合，InputObject 值也會被視為單一物件。
| 類型: | PSObject |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-LiteralPath
指定這個 Cmdlet 儲存物件的目標檔案。 與 filePath 不同，LiteralPath 參數的值會與類型完全相同。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元，請以單引弧括住它。 單引號會告知PowerShell不要將任何字元解譯為逸出序列。
| 類型: | String |
| 別名: | PSPath, LP |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Variable
指定 Cmdlet 將 物件儲存至的變數。 輸入不含上述貨幣符號的變數名稱（$）。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
您可以使用管線將物件傳送至此 Cmdlet。
輸出
此 Cmdlet 會傳回其重新導向的物件。
備註
PowerShell 包含下列 Tee-Object別名：
- 窗戶：
tee
您也可以使用 Out-File Cmdlet 或重新導向運算符，這兩者都會將輸出儲存在檔案中，但不會將輸出傳送至管線。
從 PowerShell 6 開始，Tee-Object 寫入檔案時，會使用無 BOM 的 UTF-8 編碼。 如果您需要不同的編碼方式，請使用 Out-File Cmdlet 搭配 Encoding 參數。
