Tee-Object
將命令輸出儲存在檔案或變數中，並將它傳送至管線。
語法
File (預設值)
Tee-Object
[-FilePath] <String>
[-InputObject <PSObject>]
[-Append]
[<CommonParameters>]
LiteralFile
Tee-Object
-LiteralPath <String>
[-InputObject <PSObject>]
[<CommonParameters>]
Variable
Tee-Object
-Variable <String>
[-InputObject <PSObject>]
[<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中。
參數
-Append
表示 Cmdlet 會將輸出附加至指定的檔案。 如果沒有此參數，新內容會取代檔案中任何現有的內容，而不會發出警告。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
File
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FilePath
指定允許此 Cmdlet 將物件儲存到通配符的檔案，但必須解析為單一檔案。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
| 別名: | 路徑 |
參數集
File
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InputObject
指定要儲存和顯示的物件。 輸入包含 物件的變數，或輸入取得物件的命令或表達式。 您也可以使用管線將 物件傳送至 Tee-Object。
當您搭配 使用 Tee-Object 參數時，Tee-Object即使值是集合，InputObject 值也會被視為單一物件。
參數屬性
| 類型: | PSObject |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LiteralPath
指定這個 Cmdlet 儲存物件的目標檔案。 與 FilePath不同，LiteralPath 參數的值會被完全按其鍵入方式使用。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元，請以單引弧括住它。 單引號會告知PowerShell不要將任何字元解譯為逸出序列。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | PSPath, LP |
參數集
LiteralFile
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Variable
指定 Cmdlet 將 物件儲存至的變數。 輸入不含上述貨幣符號的變數名稱（$）。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Variable
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
PSObject
您可以使用管線將物件傳送至 Tee-Object。
輸出
PSObject
Tee-Object 返回它重定向的物件。
備註
您也可以使用 Out-File Cmdlet 或重新導向運算符，這兩者都會將輸出儲存在檔案中，但不會將輸出傳送至管線。
從 PowerShell 6 開始，Tee-Object 寫入檔案時，會使用無 BOM 的 UTF-8 編碼。 如果您需要不同的編碼方式，請使用 Out-File Cmdlet 搭配 Encoding 參數。