# region Class Definition

# クラス名を厳密に定義し、名前空間的な管理を推奨

class Configuration.ServerProfile {

    # プロパティの定義（厳密な型付け）

    [string]$ServerName
    [string]$Role
    [datetime]$InitializedTime

    # --- 既定コンストラクタ（パラメータなし） ---


    # パラメータなしでインスタンスを作成できるように明示的に定義

    Configuration.ServerProfile() {
        $this.InitializedTime = Get-Date
    }

    # --- カスタムコンストラクタ（パラメータ付き） ---


    # 必須パラメータを受け付け、オブジェクト初期化時に検証を行う

    Configuration.ServerProfile([string]$ServerName, [string]$Role) {

        # パラメータのバリデーション (必須チェック)

        if ([string]::IsNullOrWhiteSpace($ServerName) -or [string]::IsNullOrWhiteSpace($Role)) {
            throw "ServerName and Role parameters must be provided during object initialization."
        }

        # プロパティへの値設定

        $this.ServerName = $ServerName
        $this.Role = $Role
        $this.InitializedTime = Get-Date
    }

    # --- カスタムメソッドの例 ---

    [string] GetStatusMessage() {
        return "Server $($this.ServerName) initialized at $($this.InitializedTime.ToString('yyyy-MM-dd HH:mm:ss')) with Role: $($this.Role)."
    }
}

# endregion Class Definition

### 2. コンストラクタ呼び出しとエラーハンドリング

カスタムコンストラクタを呼び出すには、`[ClassName]::new(...)` 構文または `New-Object` コマンドレットを使用します。（PowerShell 7以降では前者の方が推奨されますが、ここでは標準的な`New-Object`とクラス名を使った例を示します）

```powershell

# 設定リストの準備

$ServerList = @(
    @{ Name = 'WEB01'; Role = 'WebFront' },
    @{ Name = 'DB01'; Role = 'Database' },

    # 意図的に必須パラメータを欠落させる（Roleなし）

    @{ Name = 'APP01'; Role = '' },
    @{ Name = 'DC01'; Role = 'DomainController' }
)

$ProfileObjects = [System.Collections.Generic.List[Configuration.ServerProfile]]::new()

Write-Host "--- 設定プロファイルのオブジェクト化を開始 ---" -ForegroundColor Cyan

foreach ($Server in $ServerList) {
    try {

        # カスタムコンストラクタを呼び出す

        $Profile = New-Object Configuration.ServerProfile $Server.Name, $Server.Role

        # 正常に生成されたオブジェクトを追加

        $ProfileObjects.Add($Profile)
        Write-Host "SUCCESS: $($Profile.ServerName) プロファイルを生成しました。" -ForegroundColor Green

    } catch {

        # コンストラクタ内で発生したエラー（必須パラメータ欠落など）を捕捉

        Write-Error "FAILURE: サーバー $($Server.Name) の初期化に失敗しました。 $($_.Exception.Message)"
    }
}

Write-Host "`n--- オブジェクト化されたリストの処理（並列処理の適用） ---" -ForegroundColor Cyan

# PS 7.x 環境での並列処理を適用し、カスタムメソッドを実行

$ProfileObjects | ForEach-Object -Parallel {
    $_.GetStatusMessage()
} -ThrottleLimit 5

$Iterations = 1000

# 1. カスタムクラス生成の計測

$ClassMeasure = Measure-Command {
    1..$Iterations | ForEach-Object {
        $Null = New-Object Configuration.ServerProfile "Server-$_", "Role-A"
    }
}

# 2. ハッシュテーブル生成の計測

$HashMeasure = Measure-Command {
    1..$Iterations | ForEach-Object {
        $Null = @{ ServerName = "Server-$_"; Role = "Role-A"; InitializedTime = Get-Date }
    }
}

Write-Host "`n--- オブジェクト生成速度比較 (1000回) ---" -ForegroundColor Yellow
Write-Host "クラスオブジェクト生成: $($ClassMeasure.TotalMilliseconds) ms"
Write-Host "ハッシュテーブル生成: $($HashMeasure.TotalMilliseconds) ms"

# 大規模環境での動作期待値:


# PowerShellクラスはC#のCLRオブジェクトとして実装されるため、特に複雑なデータ構造や多数のメソッドを持つ場合、PScustomObjectやハッシュテーブルよりもメモリ効率と実行速度で優位に立つことが期待されます。


# オブジェクト生成時の検証処理（バリデーション）をコンストラクタに組み込むことで、生成コストはわずかに増加しますが、後続の実行時エラーを防ぐため、トータルでの運用安定性は大幅に向上します。