# JeaLogViewer.psrc


# 最終レビュー日: 2023年10月26日 (JST) [^2]

@{'

    # ユーザーがセッションで実行できるコマンドレットを指定

    VisibleCmdlets = @(
        @{ Name = 'Get-WinEvent'; Parameters = @{ Name = 'LogName'; ValidateSet = @('System', 'Application') }, @{ Name = 'MaxEvents'; ValidatePattern = '^\d+$' } }
        @{ Name = 'Get-EventLog'; Parameters = @{ Name = 'LogName'; ValidateSet = @('System', 'Application') }, @{ Name = 'Newest'; ValidatePattern = '^\d+$' } }
        @{ Name = 'Select-Object' }
        @{ Name = 'Format-Table' }
    )

    # JEAセッション内で使えるスクリプト関数を定義

    ScriptDefinitions = @{
        Get-AppErrors = @{
            ScriptBlock = {
                param (
                    [Parameter(Mandatory=$true)]
                    [string]$ComputerName,
                    [int]$Days = 1
                )

                # JEAセッション内でのみ実行可能なため、ComputerNameはJEAエンドポイントホスト上のGet-WinEventを実行


                # JEAエンドポイント自体がログを読み取る権限を持っている必要がある

                $startTime = (Get-Date).AddDays(-$Days)
                Get-WinEvent -LogName Application -FilterXPath "*[System[(Level=2 or Level=3) and TimeCreated[timediff(@SystemTime) <= $($Days * 24 * 60 * 60 * 1000)]]]" -ErrorAction SilentlyContinue |
                Select-Object TimeCreated, Id, LevelDisplayName, Message -First 100
            }
            Visible = $true
        }
    }

    # セッション内の変数を制限 (例: $ExecutionContext, $Host は不可)

    VisibleVariables = @()

    # モジュールのインポート

    RequiredModules = @{
        ModuleName = 'Microsoft.PowerShell.Utility' # Select-Object, Format-Table
    }
}

# JeaLogViewerConfig.pssc


# 最終レビュー日: 2023年10月26日 (JST) [^3]

@{'

    # JEAセッションであることを示す

    SessionType = 'RestrictedRemoteServer'

    # JEAセッションでコマンドを実行する際に使用するアカウント


    # RunAsVirtualAccount を指定すると、セッションごとに一時的なローカル管理者権限を持つ仮想アカウントが生成される


    # RunAsManagedServiceAccount を使用すると、既存のマネージドサービスアカウントの権限で実行可能

    RunAsVirtualAccount = $true

    # RunAsManagedServiceAccount = 'ManagedServiceAccountName$' # 例

    # トランスクリプト（セッションの記録）を保存するディレクトリ


    # JEAユーザーはディレクトリに直接アクセスできないが、JEAがログを書き込む

    TranscriptDirectory = 'C:\JEA\Transcripts'

    # トランスクリプトのファイル名に実行ユーザー名を含める

    TranscriptLogPathFromVariable = '%USERNAME%\' + (Get-Date -Format 'yyyyMMdd-HHmmss') + '.log'

    # パイプライン実行の詳細をイベントログに記録するかどうか

    LogPipelineExecutionDetails = $true

    # JEAセッションへのアクセスと役割のマッピング


    # 'JeaLogViewerGroup'というWindowsセキュリティグループのメンバーは


    # JeaLogViewer.psrc で定義された役割にマップされる

    RoleDefinitions = @{
        'JeaLogViewerGroup' = @{
            RoleCapabilities = 'C:\JEA\Roles\JeaLogViewer.psrc'
        }
    }

    # 最大アイドルタイムアウト (分)

    IdleTimeoutSec = (60 * 60) # 60分

    # JEAセッションで利用可能なPowerShellモジュール (JEAユーザーが直接Import-Moduleできないため、ここで指定)

    RequiredModules = @(
        @{ ModuleName = 'Microsoft.PowerShell.Utility' }
        @{ ModuleName = 'Microsoft.PowerShell.Management' } # Get-WinEvent など
    )
}

# JEAエンドポイントの登録と有効化


# 最終レビュー日: 2023年10月26日 (JST) [^1]

# 事前にディレクトリを作成

New-Item -Path "C:\JEA\Roles" -ItemType Directory -Force
New-Item -Path "C:\JEA\Config" -ItemType Directory -Force
New-Item -Path "C:\JEA\Transcripts" -ItemType Directory -Force

