PowerShellでファイルの書き込み・追記を行う方法

PowerShellを使ってファイルの書き込みや追記を行う方法は、スクリプトの自動化やログの管理など、多くの場面で活用されます。本記事では、PowerShellを用いた基本的なファイル書き込み・追記の方法を解説し、具体的なコマンドの使い方を詳しく説明します。PowerShell初心者でも理解しやすいように、実践的なサンプルコードを交えて解説します。

Set-Content コマンドでファイルに書き込む

PowerShellでは、Set-Content コマンドを使用すると、新しいファイルを作成して内容を書き込むことができます。

基本構文

Set-Content -Path "C:\test\sample.txt" -Value "Hello, PowerShell!"

説明

  • -Path:書き込み先のファイルパスを指定。
  • -Value:書き込む内容を指定。

このコマンドを実行すると、C:\test\sample.txt というファイルが作成され、その中に Hello, PowerShell! という内容が書き込まれます。

既存ファイルへの影響

Set-Content を使用すると、既存のファイルの内容が上書きされるため、注意が必要です。

Add-Content コマンドでファイルに追記する

既存のファイルに内容を追加したい場合は、Add-Content を使用します。

基本構文

Add-Content -Path "C:\test\sample.txt" -Value "追加のテキスト"

説明

  • -Path:追記先のファイルパスを指定。
  • -Value:追記する内容を指定。

このコマンドを実行すると、C:\test\sample.txt の末尾に 追加のテキスト が追加されます。

Out-File コマンドでファイルに書き込む

Out-File は、出力をファイルに保存するために使用されるコマンドです。

基本構文

"出力するテキスト" | Out-File -FilePath "C:\test\output.txt"

追記モードでの利用

Out-File には -Append オプションがあり、既存のファイルに追記することができます。

"追記する内容" | Out-File -FilePath "C:\test\output.txt" -Append

>> 演算子を使って追記する

PowerShell では >> 演算子を使用して簡単にファイルへ追記することも可能です。

追記の例

"この行を追加" >> "C:\test\sample.txt"

この方法はシンプルですが、Out-FileAdd-Content のほうが柔軟に使えるため、推奨されることが多いです。

Write-Output を使ってファイルに書き込む

Write-Output を使用すると、データを出力しながらファイルに保存できます。

基本構文

Write-Output "ログの記録" | Out-File "C:\test\log.txt" -Append

この方法を使用すると、コマンドの実行結果やログをファイルに記録する際に便利です。

ファイル操作の応用

複数行を書き込む

$lines = @(
    "1行目",
    "2行目",
    "3行目"
)
$lines | Set-Content -Path "C:\test\multiline.txt"

既存のファイルをクリアしてから書き込む

Clear-Content -Path "C:\test\sample.txt"
Set-Content -Path "C:\test\sample.txt" -Value "新しい内容"

条件付きで追記する

if (!(Test-Path "C:\test\log.txt")) {
    "ログ開始" | Out-File "C:\test\log.txt"
}
"新しいログ" | Out-File "C:\test\log.txt" -Append

まとめ

PowerShellを使ってファイルの書き込みや追記を行う方法は多くあります。

  • Set-Content:ファイルを作成または上書き
  • Add-Content:既存ファイルに追記
  • Out-File:標準出力をファイルに保存
  • >> 演算子:シンプルな追記
  • Write-Output:コマンド出力をファイルに保存

用途に応じて適切な方法を選び、PowerShellのファイル操作を効率的に活用しましょう。

タイトルとURLをコピーしました