PowerShell関数の定義と利用方法を徹底解説

# 関数名を Get-Data として定義し、処理ブロック内に処理を記述する例

function Get-Data {
    "データを取得しています"
}

データを取得しています

function Test-Arguments {
    param(
        [string]$name,
        [int]$age
    )
    "Name: $name, Age: $age"
}

Name: Yamada, Age: 30

function Add-Numbers {
    param(
        [int]$a,
        [int]$b
    )
    return $a + $b
}

30  # 例: Add-Numbers 10 20 と呼び出した場合

function Example-Local {
    $localVar = "ローカル変数の値"
    $localVar
}

ローカル変数の値

$globalVar = "グローバル変数の値"
function Use-Global {
    "グローバル変数: $global:globalVar"
}

グローバル変数: グローバル変数の値

# 先に関数を定義した後、関数名をコマンドとして実行する例

function Greet {
    "こんにちは！"
}
Greet

こんにちは！

# ファイル内に関数を定義し、後続の処理で関数を呼び出す例

function Get-Time {
    Get-Date
}
"現在の時刻は: $(Get-Time)"

現在の時刻は: 2023/10/10 14:30:00  # 実行時の時刻により異なります

# モジュールファイル (MyModule.psm1) に関数を定義する例

function Get-Info {
    "情報を取得しました"
}

# 別のスクリプトファイルでモジュールを読み込み、関数を利用する例

Import-Module .\MyModule.psm1
Get-Info

情報を取得しました

# MyScript.ps1 の例

# 先に関数を定義

function Show-Message {
    "メッセージを表示します"
}

# 後続の処理で関数を呼び出し

Show-Message

メッセージを表示します

function Divide-Numbers {
    param(
        [int]$numerator,
        [int]$denominator
    )
    try {
        if ($denominator -eq 0) {
            throw "ゼロで割ることはできません"
        }
        $numerator / $denominator
    }
    catch {
        "エラー発生: $_"
    }
}

エラー発生: ゼロで割ることはできません

# エラー発生時の詳細情報を表示する例

function Process-Data {
    try {
        "データ処理を実施中"
        throw "サンプルエラー発生"
    }
    catch {
        "エラーが発生しました: $_"
    }
}

エラーが発生しました: サンプルエラー発生

function Debug-Function {
    param(
        [string]$message
    )

    # ログファイルのパスを指定

    $logFile = "C:\temp\debug.log"

    # タイムスタンプを取得してログに追記

    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
    "$timestamp - $message" | Out-File -FilePath $logFile -Append
    "ログ出力完了"
}

ログ出力完了

function Check-Status {
    [CmdletBinding()]
    param()
    Write-Debug "ステータスチェック実行中"
    "正常動作中"
}

DEBUG: ステータスチェック実行中
正常動作中

# シンプルな関数定義と呼び出しの例

function Say-Hello {
    "こんにちは、PowerShellの世界へようこそ！"
}
Say-Hello

こんにちは、PowerShellの世界へようこそ！

function Process-Numbers {
    param(
        [int[]]$numbers
    )
    $result = @()
    foreach ($num in $numbers) {
        if ($num % 2 -eq 0) {

            # 偶数はそのまま結果に追加

            $result += $num
        }
        else {

            # 奇数は2倍して結果に追加

            $result += $num * 2
        }
    }
    $result
}

# 関数実行例 (1は2倍、2はそのまま、3は2倍、4はそのまま追加されます)

Process-Numbers -numbers @(1,2,3,4)

2
2
6
4

function Handle-Input {
    param(
        [int]$value
    )
    try {
        if ($value -lt 0) {
            throw "負の値は許可されません"
        }

        # 例として値に10をかけた結果を返す

        $value * 10
    }
    catch {
        "エラー: $_"
    }
}

# 関数実行例 (負の値を渡すとエラー処理が動作します)

Handle-Input -value -5

エラー: 負の値は許可されません