# Measure-Command の基本的な使用例


# 前提: PowerShell 5.1 以降

Write-Host "性能計測を開始します..."

$scriptBlock = {

    # 時間がかかる処理をシミュレート

    Start-Sleep -Seconds 2
    Get-Process | Where-Object {$_.CPU -gt 0} | Select-Object -First 5
}

$measurement = Measure-Command -Expression $scriptBlock

Write-Host "スクリプトブロックの実行時間: $($measurement.TotalSeconds) 秒"
Write-Host "Ticks: $($measurement.Ticks)"

# 詳細なプロパティも利用可能


# Write-Host "TotalMilliseconds: $($measurement.TotalMilliseconds)"


# Write-Host "Minutes: $($measurement.Minutes)"

# 並列処理と性能計測の例


# 前提: PowerShell 7.0 以降


# 実行前に、ログ出力ディレクトリを作成してください: mkdir C:\Temp\PowerShellLogs


# このスクリプトは、複数のリモートサーバー (または仮想的なタスク) に対して


# 何らかの処理をシミュレートし、その性能を計測します。

$targets = 1..20 | ForEach-Object { "Server-$_" } # 20個の仮想ターゲット

$logFilePath = "C:\Temp\PowerShellLogs\Parallel_Task_Log_$(Get-Date -Format 'yyyyMMddHHmmss').json"
$transcriptPath = "C:\Temp\PowerShellLogs\Transcript_Parallel_$(Get-Date -Format 'yyyyMMddHHmmss').log"

# スクリプト全体のトランスクリプトログを開始

Start-Transcript -Path $transcriptPath -NoClobber -Append

Write-Host "並列タスク処理を開始します。ログファイル: $logFilePath"
Write-Host "ターゲット数: $($targets.Count)、並列実行数 (ThrottleLimit): 5"

try {

    # 性能計測を開始

    $overallMeasurement = Measure-Command -Expression {
        $results = $targets | ForEach-Object -Parallel {
            param($target)

            $taskId = [Guid]::NewGuid().ToString()
            $startTime = Get-Date

            Write-Host "[$(Get-Date -Format 'HH:mm:ss')] INFO: TaskId $taskId - 処理開始: $target"

            $maxRetries = 3
            $retryDelaySeconds = 2
            $attempt = 0
            $success = $false
            $errorMessage = $null

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

                    # 仮想的なタスク処理 (ここではランダムに成功/失敗をシミュレート)

                    $processTime = Get-Random -Minimum 1 -Maximum 5 # 1-5秒の処理時間
                    Start-Sleep -Seconds $processTime

                    if ($target -eq 'Server-5' -and $attempt -lt 2) { # Server-5 は最初の1回は失敗
                        throw "仮想エラー: $target で一時的な接続障害が発生しました。"
                    }
                    if ($target -eq 'Server-10' -and $attempt -lt 3) { # Server-10 は最初の2回は失敗
                        throw "仮想エラー: $target で認証失敗しました。"
                    }

                    Write-Host "[$(Get-Date -Format 'HH:mm:ss')] INFO: TaskId $taskId - 処理成功: $target (試行 $attempt/$maxRetries)"
                    $success = $true
                    break # 成功したらループを抜ける
                }
                catch {
                    $errorMessage = $_.Exception.Message
                    Write-Warning "[$(Get-Date -Format 'HH:mm:ss')] WARN: TaskId $taskId - エラー発生: $target - $errorMessage (試行 $attempt/$maxRetries)"
                    if ($attempt -lt $maxRetries) {
                        Write-Host "[$(Get-Date -Format 'HH:mm:ss')] INFO: TaskId $taskId - 再試行します ($retryDelaySeconds 秒後)..."
                        Start-Sleep -Seconds $retryDelaySeconds
                    }
                }
            }

            $endTime = Get-Date
            $durationSeconds = ($endTime - $startTime).TotalSeconds

            $logEntry = [PSCustomObject]@{
                Timestamp       = $startTime.ToString('yyyy-MM-dd HH:mm:ss.fff')
                TaskId          = $taskId
                Target          = $target
                Status          = if ($success) { "Success" } else { "Failed" }
                DurationSeconds = [Math]::Round($durationSeconds, 2)
                Message         = if ($success) { "処理が完了しました。" } else { "処理が最終的に失敗しました。エラー: $errorMessage" }
                Retries         = $attempt - 1
            }

            # 構造化ログをファイルに追記


            # 各Runspace (スレッド) からのファイル書き込み競合を避けるため、


            # -Append を利用するか、一箇所でまとめて書き込むのが安全ですが、


            # この例ではシンプルに個々で追記します。


            # 大規模な場合はキューイングし、メインスレッドでまとめて書き出すのがベストプラクティスです。

            $logEntry | ConvertTo-Json -Depth 3 | Add-Content -Path $logFilePath -Encoding UTF8

            # 結果をパイプラインで返す (Measure-Command の結果には含まれない)

            $logEntry
        } -ThrottleLimit 5 # 同時実行数
    }

    Write-Host "============================================="
    Write-Host "全並列タスクが完了しました。"
    Write-Host "全体の実行時間: $($overallMeasurement.TotalSeconds) 秒"
    Write-Host "詳細ログ: $logFilePath"
    Write-Host "============================================="

}
catch {
    Write-Error "スクリプト実行中に致命的なエラーが発生しました: $($_.Exception.Message)"
}
finally {

    # スクリプト全体のトランスクリプトログを終了

    Stop-Transcript
}

