共用方式為

Tee-Object

模組:
Microsoft.PowerShell.Utility Module

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

語法

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 會在兩個方向上寫入輸出。 它會將輸出儲存在檔案或變數中，並將輸出傳送至管線。 如果是管線中的最後一個命令，則 Tee-Object 命令輸出會顯示在主控台中。

在內部， Tee-Object 使用 和 Set-VariableOut-File 命令。 這些命令支援 WhatIf 參數。 此 Tee-Object 命令不支援 WhatIf 參數。 不過，如果您包裝 Tee-Object 在支援 WhatIf 參數的腳本或函式中， Tee-Object 則會將 WhatIf 的狀態傳遞至 和 Set-VariableOut-File 命令。

範例

範例 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中。

範例 4：在具有 **WhatIf** 參數的指令碼中使用 'Tee-Object'

此 Tee-Object 命令不支援 WhatIf 參數。 不過，如果您包裝 Tee-Object 在支援 WhatIf 參數的腳本或函式中， Tee-Object 則會將 WhatIf 的狀態傳遞給 Set-Variable 內部使用的 和 Out-File 命令。

PS> function Test-Tee {
    [Cmdletbinding(SupportsShouldProcess)]
    Param()
    $true|tee -Variable b
    "Variable `$b is set to '$b'"
}

PS> Test-Tee

True
Variable $b is set to 'True'

PS> Test-Tee -WhatIf
True
What if: Performing the operation "Set variable" on target "Name: b Value: True".
Variable $b is set to ''

參數

-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

參數集

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

您可以將物件通過管線傳送至此 Cmdlet。

輸出

PSObject

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

備註

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

  • tee

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

Tee-Object 寫入檔案時，會使用 “Unicode” （UTF-16LE） 編碼。 如果您需要不同的編碼方式，請使用 Out-File Cmdlet 搭配 Encoding 參數。