about_Redirection
トピック
about_Redirection
簡易説明
出力を Windows PowerShell からテキスト ファイルにリダイレクトする方法について説明します。
詳細説明
既定では、Windows PowerShell のコマンド出力は Windows PowerShell コンソールに送信されます。た
だし、出力をテキスト ファイルに送信することも、エラー出力を通常の出力ストリームにリダイレク
トすることもできます。
次の方法で出力をリダイレクトできます。
- Out-File コマンドレットを使用し、コマンド出力をテキスト ファイルに送信する。通常、
Out-File コマンドレットは、そのパラメーター (Encoding、Force、Width、NoClobber など) を
使用する必要がある場合に使用します。
- Tee-Object コマンドレットを使用する。このコマンドレットは、コマンド出力をテキスト
ファイルに送信し、その後でパイプラインに送信します。
- Windows PowerShell のリダイレクト演算子を使用する。
Windows PowerShell のリダイレクト演算子は、次のとおりです。
演算子 説明 例
-------- ---------------------- ------------------------------
> 指定したファイルに出力を get-process > process.txt
送信します。
>> 指定したファイルの内容に dir *.ps1 >> scripts.txt
出力を追加します。
2> 指定したファイルにエラー get-process none 2> errors.txt
を送信します。
2>> 指定したファイルの内容に get-process none 2>> save-errors.txt
エラーを追加します。
2>&1 正常な出力ストリームにエ get-process none, powershell 2>&1
ラーを送信します。
リダイレクト演算子の構文は次のとおりです。
<input> <operator> [<path>\]<file>
指定したファイルが既に存在する場合、データを追加しないリダイレクト演算子 (> および 2>) を使
用すると、ファイルの現在の内容が警告なしに上書きされます。ただし、ファイルが読み取り専用ファ
イル、非表示のファイル、システム ファイルのいずれかの場合、リダイレクトは失敗します。追加リ
ダイレクト演算子 (>> および 2>>) を使用した場合、読み取り専用ファイルには書き込みは行われま
せんが、システム ファイルと非表示のファイルには内容が追加されます。
読み取り専用ファイル、非表示のファイル、またはシステム ファイルに対し、内容のリダイレクトを
強制的に行うには、Out-File コマンドレットとその Force パラメーターを使用します。リダイレクト
演算子は、ファイルへの書き込み時に Unicode エンコードを使用します。ファイルのエンコードが異
なる場合、出力が適切にフォーマットされないことがあります。内容を非 Unicode ファイルにリ
ダイレクトするには、Out-File コマンドレットとその Encoding パラメーターを使用します。
関連項目
Out-File
Tee-Object
about_Operators
about_Command_Syntax
about_Path_Syntax