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: 出力プロセスをファイルとコンソールに出力する

この例では、コンピューターで実行されているプロセスの一覧を取得し、結果をファイルに送信します。 2 番目のパスを指定していないため、プロセスはコンソールに表示されます。

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、ProcessName プロパティと Handles プロパティを選択します。 変数には、 $proc によって返される既定の情報が含まれていることに Get-Process注意してください。

例 3: システム ファイルを 2 つのログ ファイルに出力する

次の使用例は、システム ファイルの一覧を、累積ファイルと現在のファイルの 2 つのログ ファイルに保存します。

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

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

パラメーター

-Append

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

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilePath

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

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

コマンドの結果Tee-Objectをパイプ処理する代わりに InputObject パラメーターをTee-Object使用すると、値がコレクションであっても、InputObject 値は 1 つのオブジェクトとして扱われます。

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

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

Type:String
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Variable

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

入力

PSObject

このコマンドレットにオブジェクトをパイプできます。

出力

PSObject

このコマンドレットは、リダイレクトするオブジェクトを返します。

メモ

Windows PowerShell には、次のエイリアスが Tee-Object含まれています。

  • tee

コマンドレットまたはリダイレクト演算子を Out-File 使用することもできます。どちらも出力をファイルに保存しますが、パイプラインには送信しません。

Tee-Object では、ファイルへの書き込み時に "Unicode" (UTF-16LE) エンコードが使用されます。 別のエンコードが必要な場合は、Encoding パラメーターを指定してOut-Fileコマンドレットを使用します。