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

📝 はじめに

PowerShellでファイル一覧を取得するとき、
「サブフォルダは見たくない」
「深い階層まで再帰すると情報が多すぎる」
と感じたことはありませんか？

Get-ChildItem には
再帰検索を制御できる -Depth パラメーターがあります。
これを使うことで、指定した深さまでだけ一覧表示することが可能になります。

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

✅ Get-ChildItem -Depth でできること

-Depth は、
Get-ChildItem -Recurse と一緒に使うことで、
再帰検索の階層数を制限するためのパラメーターです。

「再帰はしたいが、無制限にはしたくない」
というケースで特に役立ちます。

考え方としては「何階層下まで見るかを決める」と覚えると分かりやすいでしょう。

🧩 基本構文

Get-ChildItem -Recurse -Depth 数値

-Depth は数値で指定し、
0 を指定するとカレント直下のみが対象になります。

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

🔹 カレント配下のみを表示する（Depth 0）

Get-ChildItem -Recurse -Depth 0

現在のフォルダ直下にあるファイル・フォルダのみが表示されます。
この結果が表示されていれば問題ありません。

🔹 1階層下まで表示する

Get-ChildItem -Recurse -Depth 1

サブフォルダの中身までは表示されますが、
それ以上深い階層は対象外になります。
エラーが出なければ正常に動作しています。

🛠 よく使われる指定例

🔹 フォルダのみを対象にする

Get-ChildItem -Directory -Recurse -Depth 1

カレント配下と、その1階層下にあるフォルダのみを取得します。

🔹 ファイルだけを一覧表示する

Get-ChildItem -File -Recurse -Depth 0

カレントディレクトリ直下のファイルのみを表示します。

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

🔹 ログフォルダ構成を把握する

Get-ChildItem C:\Logs -Recurse -Depth 1

🔹 処理対象を事前に確認する

Get-ChildItem -Recurse -Depth 0 |
Where-Object { $_.Extension -eq ".txt" }

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

• -Depth は -Recurse とセットで使う
• -Depth だけ指定しても再帰は行われない
• PowerShell 5.1 では使用できない
• 深い階層でも 0 は「直下のみ」
• 大量ファイルでも処理負荷を抑えられる

🔄 cmdとの違いについて

cmd の dir では
階層制御が難しいですが、
PowerShell の Get-ChildItem -Depth は
再帰範囲を明確に指定できます。

大規模フォルダの調査で特に差が出ます。

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

🧠 注意点

-Depth は
Windows PowerShell 5.1 では使えません。
利用する場合は PowerShell 6（Core）以降であることを
事前に確認しましょう。

📌 まとめ

• -Depth を使うと再帰検索の範囲を制御できる
• Depth 0 はカレント配下のみを対象にする
• 不要な深い検索を避けられる
• 次は -File / -Directory と組み合わせると便利

🔎 PowerShellコマンドを探す

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

• ファイルを削除したい
• 一覧を表示したい
• 文字列を検索したい
• 条件で絞り込みたい
• エラーや実行できない原因を調べたい
• カレント配下だけを一覧表示したい
• 再帰検索の深さを制御したい