06.1 制御構文 — 素直な部分と switch の驚き

if は見た目どおり

# JavaScript                        # PowerShell
if (x > 10) {                       if ($x -gt 10) {
    ...                                 ...
} else if (x > 5) {                 } elseif ($x -gt 5) {
    ...                                 ...
} else {                            } else {
    ...                                 ...
}                                   }

違いは比較演算子（04 章）と else if が elseif の1語になっている点だけです。括弧と波括弧はどちらも省略できません。

繰り返し — 2つの foreach を使い分ける

# 全件をメモリに載せる（10万件のファイルだと重い）
foreach ($f in Get-ChildItem -Recurse) { $f.Name }

# 1件ずつ処理する（メモリを使わない）
Get-ChildItem -Recurse | ForEach-Object { $_.Name }

その他の繰り返し

for ($i = 0; $i -lt 10; $i++) { $i }

while ($true) { break }

do { $n++ } while ($n -lt 3)
do { $n++ } until ($n -ge 3)      # until は JavaScript にない

1..5 | ForEach-Object { $_ }      # 範囲演算子

switch は「一致した分だけ全部実行される」 最大の驚き

C・Java・JavaScript の switch は最初に一致した場所から下に流れ落ちる（フォールスルー）ため break が必要でした。PowerShell は違います。

switch (5) {
    {$_ -gt 1}  { 'gt1' }
    {$_ -gt 3}  { 'gt3' }
    {$_ -gt 10} { 'gt10' }
}
# → gt1 と gt3 の両方が返る

switch (5) {
    {$_ -gt 1}  { 'gt1'; break }    # break で止まる
    {$_ -gt 3}  { 'gt3' }
}
# → gt1 だけ

switch の便利な使い方

# 配列を渡すと各要素を処理する（ループが不要）
switch (1, 2, 3) {
    1 { 'one' }
    2 { 'two' }
    default { 'other' }
}
# → one, two, other

# 正規表現
switch -Regex ('report-2026.txt') {
    '^report' { '先頭が report' }
    '\d{4}'   { "4桁: $($matches[0])" }
}

# ワイルドカード
switch -Wildcard ('a.log') {
    '*.txt' { 'txt' }
    '*.log' { 'log' }
}

# 大文字小文字を区別する（04 章の話と同じ）
switch -CaseSensitive ('ABC') { 'abc' { '一致しない' } }

06.2 関数 — 定義と呼び出し

定義

# JavaScript
function getUser(name, age = 20) { ... }

# PowerShell
function Get-User {
    param(
        [Parameter(Mandatory)]
        [string]$Name,
        [int]$Age = 20
    )
    "$Name ($Age)"
}

関数名はCmdlet と同じ「動詞-名詞」にします（05 章）。Get-Verb にある動詞を使えば、利用者が機能を推測できます。

呼び出し方 — カンマと括弧を使わない 最大の罠

ここが経験者ほど間違える箇所です。しかもエラーが出ないまま、意図と違う値が渡ります。

パイプラインから受け取る

自作関数を | の右側に置けるようにするには、ValueFromPipeline と process ブロックを使います。

function Add-Tag {
    param([Parameter(ValueFromPipeline)][string]$Text)

    begin   { $n = 0 }
    process { $n++; "[$n] $Text" }
    end     { "合計 $n 件" }
}

'a', 'b', 'c' | Add-Tag
# → [1] a / [2] b / [3] c / 合計 3 件

[CmdletBinding()] を付ける

function Get-Report {
    [CmdletBinding()]
    param([string]$Path)

    Write-Verbose "処理開始: $Path"
    # ...
}

Get-Report -Path .\a.txt -Verbose      # -Verbose が使えるようになる

これ1行で -Verbose・-Debug・-ErrorAction などの共通パラメータが自動で使えるようになります。自作関数が組み込みコマンドと同じ操作感になるので、付けておくのが定石です。

06.3 戻り値の落とし穴

出力されたものが「すべて」戻り値になる

これが本章で最も重要な仕様です。PowerShell の関数は、変数に代入されなかった値をすべて戻り値として返します。

function Test-Return {
    "途中の出力"          # ← これも戻り値になる
    $x = 1 + 1            # ← 代入なので戻り値にならない
    return "returnの値"
}

$r = Test-Return
@($r).Count               # → 2
$r -join ' / '            # → 途中の出力 / returnの値

意図しない出力を止める3つの方法

要素1個の配列が「潰れる」 再現性の低いバグの温床

関数から配列を返すと、要素が1個のときだけ配列ではなくなります。

function Get-One {
    $a = @('x')          # 要素1個の配列
    return $a
}

$o = Get-One
$o.GetType().Name        # → String （！配列ではない）

function Get-OneFixed {
    $a = @('x')
    return ,$a           # ← 先頭のカンマがポイント
}

$o = Get-OneFixed
$o.GetType().Name        # → Object[]
$o.Count                 # → 1

呼び出し側でも守れる

# 受け取る側で @() で包めば、必ず配列になる
$items = @(Get-One)
$items.Count             # → 1（潰れていても復元される）

06.4 スコープ

読めるが、書き換えられない

同じ変数名でも、読むときと書くときで指すものが変わります。

$outer = 'もとの値'

function Test-Write {
    $outer = '関数内で変更'
    "関数内: $outer"          # → 関数内: 関数内で変更
}

Test-Write
"関数の外: $outer"            # → 関数の外: もとの値

意図的に外を書き換える

function Set-Counter {
    $script:counter = 10      # スクリプト全体で見える
}
Set-Counter
$counter                      # → 10

ドットソース — 別ファイルの関数を読み込む

# ✗ これは別プロセスとして実行され、関数は残らない
.\lib.ps1

# ✓ ドットソース。現在のスコープに読み込まれる
. .\lib.ps1
Get-MyFunction            # lib.ps1 で定義した関数が使える

ドット＋スペース＋パスです。見落としやすいですが、これがないと関数が読み込まれません。

# 自分と同じフォルダの lib.ps1 を読む（定番の書き方）
. (Join-Path $PSScriptRoot 'lib.ps1')

Set-StrictMode でミスを早く見つける

Set-StrictMode -Version Latest