パソコンで困ったとき、役立つ情報を公開（当サイトにはアフィリエイト広告を含む場合があります。リンクから商品を購入されると、運営者に報酬が発生することがあります。）

📝 はじめに

PowerShellでファイルやフォルダを扱っていると、
「このパスは本当に存在しているのか？」
「存在しない場合は処理を止めたい・分けたい」
と感じる場面は非常に多くあります。

そんなときに欠かせないのが
Test-Path です。
パスの存在有無を True / False で判定できるため、
安全なスクリプトを書くための基本コマンドとして広く使われています。

✅ このコマンドでできること（要点）

✅ Test-Path でできること

Test-Path は、
指定したパスが実際に存在しているかどうかを判定するコマンドです。

結果は True または False として返されるため、
条件分岐やエラーハンドリングの起点として非常に重要な役割を持ちます。

考え方としては「この道は通れるか？」を確認するチェックポイントのようなものです。

🧩 基本構文

Test-Path "確認したいパス"

パスを指定するだけで、存在有無を判定できます。

▶ 基本的な使い方（まずこれだけ）

🔹 ファイルの存在を確認する

Test-Path "C:\test\data.txt"

True が表示されればファイルは存在しています。
False の場合は存在しません。
この結果が表示されていれば問題ありません。

🔹 フォルダの存在を確認する

Test-Path "C:\Windows"

フォルダでも同様に確認できます。
エラーが出なければ正常に判定できています。

🛠 よく使われる指定例

🔹 if 文で処理を分ける

if (Test-Path "C:\test\data.txt") {
    "ファイルは存在します"
} else {
    "ファイルは存在しません"
}

存在する場合・しない場合で処理を明確に分けられます。

🔹 ファイルかフォルダかを判定する

Test-Path "C:\Windows" -PathType Container

-PathType Container はフォルダ、
-PathType Leaf はファイルを意味します。

💼 実務でよく使う使用例（応用）

🔹 存在しない場合のみ作成する

if (-not (Test-Path "C:\logs")) {
    New-Item -ItemType Directory -Path "C:\logs"
}

🔹 処理前の安全チェック

if (Test-Path "C:\backup\data.zip") {
    Expand-Archive "C:\backup\data.zip" "C:\restore"
}

🧩 よくある勘違い・つまずきポイント

• 存在しないパスでもエラーにならない（False が返る）
• ファイルとフォルダを区別せずに使ってしまう
• UNCパスやネットワークパスで遅くなる場合がある
• ワイルドカード指定で結果が変わることがある
• True / False を文字列として比較してしまう

🔄 cmdとの違いについて

cmd では if exist を使いますが、
PowerShellの Test-Path は
コマンドとして独立しており、パイプや条件式に組み込みやすいのが特徴です。

より柔軟で読みやすい条件判定が可能になります。

⚠ エラー・うまく動かないときの確認ポイント

🧠 注意点

Test-Path は非常に便利ですが、
判定結果はその時点の状態に依存します。
直後にファイルが削除・作成される可能性もあるため、
重要な処理では例外処理と併用するのがおすすめです。

📌 まとめ

• Test-Path はパスの存在確認を行う基本コマンド
• True / False で安全な条件分岐ができる
• エラー防止のために事前チェックとして重要
• 次は New-Item や Remove-Item と組み合わせると理解が深まる

🔎 PowerShellコマンドを探す

やりたいことからコマンドを探すこともできます。

• ファイルを削除したい
• 一覧を表示したい
• 文字列を検索したい
• 条件で絞り込みたい
• エラーや実行できない原因を調べたい
• パスが存在するか確認したい
• 安全に処理を分岐したい