PowerShellのログが上書きされる、日本語が読めないときは、保存方法と文字コードを確認します。履歴を残す基本は、保存先を用意し、Add-Contentで文字コードを指定して追記する方法です。
失敗したのにcatchへ進まない場合は、エラーの扱いも確認します。この記事では追記・日付分割・エラー記録・保管候補の確認を順に試し、出力から結果を判断する方法を説明します。
必要なのは、Windows PowerShell 5.1を開けるWindows環境と、一時フォルダーへの書込み権限です。説明には5.1 Desktopの実行記録を使い、新しい練習フォルダーだけを操作します。PowerShell 7系の動作は今回の検証に含みません。
先に結論
- 履歴を追加する場合はAdd-Content、内容を置き換える場合はSet-Contentを選びます。
- 日本語のログは書込みと読取りの文字コードをそろえ、続行するエラーをcatchで受け取る場合は対象コマンドへStopを指定します。
- 日付分割・容量制限・保管期限は分けて考えます。整理は候補の一覧確認から始め、ログ自体の保存失敗も確認します。
1.PowerShellの版を確認し、練習フォルダーを作る
新しい専用フォルダーを用意し、同じPowerShell画面で順に実行します。
ログは、いつ何が起きたかを後から確認するための記録です。拡張子が.logでも、中身が文字ならテキストとして読めます。今回は既存の業務ログに触れず、専用の練習ファイルを作ります。
コードの$で始まる名前は、値を入れておく変数です。縦線のパイプは、左のコマンドの結果を右へ渡す記号です。準備コードのOut-Nullは、フォルダーの作成結果を画面へ表示しないために使います。
TEMPは一時保存場所を示す環境変数です。その下に、GUIDという重複を避ける識別子を付けたフォルダー名を作ります。Join-Pathで場所と名前を組み合わせ、New-Itemでフォルダーを作成します。
- スタートメニューで「Windows PowerShell」を検索し、通常権限で開きます。
- 最初のコード欄の2行を実行し、版が5.1系、PSEditionがDesktopか確認します。異なる場合は、本記事の対象環境との差を確認してから進めます。
- 次の「専用の練習フォルダーを作る」のコード欄を、末尾まで実行します。
- 以後のコード欄も、同じ画面で本文の順に1回ずつ、先頭から末尾まで実行します。複数のコード欄がある節では、上の欄から進めます。
再現コード
$PSVersionTable.PSVersion.ToString()
$PSVersionTable.PSEdition
実行結果
5.1.26100.9818
Desktop
専用の練習フォルダーを作る
$logDir = Join-Path $env:TEMP ('ps-log-' + [guid]::NewGuid().ToString('N'))
New-Item -ItemType Directory -Path $logDir -ErrorAction Stop | Out-Null
版確認の実行記録では、5.1.26100.9818とDesktopが表示されています。フォルダー作成は何も表示せずに終わります。赤いエラーが出た場合は先へ進まず、TEMPの保存場所と書込み権限を確認してください。
準備をやり直すと、別の練習フォルダーが作られます。以後は、変数$logDirが指すフォルダー内を操作します。画面を閉じた場合は、準備からやり直します。
2.追記と置換で、残る内容を比べる
Add-Contentは追記し、Set-Contentは既存の内容を置き換えます。
履歴を残したいときにSet-Contentを使うと、それまでの内容が置き換わります。次の例では、新しいcompare.logだけを使って違いを確認します。既存ログの場所へ変更して試さないでください。
-LiteralPathは、角括弧などをファイル名の検索記号として解釈せず、指定した場所をそのまま扱います。-Valueは書く文字、-Encoding UTF8は保存時の文字コードです。-ErrorAction Stopは書込みに失敗したときに処理を止める指定です。
比較表には、追記・置換に加えて読取り方法も載せています。まずこの節で書込み後に残る内容を確かめ、表の後半にある末尾の読取りと検索は第7節で確認します。
| 操作 | 専用検証の結果 | ログでの判断 |
|---|---|---|
| Add-Content | 初回に続いて追記が残る | 履歴を追加する |
| Set-Content | 最後の置換だけが残る | 既存履歴を消すため初期化時に限定 |
| Get-Content -Tail 2 | 末尾のINFOとERRORを表示 | 最近の行を確認する |
| Select-String -SimpleMatch | [ERROR]を含む1行を抽出 | 記号も文字として検索する |
追記と置換を専用ファイルで比較
$comparePath = Join-Path $logDir 'compare.log'
Set-Content -LiteralPath $comparePath -Value '初回' -Encoding UTF8 -ErrorAction Stop
Add-Content -LiteralPath $comparePath -Value '追記' -Encoding UTF8 -ErrorAction Stop
Get-Content -LiteralPath $comparePath -Encoding UTF8
Set-Content -LiteralPath $comparePath -Value '置換' -Encoding UTF8 -ErrorAction Stop
Get-Content -LiteralPath $comparePath -Encoding UTF8
実行結果
初回
追記
置換
最初のGet-Contentでは「初回」「追記」の2行、最後のGet-Contentでは「置換」の1行が表示されます。画面全体では3行ですが、最後にcompare.logへ残るのは「置換」だけです。
置換前の内容は自動では戻りません。元の内容へ戻す必要があるファイルは、変更前に別の場所へバックアップを保存します。
3.日本語を書き込む前に、文字コードをそろえる
新しいログはUTF8指定でそろえ、既存ログへの追記前には元の文字コードを確認します。
文字コードは、文字をファイル内の数値へ対応させる方式です。今回の例では、新しいファイルへの書込みと読取りの両方にUTF8を指定します。追記は既存部分を変換しないため、別の文字コードのログへそのまま追加しないでください。
BOMは、ファイルの先頭で文字コードを示す印です。今回のWindows PowerShell 5.1の記録では、UTF8指定で新規作成したログの先頭がEF-BB-BFでした。これはUTF-8のBOMです。
公式資料では、PowerShell 7系のUTF8指定はBOMなしになります。7系での動作は今回実行していません。利用中の版によって同じ指定の結果が異なる点を、既存ログへ書き込む前に確認します。
コマンドの既定値にも違いがあります。5.1のOut-Fileは既定でUTF-16LEを使い、Add-Contentは既存ファイルのBOMなどによって扱いが変わります。異なる方法の出力を混ぜる前に、書く側と読む側の方式を確認します。
例を.ps1ファイルへ保存して5.1で実行する場合は、日本語を含むスクリプト自体もUTF-8のBOM付きで保存します。スクリプトの文字コードと、そこから書き出すログの文字コードは、それぞれ確認します。
4.日時・重要度・本文をそろえる関数を作る
記録を1行にそろえ、渡された日時の日付ごとにファイルへ追記します。
関数は、繰り返す処理に名前を付けたものです。次のコード欄を同じ画面で実行すると、Write-DemoLogという自作の命令を利用できます。保存先には、第1節で用意した$logDirを使います。
paramは関数が受け取る値の定義です。Levelは重要度、Messageは本文、Atは記録日時を受け取ります。ValidateSetで重要度をINFOかERRORに限定し、INFOを通常の記録、ERRORを失敗の記録に使います。
型は値の種類を表します。stringは文字列、DateTimeOffsetは日時と時差を組にした値です。Atを省略すると、実行端末の現在日時と時差を使います。日本時間へ強制的に変換する処理は含みません。
-fは、文字列内の番号付きの波括弧へ値を当てはめる指定です。yyyyMMddで年・月・日を並べてファイル名を作り、時刻の書式にあるzzzで、+09:00のような時差を付けます。
-replaceは、指定した規則に合う文字を置き換える処理です。この関数では本文の改行を空白にまとめ、1件のメッセージが複数のログ行に見えるのを防ぎます。パスワードや個人情報を自動で除去する機能はありません。
日付と重要度をそろえる自作関数
function Write-DemoLog {
param(
[ValidateSet('INFO', 'ERROR')][string]$Level,
[string]$Message,
[DateTimeOffset]$At = [DateTimeOffset]::Now
)
$name = 'app-{0}.log' -f $At.ToString('yyyyMMdd')
$file = Join-Path $logDir $name
$oneLine = $Message -replace '[\r\n]+', ' '
$line = '{0} [{1}] {2}' -f $At.ToString('yyyy-MM-ddTHH:mm:sszzz'), $Level, $oneLine
Add-Content -LiteralPath $file -Value $line -Encoding UTF8 -ErrorAction Stop
}
このコード欄では関数を登録するだけなので、画面には何も表示されず、ログもまだ増えません。次の節で関数を呼び出すと、Add-Contentによって1行ずつ追記されます。
保存先が存在しない、書込みできないといった場合はエラーで止まります。ログ保存の失敗は第8節で確認します。複数プロセスからの同時書込みや、大量の記録に対応する制御は含んでいません。
5.固定日時で2日分を書き、出力を読み分ける
日付分割の基準は、実行日ではなく関数へ渡した日時の日付です。
ここからの練習では、結果を比較しやすいように固定日時を使います。ログに表示される2026年11月18日・19日は、実行した日時ではありません。後続のエラー記録や保管候補の確認でも、この固定日時を基準にします。
Parseは文字列から日時の値を作る処理です。AddMinutes(1)で1分後、AddDays(1)で1日後の値を渡します。最初の2回は18日分、3回目は19日分として、別々のファイルへ記録されます。
$todayLogは、この練習の18日分を読むための変数です。実行当日を自動で選ぶものではありません。Get-ChildItemでファイルを一覧にし、Sort-Objectで名前順に並べ、Select-Objectでファイル名だけを取り出します。
固定日時で2日分を比較
$demoAt = [DateTimeOffset]::Parse('2026-11-18T09:00:00+09:00')
Write-DemoLog -Level INFO -Message '開始しました' -At $demoAt
Write-DemoLog -Level INFO -Message '確認しました' -At $demoAt.AddMinutes(1)
Write-DemoLog -Level INFO -Message '翌日の練習です' -At $demoAt.AddDays(1)
$todayLog = Join-Path $logDir 'app-20261118.log'
Get-Content -LiteralPath $todayLog -Encoding UTF8
Get-ChildItem -LiteralPath $logDir -Filter 'app-*.log' -File | Sort-Object Name | Select-Object -ExpandProperty Name
実行結果
2026-11-18T09:00:00+09:00 [INFO] 開始しました
2026-11-18T09:01:00+09:00 [INFO] 確認しました
app-20261118.log
app-20261119.log
出力の先頭2行は18日分のログ本文、最後の2行は作成されたファイル名です。19日分の本文は、このコード欄では表示していません。本文の行と一覧の行を分けて読みます。
日付でファイルを分けても、1日に大量の記録があれば1ファイルが大きくなります。日付分割に加えて、容量上限や古いファイルの整理は別に設計します。この例では容量制限も削除も行いません。
6.失敗したのにcatchへ進まない理由を確かめる
続行するエラーをcatchで受け取るには、対象コマンドへStopを指定します。
tryは失敗する可能性のある処理を囲む場所で、catchは終了するエラーを受け取る場所です。ここでいう終了するエラーは、try内の処理を中断してcatchへ移るエラーを指します。
存在しないファイルをGet-Itemで調べる場合、Continueではエラーが出ても先へ進むため、catchには入りません。最初の例は違いを見やすくするため、エラー表示を捨て先へ送って省略しています。業務の失敗を隠す用途には利用しません。
次の例では同じGet-ItemにStopを指定し、catchへ入ったことを記録します。missing.txtは練習フォルダーに作っていないファイルです。catch内の$_が表すエラー全文は個人のパスなどを含み得るため、ログには固定の短い説明だけを書きます。
- 「catchに入らない場合を比較」のコード欄を末尾まで実行し、Continueでの結果を確認します。
- 「Stopを指定して失敗を記録」のコード欄を末尾まで実行します。最後のGet-Contentは、-Tail 1でログの末尾1行を読み戻します。
catchに入らない場合を比較
$caught = $false
try {
Get-Item -LiteralPath (Join-Path $logDir 'missing.txt') -ErrorAction Continue 2>$null
} catch {
$caught = $true
}
"catch=$caught"
実行結果
catch=False
Stopを指定して失敗を記録
$caught = $false
try {
Get-Item -LiteralPath (Join-Path $logDir 'missing.txt') -ErrorAction Stop | Out-Null
} catch {
$caught = $true
Write-DemoLog -Level ERROR -Message '練習用ファイルを確認できませんでした' -At $demoAt.AddMinutes(2)
}
"catch=$caught"
Get-Content -LiteralPath $todayLog -Encoding UTF8 -Tail 1
実行結果
catch=True
2026-11-18T09:02:00+09:00 [ERROR] 練習用ファイルを確認できませんでした
最初の例はcatch=Falseの1行です。Falseはcatchへ入らなかった意味で、ファイル確認の成功を示しません。次の例はcatch=TrueとERRORのログ行が表示され、失敗を受け取って記録できたことを確認できます。
この練習は結果を読むために続行します。自動処理では、catchで記録するだけで失敗終了になるとは限りません。呼出し元へ失敗を伝える方法も別に用意します。
7.末尾の行とERRORを含む行を探す
末尾の確認には-Tail、角括弧を含む文字そのものの検索には-SimpleMatchを使います。
ログ全体を開く代わりに、Get-Contentの-Tail 2で最後の2行を取得できます。続くSelect-Stringは、指定した文字を含む行を探すコマンドです。ここでは[ERROR]という文字そのものを検索します。
正規表現は、文字の並びを条件で表して探す方法です。-SimpleMatchを省くと、角括弧が正規表現の記号として解釈されます。記号もそのまま探す今回の用途では、-SimpleMatchを付けます。
ForEach-Objectは、一致した結果を1件ずつ処理します。ここでの$_は処理中の一致結果、Lineはその行の本文です。行の本文だけを表示するために使い、ファイルの内容は変更しません。
末尾とエラー行を読む
Get-Content -LiteralPath $todayLog -Encoding UTF8 -Tail 2
Select-String -LiteralPath $todayLog -Pattern '[ERROR]' -SimpleMatch -Encoding UTF8 | ForEach-Object { $_.Line }
実行結果
2026-11-18T09:01:00+09:00 [INFO] 確認しました
2026-11-18T09:02:00+09:00 [ERROR] 練習用ファイルを確認できませんでした
2026-11-18T09:02:00+09:00 [ERROR] 練習用ファイルを確認できませんでした
出力の最初の2行はログの末尾、3行目は検索結果です。ERROR行が2回表示されるのは、同じ行を2つの読取り方法で表示したためです。ログへ同じ失敗を2回書いたわけではありません。
ERROR行が見つからないだけで、処理が成功したとは判断できません。予定していた完了記録があるか、実際の成果物ができているかも確認します。
8.ログ自体を書き込めない場合を確認する
処理のエラーを受け取ることと、その記録を保存できることは分けて確認します。
処理の失敗をcatchで受け取れても、ログを書けなければ記録は残りません。次の例では、保存先を存在しない子フォルダーへ一時的に変更し、Write-DemoLogによる保存が失敗する様子を確認します。
最初に$savedLogDirへ元の保存先を控え、finallyで$logDirを元の値へ戻します。finallyは成功時も失敗時も最後に通る後片付けの場所です。実データや権限は変更せず、ログ保存の処理をtryで囲んで失敗を画面へ表示します。
ログ保存の失敗を確認
$savedLogDir = $logDir
$logDir = Join-Path $savedLogDir 'not-created'
try {
Write-DemoLog -Level INFO -Message '保存失敗の練習' -At $demoAt
'保存できました'
} catch {
'ログ保存に失敗しました'
} finally {
$logDir = $savedLogDir
}
実行結果
ログ保存に失敗しました
「ログ保存に失敗しました」と表示されれば想定どおりです。「保存できました」は表示されません。finallyで保存先の変数が元へ戻るため、次の節も同じ練習フォルダーで続けられます。
実際の空き容量不足や権限拒否は今回再現していません。保存に失敗した場合は成功扱いにせず、保存先・空き容量・書込み権限を確認してから、処理と記録方法を見直します。
9.保管候補を境界日と不正な日付で確かめる
11月11日より前の実在する日付だけを候補にし、一覧の確認にとどめます。
保管期間は運用に合わせて決めます。この練習では、固定日時の11月18日から7日前に当たる11日を境界とし、その日より前の名前だけを一覧にします。境界日と同じ11日は含めません。7日分だけ残す処理ではありません。
最初のforeachは、4つの名前を順に扱い、確認用ファイルを練習フォルダーへ作ります。Where-Objectは、条件に合うファイルだけを選ぶ処理です。この節の比較表は、各ファイルが候補に入るかを整理したものです。コード欄を末尾まで実行し、出力と見比べてください。
BaseNameは拡張子を除いた名前です。-matchでapp-と8桁の数字という形式を調べ、$Matches[1]で数字の部分を取り出します。形式が合っても、2月30日のように実在しない日付は、次の判定で除外します。
TryParseExactは、決めた書式で日付を読み取れたかを返します。[ref]は、読み取った値を変数へ受け取る指定です。成功を確認した場合に、その日付を受け取る$parsedDayと境界日を比較します。
-andは条件をつなぎ、すべて満たすファイルを候補にします。-ltは日付が境界より前かを調べる比較です。InvariantCultureとDateTimeStylesのNoneは、今回の書式を地域設定に依存せず読むための指定です。
| 練習ファイル | 候補一覧 | 理由 |
|---|---|---|
| app-20261110.log | 表示される | 境界の11月11日より前 |
| app-20261111.log | 表示されない | 境界日と同じ |
| app-20260230.log | 表示されない | 実在しない日付 |
| app-invalid.log | 表示されない | 指定の名前の形式に合わない |
日付名から保管候補を一覧する
foreach ($name in @('app-20261110.log','app-20261111.log','app-20260230.log','app-invalid.log')) {
Set-Content -LiteralPath (Join-Path $logDir $name) -Value '練習用' -Encoding UTF8 -ErrorAction Stop
}
$cutoff = $demoAt.Date.AddDays(-7)
Get-ChildItem -LiteralPath $logDir -Filter 'app-*.log' -File |
Where-Object {
$parsedDay = [datetime]::MinValue
$_.BaseName -match '^app-(\d{8})$' -and
[datetime]::TryParseExact($Matches[1], 'yyyyMMdd', [Globalization.CultureInfo]::InvariantCulture, [Globalization.DateTimeStyles]::None, [ref]$parsedDay) -and
$parsedDay -lt $cutoff
} |
Sort-Object Name | Select-Object -ExpandProperty Name
実行結果
app-20261110.log
表示されるのはapp-20261110.logだけです。比較するのはファイル名の日付で、最終更新日時ではありません。境界日と同じファイル、不正な日付、別形式の名前は候補に入りません。
このコードは一覧を表示するだけで、削除も圧縮もしません。練習で作ったファイルは残ります。実際の整理前には、保存義務・バックアップ・書込み中のファイルを確認し、候補を見直します。
10.練習を片付け、自動実行に必要な条件を確認する
自動化の前に、保存先・権限・失敗の伝達方法を決めます。
この練習は、対話画面で動きを確かめる構成です。定期実行へそのまま登録する例ではありません。画面を閉じると、この画面で用意した変数や関数を、別の起動へ引き継ぐことはできません。
TEMPは恒久保存に向くとは限らないため、自動実行では専用のフルパスと実行アカウントの書込み権限を決めます。フルパスは、ドライブなどの起点から保存先までを省略せずに表した場所です。
保存するスクリプトには、必要な準備と関数を含めます。別のフォルダーから起動しても保存先が同じになるかを確認し、処理の失敗とログ保存の失敗を見分け、呼出し元へ伝える方法も用意します。
今回、タスクの登録・実行、複数処理の同時書込み、容量超過、ログの自動削除は検証していません。練習ファイルの片付けは、次の順で行います。
- PowerShell画面を閉じる前に、入力欄で変数名$logDirを入力し、表示された練習フォルダーの場所を控えます。
- エクスプローラーのアドレス欄へ控えた場所を入力し、今回の練習ファイルを確認します。
- 内容を残したい場合は、別の保管場所へコピーします。
- 今回作った練習フォルダーだけを手動で片付けます。画面を閉じると変数から場所を確認できなくなるため、場所を控えてから終了します。
パスワード、認証トークン、個人情報をログへ書かず、必要な記録に絞ります。自動化へ進む前には、追記したファイルをUTF8で読み戻し、日付・重要度・期待した完了内容がそろっているか確認します。
