Tee-Object
ファイルまたは変数にコマンドの出力を保存し、またそれをパイプラインに送信します。
構文
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-Object
AllSystemFiles.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 |
入力
このコマンドレットにオブジェクトをパイプできます。
出力
このコマンドレットは、リダイレクトするオブジェクトを返します。
メモ
Windows PowerShell には、次のエイリアスが Tee-Object
含まれています。
tee
コマンドレットまたはリダイレクト演算子を Out-File
使用することもできます。どちらも出力をファイルに保存しますが、パイプラインには送信しません。
Tee-Object
では、ファイルへの書き込み時に "Unicode" (UTF-16LE) エンコードが使用されます。 別のエンコードが必要な場合は、Encoding パラメーターを指定してOut-File
コマンドレットを使用します。
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示