PowerShellで日常業務を自動化｜ファイル一覧・コピー・定期実行の基本

PowerShellの自動化は、まずファイル一覧をCSVへ出す小さな処理から始めます。コピーを追加する際は対象を明示し、上書き防止とWhatIfで確認してから実行します。手動実行が通ったあとに、同じエンジン・権限・パスで定期実行を設定してください。

PowerShellのバージョン確認

自動化スクリプトを作成・実行する前に、現在使用しているPowerShellのバージョンを確認してください。Windowsには、標準のWindows PowerShell 5.1（powershell.exe）と、より新しいPowerShell 7（pwsh.exe）の2種類が存在します。これらは別個のプログラムとして動作するため、スクリプトがどちらのエンジンで動いているかを把握しておくことが重要です。

以下のコマンドを実行することで、現在のバージョン情報を確認できます。

$PSVersionTable

用途別の自動化アプローチ比較

自動化したい内容に応じて、適切な手法を選択してください。

編集部の判断として、ファイル操作において最初は変更・削除を伴う処理を避け、一覧CSVで対象と結果を確認することを勧めます。なお、自動化による効率化については、読者自身で実測時間を比較し、保守コストを含めた判断を行ってください。

1. ファイル一覧の取得とCSV出力

大量のファイルを管理する場合、まずはファイルの一覧をCSV形式で出力し、現在の状況を正確に把握できるようにします。

実行前の準備

作業を開始する前に、出力先のパスを確認してください。出力ファイルが既存のファイルを上書きしてしまう可能性があるため、出力先には注意が必要です。

ファイル一覧作成のコマンド例

以下の手順で、ドキュメントフォルダ内のファイル情報をCSVとして保存します。

# パスの設定
$source = [Environment]::GetFolderPath("MyDocuments")
$report = Join-Path $env:TEMP file-list.csv

# ファイル一覧の取得とCSV出力
Get-ChildItem -LiteralPath $source -File | Select-Object Name, Length, LastWriteTime | Export-Csv -LiteralPath $report -NoTypeInformation -Encoding utf8 -NoClobber -ErrorAction Stop

-NoClobberは既存のCSVを上書きしない指定です。既に同名ファイルがある場合は、出力先を変えるか、その内容を確認して扱いを決めます。出典：MicrosoftのExport-Csv公式ドキュメント。

このコマンドの構成は以下の通りです。

1. Get-ChildItem -LiteralPath $source -File: 指定したソースパス（ドキュメントフォルダ）から、ファイルのみを取得します。
2. Select-Object Name, Length, LastWriteTime: ファイル名、サイズ、最終更新日時のみを抽出します。
3. Export-Csv -LiteralPath $report -NoTypeInformation -Encoding utf8: 抽出した情報を、指定したレポート用パスへCSV形式で出力します。

2. 安全なファイルコピーの実行

ファイルをコピーする際は、誤操作を防ぐための「シミュレーション（ドライラン）」と「エラーハンドリング」が極めて重要です。

実行前の確認事項

コピーを実行する前に、対象のファイルが存在するかどうかを Test-Path コマンドで確認してください。また、予期せぬ事態に備え、実行前には必ずバックアップを取得しておくことを推奨します。

安全なコピーの手順

Copy-Item コマンドには、実際に処理を行わずに実行内容を確認できる -WhatIf パラメータがあります。

# テスト用フォルダー内の一ファイルを指定します
$sourceFile = "C:\AutomationTest\input\sample.txt"
$destinationFile = "C:\AutomationTest\output\sample-copy.txt"

if (-not (Test-Path -LiteralPath $sourceFile -PathType Leaf)) {
    throw "コピー元ファイルが見つかりません"
}
if (-not (Test-Path -LiteralPath "C:\AutomationTest\output" -PathType Container)) {
    throw "出力フォルダーを先に用意してください"
}
if (Test-Path -LiteralPath $destinationFile) {
    throw "コピー先が既に存在します"
}
Copy-Item -LiteralPath $sourceFile -Destination $destinationFile -WhatIf

-WhatIf は、Copy-Item を含む特定のコマンドレット（cmdlet）で使用可能です。自作の関数内で同様のシミュレーション動作を実現したい場合は、SupportsShouldProcessと、変更処理を囲むShouldProcessの実装が必要です。指定を追加するだけで、全処理が自動的に保護されるわけではありません。出典：Microsoft公式ガイドのShouldProcess。

エラーハンドリングの実装

次は、上のテスト用パスと存在確認を済ませ、WhatIfの対象を確認したあとに行う実コピーの例です。実行中にほかの処理が同じ出力先へ書く状況は避けてください。出典：Copy-Item公式ドキュメント。

