Tee-Object

發行項
10/30/2009

將命令輸出儲存到檔案或變數，然後在主控台中顯示。

語法

Tee-Object [-FilePath] <string> [-InputObject <psobject>] [<CommonParameters>]

Tee-Object -Variable <string> [-InputObject <psobject>] [<CommonParameters>]

描述

Tee-Object Cmdlet 會以兩個方向 (像字母 "T") 傳送命令的輸出。此 Cmdlet 會將輸出儲存到檔案或變數，同時沿著管線向下傳送。如果 Tee-Object 是管線中的最後一個命令，命令輸出則會顯示在主控台中。

參數

-FilePath <string>

指定 cmdlet 用來儲存物件的檔案。接受解析結果為單一檔案的萬用字元。

必要?	true
位置?	1
預設值
接受管線輸入?	false
接受萬用字元?	false

-InputObject <psobject>

指定要對 cmdlet 輸入的物件。請輸入包含物件的變數，或輸入可取得物件的命令或運算式。

必要?	false
位置?	named
預設值
接受管線輸入?	true (ByValue)
接受萬用字元?	false

-Variable <string>

將輸入物件的參照指派給指定的變數。

必要?	true
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Management.Automation.PSObject

您可經由管道將要重新導向的物件輸出至 Tee-Object。

輸出

System.Management.Automation.PSObject

Tee-Object 會傳回它重新導向的物件。

附註

您也可以使用 Out-File Cmdlet 或重新導向運算子，兩者都會將輸出儲存到檔案，但不沿著管線向下傳送。

Tee-Object 在寫入檔案時會使用 Unicode 編碼。因此，不同編碼的檔案可能會造成輸出格式錯誤。若要指定編碼，請使用 Out-File Cmdlet。

範例 1

C:\PS>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

C:\PS>get-process notepad | tee-object -variable proc | select-object processname,handles 

ProcessName                              Handles
-----------                              -------
notepad                                  43
notepad                                  37
notepad                                  38
notepad                                  38

描述
-----------
這個命令會取得電腦中執行之處理序的清單，並將結果傳送到名為 "proc" 的變數。然後，它會經由管道將產生的物件輸出至 Select-Object，後者再接著選取 ProcessName 和 Handles 屬性。請注意，$proc 變數包含 Get-Process 所傳回的預設資訊。

請參閱

概念

about_Redirection
Select-Object

共用方式為