07.1 パスの組み立て

文字列結合でパスを作らない

基準となる場所を間違えない

# スクリプトと同じ場所にある設定ファイルを読む（定番）
$config = Join-Path $PSScriptRoot 'config.json'

カレントの実行ファイルは .\ を明示する

# ✗ 環境設定によっては見つからない
mytool.exe

# ✓ カレントを明示する
.\mytool.exe

PowerShell はカレントディレクトリを自動では探しません（意図しないプログラムの実行を防ぐため）。cmd.exe とは挙動が違う点です。

パス操作のコマンド

07.2 Get-ChildItem — 0 件になる3つの理由

検証に使うファイル構成

以降の例はすべて、次の構成に対して実行した実測値です。

$base\
├── docs-a\
│   ├── a.txt
│   └── a.log
├── docs-b\
│   └── b.txt
└── other\
    └── c.txt

「docs-a と docs-b の中の .txt だけが欲しい」= 2 件が正解という前提で読んでください。a.log と c.txt は除外されるべきものです。

理由① パスのワイルドカードと -Filter を併用した 最頻出

これが最も多い原因です。エラーは出ず、静かに 0 件を返します。

# ✗ 0 件になる
Get-ChildItem "$base\docs-*" -Filter '*.txt' -File

# ✓ 親フォルダを指定して再帰し、絞り込みは Where-Object で行う
Get-ChildItem $base -Recurse -Filter '*.txt' -File |
    Where-Object { $_.Directory.Name -like 'docs-*' }

理由② -Include を -Recurse なしで使った

Get-ChildItem $base -Include '*.txt'              # → 0 件（何も返らない）
Get-ChildItem $base -Recurse -Include '*.txt'     # → 3 件（a.txt / b.txt / c.txt）
Get-ChildItem "$base\*" -Include '*.txt'          # → これでも動く

理由③ ファイル名に [ ] が含まれていた

-Path はワイルドカードを解釈します。角括弧は「いずれか1文字」を意味するため、実在するファイルが見つかりません。

よく使う指定

Get-ChildItem $dir -File                        # ファイルだけ
Get-ChildItem $dir -Directory                   # フォルダだけ
Get-ChildItem $dir -Recurse -Depth 2            # 深さを制限する
Get-ChildItem $dir -Force                       # 隠しファイルも含める
Get-ChildItem $dir -Recurse -ErrorAction SilentlyContinue   # アクセス不可を無視

07.3 読み書きと文字コード

02 章の話がここで効いてくる

02 章で「ファイルは文字コードを自己申告しない」と学びました。読み書きのたびに指定が必要になるのがその帰結です。しかも既定値が 5.1 と 7 で違います。

既定のエンコーディング — 実測値

「あ」1文字を書き出したときの実際のバイト列です。

両方で同じ結果になる書き方

# 読む（BOM があればそちらが優先される）
$text = Get-Content .\data.txt -Encoding UTF8 -Raw

# 書く
$text | Set-Content .\out.txt -Encoding UTF8      # 5.1: BOM 付き / 7: BOM なし

Get-Content は既定で「行の配列」を返す

# ✗ 行の配列が渡ってしまう
Get-Content .\data.json | ConvertFrom-Json

# ✓
Get-Content .\data.json -Raw | ConvertFrom-Json

07.4 CSV と JSON

CSV — 表形式のデータ

# 読む（1行が1オブジェクトになる）
$rows = Import-Csv .\data.csv -Encoding UTF8

# 書く
$rows | Export-Csv .\out.csv -Encoding UTF8 -NoTypeInformation

読み込んだ値はすべて文字列

$rows = Import-Csv .\sales.csv
$rows[0].Amount + 1        # → "1000" + 1 = "10001"  ✗ 文字列結合

[int]$rows[0].Amount + 1   # → 1001                  ✓

04 章で見た「左辺の型が演算を決める」がここで効いてきます。CSV から読んだ数値は必ず明示的に変換してください。

JSON

# 読む
$config = Get-Content .\config.json -Raw | ConvertFrom-Json

# 書く
$data | ConvertTo-Json -Depth 10 | Set-Content .\out.json -Encoding UTF8

-Depth の既定は 2 データが消える

入れ子が3階層を超えると、そこから先が文字列に置き換わります。

JSON を読むと PSCustomObject になる

$config = Get-Content .\config.json -Raw | ConvertFrom-Json
$config.database.host        # ドットでたどれる

# ハッシュテーブルとして受け取りたい場合
$hash = Get-Content .\config.json -Raw | ConvertFrom-Json -AsHashtable   # pwsh 7

-AsHashtable は pwsh 7 で追加されました。キーを動的に扱いたいときに便利です。

形式ごとの使い分け

# オブジェクトをそのまま保存して復元する（型情報も保たれる）
Get-Process | Export-Clixml .\proc.xml
$procs = Import-Clixml .\proc.xml