Tee-Object

  • 參考
模組:
Microsoft.PowerShell.Utility

將命令輸出儲存在檔案或變數中，並將它傳送至管線。

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，此 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 filepath，以寫入目前的控制台裝置。 在非 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：使用 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 參數也允許已註冊代碼頁的數值識別元（例如 -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 儲存物件的目標檔案。 與 FilePath 不同，LiteralPath 參數的值會與輸入時完全相同。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元，請以單引弧括住它。 單引號會告知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

輸入

PSObject

您可以使用管線將物件傳送至此 Cmdlet。

輸出

PSObject

此 Cmdlet 會傳回其重新導向的物件。

備註

PowerShell 包含下列的 Tee-Object別名：

  • Windows：
    • tee

您也可以使用 Out-File Cmdlet 或重新導向運算元，這兩者都會將輸出儲存在檔案中，但不要將輸出傳送至管線。

從 PowerShell 6 開始， Tee-Object 它會在寫入檔案時使用無 BOM UTF-8 編碼。 如果您需要不同的編碼方式，請使用 Out-File Cmdlet 搭配 Encoding 參數。