Tee-Object
將命令輸出儲存至檔案或變數,同時將它透過管線傳送。
Syntax
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
Cmdlet 會 Tee-Object
重新導向輸出,也就是說,它會以兩個方向傳送命令的輸出 (,例如字母 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
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 檔案,並將清單向下傳遞至 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
使用 的Raw 參數 Get-Content
取得其內容作為單一字串,並將該字串與 $frontMatterPattern
比較,以篩選檔案。
最後,此範例會列印資料夾中已定義前端元數據區塊的檔名。
參數
-Append
表示 Cmdlet 會將輸出附加至指定的檔案。 如果沒有這個參數,新內容會取代檔案中的任何現有內容而不會發出警告。
此參數是在 Windows PowerShell 3.0 引進。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encoding
指定目標檔案的編碼類型。 預設值是 utf8NoBOM
。
此參數可接受的值如下所示:
ascii
:使用 ASCII (7 位) 字元集的編碼方式。bigendianunicode
:使用大位元組位元組順序以UTF-16格式編碼。oem
:使用 MS-DOS 和控制台程式的預設編碼方式。unicode
:使用小位元節順序以UTF-16格式編碼。utf7
:以 UTF-7 格式編碼。utf8
:以 UTF-8 格式編碼。utf8BOM
:使用位元節順序標記 (BOM) ,以 UTF-8 格式編碼utf8NoBOM
:以 UTF-8 格式編碼,不含位元組順序標記 (BOM)utf32
:以 UTF-32 格式編碼。
從 PowerShell 6.2 開始, Encoding 參數也允許已註冊代碼頁的數值標識符, (例如 -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 |
Required: | False |
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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-InputObject
指定要儲存和顯示的物件。 輸入包含物件的變數,或輸入可取得物件的命令或運算式。 您也可以使用管線將 物件傳送至 Tee-Object
。
當您搭配 使用 InputObject 參數搭配 Tee-Object
時,即使值為集合,也不會將 InputObject 值視為單一物件,而不是管線命令結果Tee-Object
。
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
指定這個 Cmdlet 將物件儲存至的檔案。 LiteralPath 參數值與 FilePath 不同,會完全依照其輸入值來使用。 沒有字元會被視為萬用字元。 如果路徑包含逸出字元,請將它括在單引號中。 單引號會告訴PowerShell不要將任何字元解譯為逸出序列。
Type: | String |
Aliases: | PSPath, LP |
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 |
輸入
您可以使用管線將物件傳送至此 Cmdlet。
輸出
此 Cmdlet 會傳回其重新導向的物件。
備註
PowerShell 包含下列的 Tee-Object
別名:
- Windows:
tee
您也可以使用 Out-File
Cmdlet 或重新導向運算元,這兩者都會將輸出儲存在檔案中,但不要將其傳送至管線。
從 PowerShell 6 開始, Tee-Object
它會在寫入檔案時使用無 BOM 的 UTF-8 編碼。 如果您需要不同的編碼方式,請使用 Out-File
Cmdlet 搭配 Encoding 參數。