# 上記の.psrcと.psscファイルを所定のパスに保存した後、以下を実行


# (例として、上記の内容をファイルに保存済みと仮定)

$PsrcPath = "C:\JEA\Roles\JeaLogViewer.psrc"
$PsscPath = "C:\JEA\Config\JeaLogViewerConfig.pssc"

# セッション構成ファイルのハッシュを更新 (変更があった場合)

Update-PSSessionConfigurationFile -Path $PsscPath -ErrorAction Stop

# JEAエンドポイントを登録


# -Name はリモートセッションで接続する際に使用する構成名


# -Force は既存の構成を上書きする

Register-PSSessionConfiguration -Name 'JeaLogViewer' -Path $PsscPath -Force -ErrorAction Stop

# 登録されたJEAエンドポイントの確認

Get-PSSessionConfiguration -Name 'JeaLogViewer' | Select-Object Name, PSVersion, Path, RoleDefinitions

Write-Host "JEAエンドポイント 'JeaLogViewer' が登録されました。"

# テストユーザーで接続を試みる場合


# Enter-PSSession -ComputerName localhost -ConfigurationName JeaLogViewer -Credential (Get-Credential)


# その後、許可されたコマンド (例: Get-WinEvent -LogName System -MaxEvents 5) を実行して確認

<#
.SYNOPSIS
    複数のリモートホストのJEAエンドポイント経由でイベントログを収集します。
.DESCRIPTION
    指定されたコンピュータリストに対し、JEAエンドポイント 'JeaLogViewer' を使用して
    アプリケーションログからエラー/警告イベントを並列に収集します。
    Measure-Commandで実行時間を計測し、結果をCSVとして出力します。
    エラーハンドリングと再試行ロジックを含みます。
.PARAMETER ComputerName
    ログを収集するリモートコンピュータ名の配列。
.PARAMETER ConfigurationName
    接続するJEAセッション構成名。デフォルトは 'JeaLogViewer'。
.PARAMETER LogName
    収集するイベントログの名前。デフォルトは 'Application'。
.PARAMETER Days
    過去何日分のイベントを収集するか。デフォルトは1日。
.PARAMETER MaxRetryAttempts
    接続失敗時の最大再試行回数。デフォルトは3。
.PARAMETER RetryDelaySeconds
    再試行間の待機秒数。デフォルトは5秒。
.EXAMPLE
    .\Get-JeaParallelLogs.ps1 -ComputerName @('Server01', 'Server02') -Days 7 -LogName System
#>

param(
    [Parameter(Mandatory=$true)]
    [string[]]$ComputerName,

    [string]$ConfigurationName = 'JeaLogViewer',

    [ValidateSet('Application', 'System')]
    [string]$LogName = 'Application',

    [int]$Days = 1,

    [int]$MaxRetryAttempts = 3,

    [int]$RetryDelaySeconds = 5
)

# エラーアクション設定

$ErrorActionPreference = 'Continue' # エラーが発生してもスクリプトの実行を続ける

# 構造化ログ用の配列

$LogResults = [System.Collections.Generic.List[object]]::new()

# 資格情報の安全な取り扱い (SecretManagementモジュールを利用)


# JEA接続用のCredentialは、JEA利用ユーザーが直接提供するか、


# JEAホスト側でSecretManagementで管理された共有シークレットを使用する。


# ここでは、Get-Credentialでユーザーが直接入力する例を示す。


# 本番環境では SecretManagement モジュールと適切な SecretVault を使用することを強く推奨します。


# 例: Get-Secret -Name 'JeaAdminCredential' -AsCredential

$Credential = Get-Credential -Message "JEAエンドポイントへの接続に使用する資格情報を入力してください。"

# 処理開始時刻

$StartTime = Get-Date

Write-Host "--- JEA並列ログ収集を開始します (対象ホスト数: $($ComputerName.Count)) ---"

