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>]

説明

Tee-Object コマンドレットは、出力をリダイレクトします。つまり、コマンドの出力を 2 つの方向 (文字 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 番目のパスが指定されていないため、プロセスもコンソールに表示されます。

例 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: システムファイルを 2 つのログファイルに出力する

PS C:\> Get-ChildItem -Path D: -File -System -Recurse | Tee-Object -FilePath "c:\test\AllSystemFiles.txt" -Append | Out-File c:\test\NewSystemFiles.txt

このコマンドは、システム・ファイルのリストを 2 つのログ・ファイル (累積ファイルと現行ファイル) に保存します。

このコマンドでは、Get-ChildItem コマンドレットを使用して、D: ドライブ上のシステムファイルを再帰的に検索します。パイプライン演算子 (|) はリストを Tee-Object に送信し、Tee-Object はリストを AllSystemFiles.txt ファイルに追加し、リストをパイプラインの Out-File コマンドレットに渡します。これにより、リストは NewSystemFiles.txt ファイルに保存されます。

パラメーター

-Append

コマンドレットが指定したファイルに出力を追加することを示します。このパラメーターを指定しない場合、新しいコンテンツは警告なしでファイル内の既存のコンテンツを置き換えます。

このパラメーターは、Windows PowerShell 3.0 で導入されました。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FilePath

このコマンドレットでオブジェクトをワイルドカード文字に保存するファイルを指定しますが、1 つのファイルに解決する必要があります。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	True

-InputObject

保存して表示するオブジェクトを指定します。オブジェクトを含む変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。また、オブジェクトを Tee-Object にパイプすることもできます。

InputObject パラメータを Tee-Object と共に使用すると、コマンドの結果を Tee-Object にパイプ処理する代わりに、InputObject 値 (値が ID などのコマンドの結果であるコレクションであっても) InputObject (Get-Process) 1 つのオブジェクトとして扱われます。 InputObject は配列またはオブジェクトのコレクションから個々のプロパティを返すことができないため、Tee-Object を使用して、定義されたプロパティに特定の値を持つオブジェクトのオブジェクトのコレクションに対して操作を実行する場合は、このトピックの例に示すように、パイプラインで Tee-Object を使用することをお勧めします。

型:	PSObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-LiteralPath

このコマンドレットでオブジェクトを保存するファイルを指定します。 FilePathとは異なり、LiteralPath パラメーターの値は、型指定されたとおりに使用されます。ワイルドカードとして解釈される文字はありません。パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。単一引用符は、エスケープシーケンスとして文字を解釈しないように PowerShell に指示します。

型:	String
Aliases:	PSPath
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Variable

コマンドレットがオブジェクトを保存する変数を指定します。変数名を先頭にドル記号 ($) を付けずに入力します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

PSObject

オブジェクトを T オブジェクトにパイプできます。

出力