広告

スクリプトの実行中にエラーが発生した場合に備え、try/catch 構文と -ErrorAction Stop を組み合わせて使用します。これにより、エラーが発生した瞬間に処理を中断し、エラー内容を捕捉できます。

try {
    # コピー処理（エラー発生時に中断するように設定）
    if (Test-Path -LiteralPath $destinationFile) {
        throw "コピー先が既に存在します"
    }
    Copy-Item -LiteralPath $sourceFile -Destination $destinationFile -ErrorAction Stop
    # 実行ステータスの記録
    Write-Output "Success"
} catch {
    # エラー内容の記録（機密情報を含まないよう注意）
    Write-Error "コピーに失敗しました。後続の処理を停止します。"
    exit 1
}

3. タスクスケジューラによる自動実行の設定

スクリプトが手動で正常に動作することを確認したら、Windowsのタスクスケジューラを使用して定期実行の設定を行います。

設定の重要ポイント

タスクスケジューラでスクリプトを自動実行させる際は、以下の項目が手動実行時と一致していることを必ず確認してください。

• スクリプトの絶対パス: 相対パスではなく、必ずフルパスで指定してください。
• 作業ディレクトリ (Working Directory): スクリプトが参照するパスの基準となるディレクトリ。
• 実行アカウント: スクリプトを実行するユーザー権限。
• 権限 (Privileges): 必要な管理者権限などが付与されているか。
• 使用するエンジン: Windows PowerShell 5.1 または PowerShell 7 のどちらを使用するか。

推奨される実行引数

タスクの「操作」設定において、スクリプトを安定して実行するために以下の引数を使用することが推奨されます。

• -NoProfile: プロファイル（設定ファイル）を読み込まずに実行します。これにより、環境の違いによる影響を抑え、実行速度と安定性を向上させます。
• -File: 実行するスクリプトファイルを指定します。

注意: -ExecutionPolicy Bypass を使用して実行ポリシーを回避する方法は、セキュリティの観点から推奨されません。

出典：Microsoft公式のタスクスケジューラ案内。PowerShell 5.1系のScheduled Jobsと、任意のスクリプトを登録するTask Schedulerは区別します。

運用上の注意

• 重複起動の抑止: スクリプトが二重に実行されないよう、設計に注意してください。
• スケジュールの管理: 不要になったタスクは、適切にスケジュールを解除してください。

定期実行後も結果を確認する

編集部では、タスクを登録しただけで完了とせず、実行時刻・終了状態・出力ファイルの内容を確認することを勧めます。タスクが重複起動しない設定を選び、止める場合はタスクスケジューラで対象タスクを無効化します。

よくある失敗とトラブルシューティング

パス指定のミス

タスクスケジューラでスクリプトを実行する際、相対パスを使用するとファイルの読み込みに失敗する原因となります。必ず絶対パスを使用してください。

バージョンの不一致

Windows PowerShell 5.1 と PowerShell 7 では、使用できるコマンドや挙動が異なる場合があります。実行環境のバージョンを $PSVersionTable で事前に確認してください。

権限不足

スクリプトがアクセスできないファイルやフォルダがある場合、エラーが発生します。実行アカウントに適切な権限が付与されているか確認してください。

FAQ

Q1. PowerShellのバージョンはどうやって確認しますか？

$PSVersionTable コマンドを実行することで、現在のバージョンを確認できます。

Q2. コピー処理を実行する前に、何が起こるか確認する方法はありますか？

Copy-Item コマンドに -WhatIf パラメータを付けて実行してください。これにより、実際のコピーは行われず、実行される予定の操作内容が表示されます。

Q3. タスクスケジューラでスクリプトが動かない場合、まず何を確認すべきですか？

スクリプトの絶対パス、作業ディレクトリ、および実行アカウントの権限が正しく設定されているかを確認してください。

Q4. スクリプト実行時のエラーを捕捉するにはどうすればよいですか？

try/catch 構文を使用し、コマンドに -ErrorAction Stop を指定することで、エラーを捕捉して処理を制御できます。

Q5. ファイル一覧をCSVで出力する際、上書きを防ぐにはどうすればよいですか？

出力先のパス（$report）が既存のファイルと重複していないか、実行前に必ず確認してください。

---

関連情報:

• Node.js環境管理のガイド
• Kopiaバックアップのガイド

---

参考文献:

• Microsoft Learn: ShouldProcessについて
• Microsoft Learn: Copy-Itemについて
• Microsoft Learn: Export-Csvについて
• Microsoft Learn: タスクスケジューラの開始ページ