# 実行前提:


# - 対象のコンピューター名 ($ComputerName) が有効であること。


# - 実行ユーザーが対象コンピューターに対するサービス停止権限を持っていること。


# - WinRMが対象コンピューターで有効になっていること。


# - 停止対象のサービス名 ($ServiceName) が存在し、停止可能であること。

$ComputerName = 'YourRemoteServer01' # 対象コンピューター名に置き換えてください
$ServiceName = 'Spooler'             # 停止したいサービス名に置き換えてください

try {
    Write-Host "[$ComputerName] サービス '$ServiceName' を停止します..." -ForegroundColor Cyan

    # Invoke-CimMethod を使用してリモートでサービスを停止


    # -ClassName: WMIクラス名を指定


    # -MethodName: 呼び出すメソッド名を指定


    # -Arguments: メソッドに渡す引数をハッシュテーブルで指定（StopServiceには引数不要）


    # -ComputerName: ターゲットのコンピューター名


    # -ErrorAction Stop: コマンドレットがエラーを発生させた場合にスクリプトを即時停止

    # サービスインスタンスを取得

    $service = Get-CimInstance -ClassName Win32_Service -Filter "Name='$ServiceName'" -ComputerName $ComputerName -ErrorAction Stop

    if ($service) {

        # StopService メソッドを呼び出し

        $result = Invoke-CimMethod -InputObject $service -MethodName 'StopService' -ErrorAction Stop

        if ($result.ReturnValue -eq 0) {
            Write-Host "[$ComputerName] サービス '$ServiceName' は正常に停止しました。" -ForegroundColor Green
        } else {
            Write-Warning "[$ComputerName] サービス '$ServiceName' の停止に失敗しました。リターンコード: $($result.ReturnValue)"
        }
    } else {
        Write-Warning "[$ComputerName] サービス '$ServiceName' が見つかりませんでした。"
    }
}
catch [Microsoft.Management.Infrastructure.CimException] {
    Write-Error "[$ComputerName] CIM操作中にエラーが発生しました: $($_.Exception.Message)"
}
catch {
    Write-Error "[$ComputerName] 予期せぬエラーが発生しました: $($_.Exception.Message)"
}

# 実行前提:


# - PowerShell 7.x 以降の環境であること。


# - 対象のコンピューターリスト ($ComputerList) が有効であること。


# - 実行ユーザーが対象コンピューターに対するWMI情報取得権限を持っていること。


# - WinRMが対象コンピューターで有効になっていること。

Function Invoke-CimMethodWithRetry {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory=$true)]
        [string]$ComputerName,

        [Parameter(Mandatory=$true)]
        [string]$ClassName,

        [Parameter(Mandatory=$true)]
        [string]$MethodName,

        [Parameter()]
        [hashtable]$Arguments = @{},

        [Parameter()]
        [int]$MaxRetries = 3,

        [Parameter()]
        [int]$RetryDelaySec = 5,

        [Parameter()]
        [int]$OperationTimeoutSec = 60 # CIM操作のタイムアウト
    )

    $attempt = 0
    do {
        $attempt++
        try {
            Write-Verbose "[$ComputerName] $ClassName.$MethodName 実行中 (試行 $attempt/$MaxRetries)..."

            # CIMインスタンスを取得し、メソッドを実行


            # -OperationTimeoutSec で個々のCIM操作のタイムアウトを設定

            $cimInstance = Get-CimInstance -ClassName $ClassName -ComputerName $ComputerName -ErrorAction Stop -OperationTimeoutSec $OperationTimeoutSec
            $result = Invoke-CimMethod -InputObject $cimInstance -MethodName $MethodName -Arguments $Arguments -ErrorAction Stop -OperationTimeoutSec $OperationTimeoutSec

            # 結果が正常であることを確認（例: ReturnValueが0）

            if ($result.ReturnValue -eq 0) {
                Write-Verbose "[$ComputerName] $ClassName.$MethodName 成功。"
                return $result
            } else {

                # メソッド自体がエラーコードを返した場合

                throw "[$ComputerName] $ClassName.$MethodName メソッド呼び出しが非ゼロのリターンコード $($result.ReturnValue) を返しました。"
            }
        }
        catch [Microsoft.Management.Infrastructure.CimException] {
            $errorMessage = "[$ComputerName] CIM操作エラー: $($_.Exception.Message)"
            Write-Warning $errorMessage
            if ($attempt -lt $MaxRetries) {
                Write-Verbose "[$ComputerName] $RetryDelaySec 秒待機後、リトライします..."
                Start-Sleep -Seconds $RetryDelaySec
            } else {
                throw $errorMessage # リトライ上限を超えたらエラーを再スロー
            }
        }
        catch {
            $errorMessage = "[$ComputerName] 予期せぬエラー: $($_.Exception.Message)"
            Write-Warning $errorMessage
            if ($attempt -lt $MaxRetries) {
                Write-Verbose "[$ComputerName] $RetryDelaySec 秒待機後、リトライします..."
                Start-Sleep -Seconds $RetryDelaySec
            } else {
                throw $errorMessage # リトライ上限を超えたらエラーを再スロー
            }
        }
    } while ($attempt -lt $MaxRetries)

    return $null # 全リトライ失敗
}

# --- メイン処理 ---

