共用方式為

Tee-Object

  • 參考
模組:
Microsoft.PowerShell.Utility

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

語法

Tee-Object
   [-InputObject <PSObject>]
   [-FilePath] <String>
   [-Append]
   [<CommonParameters>]
Tee-Object
   [-InputObject <PSObject>]
   -LiteralPath <String>
   [<CommonParameters>]
Tee-Object
   [-InputObject <PSObject>]
   -Variable <String>
   [<CommonParameters>]

Description

Tee-Object Cmdlet 會重新導向輸出，也就是說，它會以兩個方向傳送命令的輸出（例如字母 T）。 它會將輸出儲存在檔案或變數中，並將輸出傳送至管線。 如果 Tee-Object 是管線中的最後一個命令，則會在提示字元中顯示命令輸出。

範例

範例 1：將進程輸出至檔案和控制台

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

PS C:\> 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 傳回的預設資訊。

範例 3：將系統檔案輸出至兩個記錄檔

PS C:\> 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 檔案中。

參數

-Append

表示 Cmdlet 會將輸出附加至指定的檔案。 如果沒有此參數，新內容會取代檔案中任何現有的內容，而不會發出警告。

此參數是在 Windows PowerShell 3.0 中引進的。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-FilePath

指定允許此 Cmdlet 將物件儲存到通配符的檔案，但必須解析為單一檔案。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:True

-InputObject

指定要儲存和顯示的物件。 輸入包含 物件的變數，或輸入取得物件的命令或表達式。 您也可以使用管線將物件傳送至 Tee-Object。

當您搭配 Tee-Object使用 InputObject 參數時，即使值是命令的結果，Tee-Object，InputObject 值，即使值是命令的結果，例如 InputObject (Get-Process)-會視為單一物件。 由於 InputObject 無法從物件的陣列或集合傳回個別屬性，因此建議您使用 Tee-Object，針對定義屬性中具有特定值的物件集合執行作業，您可以在管線中使用 Tee-Object，如本主題中的範例所示。

類型:PSObject
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-LiteralPath

指定這個 Cmdlet 儲存物件的目標檔案。 與 filePath不同，LiteralPath 參數的值會與類型完全相同。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元，請以單引弧括住它。 單引號會告知PowerShell不要將任何字元解譯為逸出序列。

類型:String
別名:PSPath
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Variable

指定 Cmdlet 將 物件儲存至的變數。 輸入不含前一個貨幣符號的變數名稱（$）。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

輸入

PSObject

您可以使用管線將物件傳送至 Tee-Object。

輸出

PSObject

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

備註

  • 您也可以使用 Out-File Cmdlet 或重新導向運算符，這兩者都會將輸出儲存在檔案中，但不會將輸出傳送至管線。
  • Tee-Object 寫入檔案時會使用 Unicode 編碼。 因此，輸出可能無法以不同的編碼方式在檔案中正確格式化。 若要指定編碼方式，請使用 Out-File Cmdlet。