# 性能計測

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

        $retries = 0
        $success = $false
        $collectedLogs = $null
        $errorMessage = $null

        do {
            try {
                Write-Host "[$Cname] JEAセッション経由でログを収集中... (試行: $($retries + 1))"

                # JEAセッションへの接続とコマンド実行


                # JeaLogViewer.psrcで定義されたGet-AppErrors関数またはGet-WinEventが利用可能

                $collectedLogs = Invoke-Command -ComputerName $Cname `
                                -ConfigurationName $using:ConfigurationName `
                                -Credential $using:Credential `
                                -ScriptBlock {
                                    param($LogN, $D)

                                    # JEAセッション内で許可されたスクリプト関数を使用

                                    Get-AppErrors -ComputerName $env:COMPUTERNAME -Days $D # $env:COMPUTERNAME はJEAホスト名

                                    # あるいは、VisibleCmdletsで許可されたコマンドレットを直接使用


                                    # Get-WinEvent -LogName $LogN -MaxEvents 100

                                } -ArgumentList @($using:LogName, $using:Days) `
                                -SessionOption (New-PSSessionOption -OperationTimeoutSeconds 120 -IdleTimeout 3600000) `
                                -ErrorAction Stop

                $success = $true
            }
            catch {
                $retries++
                $errorMessage = $_.Exception.Message
                Write-Warning "[$Cname] エラー発生: $($errorMessage) (試行: $($retries)/$($using:MaxRetryAttempts))"
                if ($retries -lt $using:MaxRetryAttempts) {
                    Write-Host "[$Cname] $($using:RetryDelaySeconds)秒後に再試行します..."
                    Start-Sleep -Seconds $using:RetryDelaySeconds
                }
            }
        } while (-not $success -and $retries -lt $using:MaxRetryAttempts)

        # 結果を親スコープに渡すためにオブジェクトを作成

        [PSCustomObject]@{
            ComputerName = $Cname
            Status       = if ($success) {'Success'} else {'Failed'}
            ErrorMessage = $errorMessage
            LogCount     = if ($collectedLogs) {$collectedLogs.Count} else {0}
            Logs         = $collectedLogs # 生のログデータ
        }
    } -ThrottleLimit 5 # 並列実行するセッション数 (適宜調整)
}

# 結果の処理と構造化ログへの追加

$results = $Measure.ScriptBlock
foreach ($result in $results) {
    $LogResults.Add($result)
    if ($result.Status -eq 'Failed') {
        Write-Error "ホスト $($result.ComputerName) でのログ収集に失敗しました: $($result.ErrorMessage)"
    } else {
        Write-Host "ホスト $($result.ComputerName) から $($result.LogCount) 件のログを収集しました。"

        # 詳細ログをファイルに出力することも可能


        # $result.Logs | Export-Csv -Path "C:\Temp\$($result.ComputerName)_Logs.csv" -NoTypeInformation

    }
}

$EndTime = Get-Date
Write-Host "--- JEA並列ログ収集が完了しました ---"
Write-Host "合計処理時間: $($Measure.TotalSeconds) 秒"
Write-Host "処理済みホスト数: $($ComputerName.Count)"
Write-Host "成功ホスト数: $($LogResults | Where-Object Status -eq 'Success' | Measure-Object).Count"
Write-Host "失敗ホスト数: $($LogResults | Where-Object Status -eq 'Failed' | Measure-Object).Count"

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

$OutputCsvPath = "C:\JEA\Logs\JeaLogCollection_$(Get-Date -Format 'yyyyMMdd_HHmmss').csv"
$LogResults | Select-Object ComputerName, Status, LogCount, ErrorMessage | Export-Csv -Path $OutputCsvPath -NoTypeInformation -Encoding UTF8
Write-Host "詳細な処理結果は '$OutputCsvPath' に出力されました。"

# 必要に応じて、ShouldContinue で追加の操作を確認


# if ($Host.UI.PromptForChoice("確認", "追加の分析を実行しますか？", @('&はい', '&いいえ'), 0) -eq 0) {


#     Write-Host "追加分析を実行します..."


# }

# SecretManagement を使用して資格情報を取得する例 (概念コード)


# Install-Module -Name Microsoft.PowerShell.SecretManagement -Force


# Install-Module -Name Microsoft.PowerShell.SecretStore -Force # ローカル用ストア


# Register-SecretVault -Name SecretStore -ModuleName Microsoft.PowerShell.SecretStore -DefaultVault


# Set-Secret -Name 'JeaUserCredential' -Secret (Get-Credential) -Vault SecretStore

# $Credential = Get-Secret -Name 'JeaUserCredential' -AsCredential