PowerShell 深度探索（十一）：函數完整指南——參數、管線、進階結構

函數基礎語法

function 函數名稱 (參數) { 程式碼區塊 }
# 或
function 函數名稱 {
    param (參數清單)
    程式碼區塊
}

最簡單範例

function Time { Get-Date }
Time  # 輸出目前日期時間

參數宣告與型別限制

基本參數

function Add ($x, $y) {
    $n = $x + $y
    "$x + $y = $n"
}
Add 3 5  # 輸出：3 + 5 = 8

強型別與預設值（推薦寫法）

function Add {
    param (
        [int]$x = 0,
        [int]$y = 0
    )
    $n = $x + $y
    "$x + $y = $n"
}

優點：防止型別錯誤、參數缺失時有預設行為、提升腳本健壯度。

管線支援：$input 自動變數

讓函數接收管線輸入：

function Find-WindowsFolder {
    $input | Where-Object { $_.Name -eq "Windows" }
}
Get-ChildItem C:\ | Find-WindowsFolder

$input 代表管線傳入的完整物件集合（列舉器）。

進階函數結構：Begin / Process / End

針對管線處理提供三個階段區塊：

完整範例

function Process-Files {
    begin {
        "=== 開始處理 ==="
        $count = 0
        $totalSize = 0
    }
    process {
        $count++
        $totalSize += $_.Length
        "[$count] $($_.Name) - $($_.Length) bytes"
    }
    end {
        "=== 處理完成 ==="
        "總計：$count 個檔案，總大小：$totalSize bytes"
    }
}
Get-ChildItem | Process-Files

重要規則

• 若使用 Begin/Process/End 結構，區塊外不得有其他程式碼
• 每個區塊只能出現一次
• Process 區塊內 $_ 代表目前管線物件
• 若無 Process 區塊，管線物件會整批存入 $input

變數作用域

函數內定義的變數（如範例中的 $n、$count）為區域變數，函數結束後自動銷毀，不會污染全域環境。

最佳實務建議

1. 一律使用 param() 區塊 宣告參數，加上型別與預設值
2. 支援管線時務必實作 Process 區塊
3. 命名遵循 Verb-Noun 慣例（如 Get-Service、Set-Config）
4. 加入註解式說明（.SYNOPSIS、.PARAMETER 等）支援 Get-Help
5. 輸出物而非文字，保持物件管線特性

掌握函數進階特性，能編寫出專業級、可重用、支援管線的 PowerShell 模組與腳本。