PowerShellのファイル操作の基本(移動・一覧・読む・検索・存在確認・コピー・移動、削除は-WhatIfで確認)
要点
読む・探す系(Set-Location・Get-ChildItem・Get-Content・Select-String・Test-Path)は安全。Copy-Item・Move-Itemは上書き・移動先を確認。Remove-Itemはごみ箱を通らず消えるので、-WhatIfで対象を確認してから、範囲を限定して使う。
作業フォルダへの移動・UTF-8表示・knowledge検索などは よく使うコマンド集(PowerShell・Claude Code起動・knowledge・WP-CLI・SSH)。PowerShell 5.1 の文字コードの注意は Windows PowerShell 5.1 で日本語スクリプトが壊れる(UTF-8 BOM が必要)。
読む・探す(安全)
Set-Location "C:\作業フォルダ" # cd と同じ
Get-ChildItem # 一覧(ls と同じ)
Get-ChildItem -Recurse -Filter *.md # 下の階層も含めて .md を探す
Get-Content .\file.md -Encoding UTF8 -TotalCount 30 # 先頭30行
Get-Content .\log.txt -Tail 50 # 末尾50行
Select-String -Path .\*.md -Pattern "noindex" # ファイルの中を検索(grep のように)
Get-ChildItem -Recurse -Filter *.html | Select-String -Pattern "href=""#""" # 下の階層も検索
Test-Path .\バックアップ # あるか(True / False)
コピー・移動(注意)
Copy-Item .\template.html .\出力\new-page.html # コピー(同名があると上書き)
Move-Item .\draft.md .\archive\ # 移動
- コピー先・移動先に同じ名前のファイルがあると上書きされることがある。先に
Test-Pathで確認。 - 大事なファイルは、上書きより別名で保存(
-v2、日付付き)を優先。
削除(危険・原則は人が確認)
Remove-Itemはごみ箱を通らず消える。- 実行前に
-WhatIfを付けて「何が消えるか」だけ表示して確認する:
Remove-Item .\tmp\test.txt -WhatIf
- ワイルドカード(
*)やフォルダごと・下の階層ごとの削除は、対象が想定より広がりやすい。対象を一覧で確認し、件数を数えてから。 - 実案件のフォルダ・バックアップ・本番に関わるファイルの削除は、AIに任せず人が確認する(AIにファイル操作をさせるときの安全度(読む・検索・新規作成は安全、上書き・移動・一括置換は注意、削除・大量変更・本番置換は危険))。
- このプロジェクトでは、バックアップは削除しない(バックアップ方針(作業前に必ず取り、削除しない))。
よくあるつまずき
- パスに空白や日本語 →
"..."で囲む。 - 日本語ファイル名の文字化け(プロジェクトのファイル名が文字化けしている(UTF-8をCP932として解釈))。
Get-Contentの文字コード指定漏れで文字化け →-Encoding UTF8。
数える・絞る・並べる
chcp 65001 # 表示をUTF-8に(文字化けするとき)
(Get-ChildItem -Recurse -Filter *.html | Measure-Object).Count # 件数
Get-ChildItem -Recurse -File | Where-Object { $_.Length -gt 500KB } # 500KBより大きいファイル
Get-ChildItem -Recurse -File | Where-Object { $_.LastWriteTime -gt (Get-Date).AddDays(-1) } # 1日以内に変更
Get-ChildItem -File | Sort-Object LastWriteTime -Descending | Select-Object -First 10 # 新しい順に10件
Get-Content .\file.md -Encoding UTF8 | Measure-Object -Line -Character # 行数・文字数
検索の例は ファイル検索コピペ集(PowerShellで文字列・CSSクラス・href="#"・URL・拡張子で探す、件数を数える)。