【PowerShell】WinMergeでファイルを自動比較＆HTMLレポート出力する

指定フォルダ内にあるファイルを自動比較＆HTMLレポートを出力する

# --- 設定 ---
$root = Split-Path -Parent $MyInvocation.MyCommand.Path
$exe = Join-Path $root 'WinMergeU.exe'
$src = Join-Path $root '旧ファイル'
$dst = Join-Path $root '新ファイル'
$out = Join-Path $root 'レポート'

if (!(Test-Path $out)) { New-Item -ItemType Directory -Path $out | Out-Null }

# --- WinMerge CLIで全ファイル比較 ---
Get-ChildItem $dst -File | ForEach-Object {
    $name = [System.IO.Path]::GetFileNameWithoutExtension($_.Name)
    $report = "$out\Diff_$name.html"
    if (Test-Path $report) { Write-Host "Skip: $name"; return }

    $srcFile = Get-ChildItem $src -File | Where-Object {
        [System.IO.Path]::GetFileNameWithoutExtension($_.Name) -eq $name
    }

    if ($srcFile) {
        & $exe /r /e /xq /ul /ur /minimize /or $report $_.FullName $srcFile.FullName
        Write-Host "✔ $name: compared."
    } else {
        Write-Host "✖ $name: not found in SRC."
    }
}
Write-Host "✅ All comparisons done."

やってることは、これのPowerShell版

コマンドで何してる？

& $exe /r /e /xq /ul /ur /minimize /or $report $_.FullName $srcFile.FullName

各スイッチの意味

ここでやっていること

「WinMergeをGUIなし（自動）で起動して、旧フォルダと新フォルダの同名ファイルを比較 → 結果をHTMLで出力 → 終わったら閉じる」

$src と $dst を比べて、
同じ名前のファイルがあったら差分レポート（Diff_ファイル名.html）を自動で出力する構成。

$MyInvocation.MyCommand.Path

PowerShell スクリプト自身のファイルパスを取得するための変数。
つまり、「このスクリプトファイルがどこにあるか」を正確に知ることができる。

たとえば

この変数は、実行中のスクリプトが置かれている場所（フルパス）を返す。

例：

# ファイル： C:\Tools\Compare\run.ps1
$path = $MyInvocation.MyCommand.Path
Write-Host $path

出力結果：

C:\Tools\Compare\run.ps1

これが「この ps1 ファイル自身の場所」。

よくある使い方

1. スクリプトと同じフォルダにあるファイルを扱う

$root = Split-Path -Parent $MyInvocation.MyCommand.Path
$exe  = Join-Path $root 'WinMergeU.exe'

スクリプトと同じフォルダの WinMergeU.exe を自動的に参照できる。

2. 他フォルダを相対パスで参照する

$logDir = Join-Path $root 'logs'

スクリプトの場所を起点に logs フォルダを指定できる。

3. どこから実行しても安定する

PowerShell では「実行フォルダ」と「スクリプトの格納フォルダ」が異なることがあるので、相対パスで書くとズレる可能性あり。
$MyInvocation.MyCommand.Path を使えば常に「スクリプトのある場所」を基準にできる。

よくある間違い

• $PSScriptRoot も似ているが、コンソール上で直接実行した場合は空になることがある。
• $MyInvocation.MyCommand.Path はファイル実行でもモジュール化でも常に安定して動作する。

まとめ

このように、次の行のように書くのが最も安定した設計。

$root = Split-Path -Parent $MyInvocation.MyCommand.Path

スクリプトがどの環境から実行されても、常に同じ基準フォルダで処理できる。