$ComputerList = @(
    'YourRemoteServer01', # 実際のサーバー名に置き換えてください
    'YourRemoteServer02',
    'YourRemoteServer03',
    'NonExistentHost',    # 存在しないホストをテストに含める
    'YourRemoteServer04'
)
$LogFilePath = ".\CimMethodOperationLog-{{jst_today}}.json"
$Results = [System.Collections.Generic.List[object]]::new()
$Errors = [System.Collections.Generic.List[object]]::new()

# トランスクリプトを開始 (コンソール出力もログに記録)

Start-Transcript -Path ".\CimMethodTranscript-{{jst_today}}.log" -Append -Force

Write-Host "リモートCIMメソッド操作を開始します。対象ホスト数: $($ComputerList.Count)" -ForegroundColor Green

# Measure-Command で処理時間を計測

$TotalTime = Measure-Command {
    $ComputerList | ForEach-Object -Parallel {
        param($ComputerName)

        $script:ProgressPreference = 'SilentlyContinue' # 並列処理内のプログレスバーを抑制
        $processStart = Get-Date

        try {
            Write-Host "[$ComputerName] 処理開始。" -ForegroundColor DarkYellow

            # WMIのWin32_OperatingSystemクラスのReboot()メソッドを呼び出す例


            # 実際にはRebootは危険な操作のため、ここではGet-CimInstanceでOS情報を取得する例に置き換えます。


            # $result = Invoke-CimMethodWithRetry -ComputerName $ComputerName -ClassName 'Win32_OperatingSystem' -MethodName 'Reboot' -MaxRetries 2 -RetryDelaySec 10 -OperationTimeoutSec 120

            # 例としてGet-CimInstanceでOS情報を取得し、擬似的にメソッド結果として扱います。


            # 実際のInvoke-CimMethodWithRetryを使う場合は、上記のコメントアウトを解除し、


            # 適切なクラスとメソッド名、引数を指定してください。

            # 実際のメソッド呼び出しをシミュレート

            $osInfo = Get-CimInstance -ClassName 'Win32_OperatingSystem' -ComputerName $ComputerName -ErrorAction Stop -OperationTimeoutSec 30
            $simulatedResult = [PSCustomObject]@{
                ReturnValue = 0; # 成功をシミュレート
                OSCaption = $osInfo.Caption;
                OSVersion = $osInfo.Version;
                LastBootUpTime = $osInfo.LastBootUpTime;
            }

            $processEnd = Get-Date
            $elapsed = ($processEnd - $processStart).TotalSeconds

            $script:Results.Add([PSCustomObject]@{
                ComputerName = $ComputerName;
                Status = 'Success';
                Message = "OS情報取得成功: $($simulatedResult.OSCaption)";
                Result = $simulatedResult;
                Timestamp = (Get-Date -Format 'yyyy-MM-dd HH:mm:ss.fff');
                ElapsedTimeSeconds = $elapsed
            })
            Write-Host "[$ComputerName] 処理完了 (成功) - 経過時間: $($elapsed)秒" -ForegroundColor Green
        }
        catch {
            $processEnd = Get-Date
            $elapsed = ($processEnd - $processStart).TotalSeconds
            $script:Errors.Add([PSCustomObject]@{
                ComputerName = $ComputerName;
                Status = 'Failed';
                Message = $_.Exception.Message;
                Timestamp = (Get-Date -Format 'yyyy-MM-dd HH:mm:ss.fff');
                ElapsedTimeSeconds = $elapsed
            })
            Write-Error "[$ComputerName] 処理中にエラーが発生しました: $($_.Exception.Message) - 経過時間: $($elapsed)秒" -ErrorAction SilentlyContinue
        }
    } -ThrottleLimit 5 # 同時に処理するホスト数（調整可能）
}

Write-Host "`n--- 処理結果サマリー ---" -ForegroundColor Yellow
Write-Host "成功: $($Results.Count) 件" -ForegroundColor Green
Write-Host "失敗: $($Errors.Count) 件" -ForegroundColor Red
Write-Host "合計処理時間: $($TotalTime.TotalSeconds) 秒" -ForegroundColor Yellow

# 結果を構造化ログとして出力

$LogData = [PSCustomObject]@{
    Timestamp = (Get-Date -Format 'yyyy-MM-dd HH:mm:ss.fff');
    TotalElapsedTimeSeconds = $TotalTime.TotalSeconds;
    SuccessfulOperations = $Results;
    FailedOperations = $Errors;
}
$LogData | ConvertTo-Json -Depth 5 | Set-Content -Path $LogFilePath -Encoding Utf8

Write-Host "詳細ログは '$LogFilePath' に出力されました。" -ForegroundColor Cyan

Stop-Transcript

# JSONログの分析例

$LogData = Get-Content -Path ".\CimMethodOperationLog-{{jst_today}}.json" | ConvertFrom-Json

Write-Host "--- 処理時間分析 ---" -ForegroundColor Yellow
$LogData.SuccessfulOperations | Sort-Object ElapsedTimeSeconds -Descending | Select-Object ComputerName, ElapsedTimeSeconds -First 5 | Format-Table -AutoSize
Write-Host "`n最も時間のかかった成功操作 (上位5件)" -ForegroundColor Cyan

$LogData.FailedOperations | Sort-Object ElapsedTimeSeconds -Descending | Select-Object ComputerName, ElapsedTimeSeconds, Message -First 5 | Format-Table -AutoSize
Write-Host "`n最も時間のかかった失敗操作 (上位5件)" -ForegroundColor Cyan