# 再試行とタイムアウトの概念を示すスクリプト例


# 前提: PowerShell 5.1 以降


# 実行前に、ログ出力ディレクトリを作成してください: mkdir C:\Temp\PowerShellLogs

$logFilePath = "C:\Temp\PowerShellLogs\Retry_Task_Log_$(Get-Date -Format 'yyyyMMddHHmmss').json"
$resourceName = "ImportantServiceAPI"
$maxRetries = 5
$retryDelaySeconds = 5 # 再試行間の待ち時間
$timeoutSeconds = 30   # 処理全体のタイムアウト
$scriptStartTime = Get-Date

Write-Host "リソース '$resourceName' へのアクセスを試行します。ログファイル: $logFilePath"

$attempt = 0
$success = $false
$lastError = $null

while ($attempt -lt $maxRetries -and (New-TimeSpan -Start $scriptStartTime -End (Get-Date)).TotalSeconds -lt $timeoutSeconds) {
    $attempt++
    Write-Host "[$(Get-Date -Format 'HH:mm:ss')] INFO: 試行 $attempt/$maxRetries - リソース '$resourceName' に接続中..."

    try {

        # ここに実際の処理を記述 (例: Invoke-RestMethod, Get-CimInstance など)


        # 仮想的なエラーシミュレーション

        if ($attempt -lt 3) { # 最初の2回はエラーを発生させる
            throw "ネットワーク接続が不安定です"
        }
        if ($attempt -eq 4 -and $resourceName -eq "ImportantServiceAPI") { # 4回目はサービスエラー
            throw "サービス応答がタイムアウトしました"
        }

        # 処理が成功した場合

        Write-Host "[$(Get-Date -Format 'HH:mm:ss')] INFO: リソース '$resourceName' への接続に成功しました。"
        $success = $true
        break # 成功したらループを抜ける
    }
    catch {
        $lastError = $_.Exception.Message
        Write-Warning "[$(Get-Date -Format 'HH:mm:ss')] WARN: エラー発生: $lastError"

        if ($attempt -lt $maxRetries) {
            Write-Host "[$(Get-Date -Format 'HH:mm:ss')] INFO: 再試行します ($retryDelaySeconds 秒後)..."
            Start-Sleep -Seconds $retryDelaySeconds
        }
        else {
            Write-Host "[$(Get-Date -Format 'HH:mm:ss')] ERROR: 最大試行回数 ($maxRetries) に達しました。"
        }
    }
}

$endTime = Get-Date
$durationSeconds = ($endTime - $scriptStartTime).TotalSeconds

$logEntry = [PSCustomObject]@{
    Timestamp       = $scriptStartTime.ToString('yyyy-MM-dd HH:mm:ss.fff')
    Resource        = $resourceName
    Status          = if ($success) { "Success" } else { "Failed" }
    Attempts        = $attempt
    DurationSeconds = [Math]::Round($durationSeconds, 2)
    Message         = if ($success) { "リソース処理が完了しました。" } else { "リソース処理が最終的に失敗しました。エラー: $lastError" }
}

$logEntry | ConvertTo-Json -Depth 3 | Add-Content -Path $logFilePath -Encoding UTF8

if ($success) {
    Write-Host "処理が正常に完了しました。詳細ログ: $logFilePath"
}
else {
    Write-Error "処理が失敗しました。詳細ログ: $logFilePath"
}

# 機密情報を取り扱う場合の言及


# 資格情報など機密性の高い情報は、ハードコードせずに


# PowerShell SecretManagement モジュールなどを利用して安全に取り扱うべきです。


# Install-Module -Name Microsoft.PowerShell.SecretManagement, Microsoft.PowerShell.SecretStore


# Set-Secret -Name "MyServiceCredential" -Secret (Get-Credential) -Vault SecretStore


# $cred = Get-Secret -Name "MyServiceCredential" -Vault SecretStore