# 実行前提:


# - PowerShell 7.0 以降がインストールされていること。


# - リモートホストが稼働しており、WinRMが有効化されていること。


# - 実行ユーザーがリモートホストに対する適切な権限（通常はAdministrator権限）を持っていること。


# - $ComputerNames に指定されたホスト名またはIPアドレスが解決可能であること。

function Invoke-RemoteCIMOperation {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory=$true)]
        [string[]]$ComputerNames,

        [Parameter(Mandatory=$false)]
        [System.Management.Automation.PSCredential]$Credential = $null,

        [Parameter(Mandatory=$false)]
        [int]$MaxConcurrency = 5,

        [Parameter(Mandatory=$false)]
        [int]$RetryAttempts = 3,

        [Parameter(Mandatory=$false)]
        [int]$RetryDelaySeconds = 5
    )

    $global:ErrorActionPreference = 'Stop' # 関数内でエラーを即座に停止させる

    $results = [System.Collections.Generic.List[object]]::new()
    $logFilePath = ".\CIMOperationLog_$(Get-Date -Format 'yyyyMMdd_HHmmss').json"

    $scriptBlock = {
        param($ComputerName, $Credential, $RetryAttempts, $RetryDelaySeconds)

        $attempt = 0
        $session = $null
        $remoteResult = $null
        $errorMessage = $null

        while ($attempt -lt $RetryAttempts) {
            $attempt++
            try {

                # CIMセッションの確立

                Write-Verbose "[$ComputerName] Attempt $attempt: Establishing CIM session..."
                if ($Credential) {
                    $session = New-CimSession -ComputerName $ComputerName -Credential $Credential -ErrorAction Stop -SessionOption (New-CimSessionOption -OpenTimeout 30 -OperationTimeout 60)
                } else {
                    $session = New-CimSession -ComputerName $ComputerName -ErrorAction Stop -SessionOption (New-CimSessionOption -OpenTimeout 30 -OperationTimeout 60)
                }

                # WMI情報の取得（例: OS情報）

                Write-Verbose "[$ComputerName] Retrieving OS information..."
                $osInfo = Get-CimInstance -ClassName Win32_OperatingSystem -CimSession $session -ErrorAction Stop

                # ここでさらにInvoke-CimMethodなどを実行することも可能


                # Invoke-CimMethod -ClassName Win32_OperatingSystem -MethodName Reboot -CimSession $session

                $remoteResult = [PSCustomObject]@{
                    ComputerName = $ComputerName
                    Status = "Success"
                    OSName = $osInfo.Caption
                    OSVersion = $osInfo.Version
                    LastBootUpTime = $osInfo.LastBootUpTime
                    Timestamp = (Get-Date).ToString("yyyy-MM-dd HH:mm:ss")
                }
                break # 成功したらループを抜ける
            }
            catch {
                $errorMessage = $_.Exception.Message
                Write-Warning "[$ComputerName] Error in attempt $attempt: $($errorMessage)"
                if ($attempt -lt $RetryAttempts) {
                    Write-Verbose "[$ComputerName] Retrying in $RetryDelaySeconds seconds..."
                    Start-Sleep -Seconds $RetryDelaySeconds
                }
            }
            finally {
                if ($session) {
                    Remove-CimSession -CimSession $session -ErrorAction SilentlyContinue
                    $session = $null
                }
            }
        }

        if ($null -eq $remoteResult) {
            $remoteResult = [PSCustomObject]@{
                ComputerName = $ComputerName
                Status = "Failed"
                ErrorMessage = $errorMessage
                Timestamp = (Get-Date).ToString("yyyy-MM-dd HH:mm:ss")
            }
        }
        return $remoteResult
    }

    # ForEach-Object -Parallel を使用して並列処理

    $ComputerNames | ForEach-Object -Parallel $scriptBlock -ThrottleLimit $MaxConcurrency -ArgumentList $Credential, $RetryAttempts, $RetryDelaySeconds | ForOut-Default

    # ForEach-Object -Parallel はパイプラインの最後に `Out-Default` を自動的に付加するため、


    # その出力が自動的に画面に表示される。


    # 結果を収集したい場合は、以下のようにパイプラインの途中で収集する必要がある。


    # $ComputerNames | ForEach-Object -Parallel { ... } | ForEach-Object { $results.Add($_) }

    # 上記の ForEach-Object -Parallel の出力は直接画面に表示されるため、


    # $results に直接追加する仕組みではない。


    # ここでは、結果収集の概念を示すため、明示的に `$results` を使用する代わりに、


    # 出力を `ForOut-Default` で画面に表示することを想定している。


    # 実際には、`Out-File` や `Export-Csv` などで結果を収集する。

}

# --- 実行例 ---

$TargetComputers = @("Server1", "Server2", "NonExistentHost") # 実際のリモートホスト名またはIPアドレスに置き換えてください

# 資格情報を指定する場合（パスワードは安全に取得すること）


# $User = "Administrator"


# $Pass = Read-Host -AsSecureString "Enter password for $User"


# $Cred = New-Object System.Management.Automation.PSCredential($User, $Pass)

Write-Host "CIMセッションを介したリモート操作を開始します..."
Measure-Command {
    Invoke-RemoteCIMOperation -ComputerNames $TargetComputers -MaxConcurrency 3 -RetryAttempts 2 -RetryDelaySeconds 3 #-Credential $Cred
} | Select-Object TotalSeconds

Write-Host "`n操作ログは`$logFilePath に出力されますが、この例ではForOut-Defaultで画面に表示されます。"

# 実際の運用では、$results を集約してJSON形式で保存するなどします


# $results | ConvertTo-Json -Depth 3 | Set-Content $logFilePath -Encoding UTF8

# 実行前提:


# - 上記の Invoke-RemoteCIMOperation 関数がロードされていること。


# - テスト用の複数のリモートホストが準備されていること。

# --- シナリオ1: 並列処理の効果計測 ---

$TestComputers = @("Server1", "Server2", "Server3", "Server4", "Server5") # 実際のリモートホストに置き換える

# 非並列（逐次処理）での実行

Write-Host "--- シナリオ1: 非並列（逐次処理）での実行 ---"
Measure-Command {
    Invoke-RemoteCIMOperation -ComputerNames $TestComputers -MaxConcurrency 1 -RetryAttempts 1
} | Select-Object TotalSeconds

# 並列処理での実行

Write-Host "`n--- シナリオ1: 並列処理（ThrottleLimit 3）での実行 ---"
Measure-Command {
    Invoke-RemoteCIMOperation -ComputerNames $TestComputers -MaxConcurrency 3 -RetryAttempts 1
} | Select-Object TotalSeconds

# --- シナリオ2: エラーハンドリングと再試行の検証 ---


# 存在しないホストや意図的にWinRMが無効なホストを混ぜる

$ErrorTestComputers = @("Server1", "NonExistentHost", "AnotherNonExistentHost", "Server2")
Write-Host "`n--- シナリオ2: エラーハンドリングと再試行の検証 ---"
Measure-Command {
    Invoke-RemoteCIMOperation -ComputerNames $ErrorTestComputers -MaxConcurrency 2 -RetryAttempts 2 -RetryDelaySeconds 2
} | Select-Object TotalSeconds

Write-Host "`n各ホストのStatusプロパティを確認し、成功または失敗が正しく記録されているか検証してください。"