---
generated_at: 2026-02-18 17:30:00
metrics:
  claims_total: 116
  claims_with_evidence: 116
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート：public-XE.csv

## 本レポートについて

### 目的
本レポートは、生成された単体テストケース一覧の信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**1.00**
  - 根拠あり：116 / 116、根拠なし：0
- 優先レビュー（高）
  1. なし - 全てのテストケースがソースコードに基づいて生成されている

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `public/ConvertTo-DbaXESession.ps1` - トレースからXEへの変換コマンド
- E-02: `public/Copy-DbaXESession.ps1` - XEセッションコピーコマンド
- E-03: `public/Copy-DbaXESessionTemplate.ps1` - XEテンプレートコピーコマンド
- E-04: `public/Export-DbaXESession.ps1` - XEセッションエクスポートコマンド
- E-05: `public/Export-DbaXESessionTemplate.ps1` - XEテンプレートエクスポートコマンド
- E-06: `public/Get-DbaXEObject.ps1` - XEオブジェクト取得コマンド
- E-07: `public/Get-DbaXESession.ps1` - XEセッション取得コマンド
- E-08: `public/Get-DbaXESessionTarget.ps1` - XEセッションターゲット取得コマンド
- E-09: `public/Get-DbaXESessionTargetFile.ps1` - XEターゲットファイル取得コマンド
- E-10: `public/Get-DbaXESessionTemplate.ps1` - XEテンプレート取得コマンド
- E-11: `public/Get-DbaXEStore.ps1` - XEストア取得コマンド
- E-12: `public/Import-DbaXESessionTemplate.ps1` - XEテンプレートインポートコマンド
- E-13: `public/Invoke-DbaXEReplay.ps1` - XEリプレイコマンド
- E-14: `public/New-DbaXESession.ps1` - XEセッション新規作成コマンド
- E-15: `public/Read-DbaXEFile.ps1` - XEファイル読み込みコマンド
- E-16: `public/Remove-DbaXESession.ps1` - XEセッション削除コマンド
- E-17: `public/Start-DbaXESession.ps1` - XEセッション開始コマンド
- E-18: `public/Stop-DbaXESession.ps1` - XEセッション停止コマンド
- E-19: `public/Watch-DbaXESession.ps1` - XEセッションリアルタイム監視コマンド

## 3) Claims と根拠の対応（レビューの主戦場）

### ConvertTo-DbaXESession (UT-XEV-001 ~ UT-XEV-005)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | トレースからXEセッションへの変換が可能 | E-01: L116-184 InputObjectのforeachループで変換処理 | ○ |
| C-02 | OutputScriptOnlyでT-SQLスクリプト出力 | E-01: L165-166 `if ($OutputScriptOnly) { $results }` | ○ |
| C-03 | 同名セッション存在時の自動リネーム | E-01: L140-151 Name-traceId, Name-Randomの生成 | ○ |
| C-04 | 不正入力オブジェクトの検出 | E-01: L117-120 id/Parentプロパティのチェック | ○ |
| C-05 | SQL Server 2012未満のバージョンチェック | E-01: L124-127 VersionMajor < 11 チェック | ○ |

### Copy-DbaXESession (UT-XEV-006 ~ UT-XEV-013)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-06 | セッションのソースから宛先へのコピー | E-02: L191-205 ScriptCreate().GetScript()とQuery実行 | ○ |
| C-07 | 実行中セッションの状態継承 | E-02: L199-202 IsRunning時のStart()呼び出し | ○ |
| C-08 | Forceオプションによる上書き | E-02: L173-188 Force時のDrop()処理 | ○ |
| C-09 | XeSessionパラメータのフィルタリング | E-02: L127-129 Where-Object Name -In $XeSession | ○ |
| C-10 | ExcludeXeSessionの除外フィルタ | E-02: L130-132 Where-Object Name -NotIn $ExcludeXeSession | ○ |
| C-11 | システムセッションの自動除外 | E-02: L126 AlwaysOn_health, system_health除外 | ○ |
| C-12 | Force無しでの重複スキップ | E-02: L162-172 Status=Skipped設定 | ○ |
| C-13 | 接続エラーハンドリング | E-02: L121-124 Stop-Function呼び出し | ○ |

### Copy-DbaXESessionTemplate (UT-XEV-014 ~ UT-XEV-017)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-14 | テンプレートのSSMSディレクトリコピー | E-03: L67-72 Copy-Item処理 | ○ |
| C-15 | 宛先ディレクトリの自動作成 | E-03: L60-66 New-Item -ItemType Directory | ○ |
| C-16 | カスタムパスからのコピー | E-03: L53 Path パラメータ定義 | ○ |
| C-17 | ディレクトリ作成失敗時のエラー | E-03: L64 Stop-Function呼び出し | ○ |

### Export-DbaXESession (UT-XEV-018 ~ UT-XEV-024)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-18 | T-SQLスクリプトのファイル出力 | E-04: L199-213 Out-File処理 | ○ |
| C-19 | Passthruオプションのコンソール出力 | E-04: L194-198 if ($Passthru) { $sql } | ○ |
| C-20 | Appendモードでの追記 | E-04: L208, L212 -Append:$Append オプション | ○ |
| C-21 | NoPrefixオプションのヘッダー除外 | E-04: L180-184 prefix = $null 設定 | ○ |
| C-22 | BatchSeparatorのカスタマイズ | E-04: L186-192 BatchSeparator処理 | ○ |
| C-23 | NoClobberによる上書き防止 | E-04: L205-207 Stop-Function呼び出し | ○ |
| C-24 | 必須パラメータ検証 | E-04: L152-155 SqlInstance/InputObject無し時のエラー | ○ |

### Export-DbaXESessionTemplate (UT-XEV-025 ~ UT-XEV-029)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-25 | XMLテンプレートエクスポート | E-05: L119 SaveSessionToTemplate呼び出し | ○ |
| C-26 | セッションフィルタリング | E-05: L85 Session パラメータ定義 | ○ |
| C-27 | FilePathでのファイル名指定 | E-05: L115-117 FilePath設定処理 | ○ |
| C-28 | 存在しないパスのエラー | E-05: L111-113 Stop-Function呼び出し | ○ |
| C-29 | 接続エラーハンドリング | E-05: L103-105 Stop-Function呼び出し | ○ |

### Get-DbaXEObject (UT-XEV-030 ~ UT-XEV-034)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-30 | XEオブジェクト一覧取得 | E-06: L90-115 sys.dm_xe_packages/objects クエリ | ○ |
| C-31 | Typeパラメータのフィルタリング | E-06: L84-89 where句の動的生成 | ○ |
| C-32 | 複数サーバー対応 | E-06: L117-130 foreach ($instance in $SqlInstance) | ○ |
| C-33 | 出力プロパティ検証 | E-06: L93-108 SELECT句のカラム定義 | ○ |
| C-34 | 接続エラーハンドリング | E-06: L121-123 Stop-Function呼び出し | ○ |

### Get-DbaXESession (UT-XEV-035 ~ UT-XEV-040)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-35 | XEセッション一覧取得 | E-07: L111 $XEStore.sessions | ○ |
| C-36 | セッション名フィルタリング | E-07: L113-115 Where-Object Name -in $Session | ○ |
| C-37 | Statusプロパティ設定 | E-07: L118 Running/Stopped切り替え | ○ |
| C-38 | TargetFileパス解決 | E-07: L119-132 ファイルパス処理 | ○ |
| C-39 | パイプライン入力対応 | E-07: L91 parameter(Mandatory, ValueFromPipeline) | ○ |
| C-40 | 接続エラーハンドリング | E-07: L106-108 Stop-Function呼び出し | ○ |

### Get-DbaXESessionTarget (UT-XEV-041 ~ UT-XEV-045)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-41 | ターゲット一覧取得 | E-08: L128 foreach ($xtarget in $xsession.Targets) | ○ |
| C-42 | Targetパラメータのフィルタリング | E-08: L129 if ($Target -and $xtarget.Name -notin $Target) | ○ |
| C-43 | パイプライン入力対応 | E-08: L103-104 ParameterSetName = "piped" | ○ |
| C-44 | ファイルパス解決 | E-08: L131-144 TargetFile/RemoteTargetFile設定 | ○ |
| C-45 | SessionStatus設定 | E-08: L125 status = Running/Stopped | ○ |

### Get-DbaXESessionTargetFile (UT-XEV-046 ~ UT-XEV-050)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-46 | ターゲットファイル取得 | E-09: L118, L128, L132 Get-ChildItem呼び出し | ○ |
| C-47 | パイプライン入力対応 | E-09: L83-84 ParameterSetName = "piped" | ○ |
| C-48 | リモートUNCアクセス | E-09: L111-112 RemoteTargetFile使用 | ○ |
| C-49 | ファイルなしセッションのエラー | E-09: L103-105 Stop-Function呼び出し | ○ |
| C-50 | 不正オブジェクト型のエラー | E-09: L137-139 Stop-Function呼び出し | ○ |

### Get-DbaXESessionTemplate (UT-XEV-051 ~ UT-XEV-056)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-51 | テンプレート一覧取得 | E-10: L113 Get-ChildItem *.xml | ○ |
| C-52 | Patternパラメータの検索 | E-10: L128-147 パターンマッチング処理 | ○ |
| C-53 | Templateパラメータのフィルタリング | E-10: L115-117 Where-Object BaseName -in $Template | ○ |
| C-54 | カスタムパス対応 | E-10: L100 Path パラメータ定義 | ○ |
| C-55 | 出力プロパティ検証 | E-10: L138-147, L150-159 PSCustomObject定義 | ○ |
| C-56 | XMLパースエラー | E-10: L122-124 Stop-Function呼び出し | ○ |

### Get-DbaXEStore (UT-XEV-057 ~ UT-XEV-060)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-57 | XEStoreオブジェクト取得 | E-11: L73-75 XEStore作成 | ○ |
| C-58 | 複数サーバー対応 | E-11: L66 foreach ($instance in $SqlInstance) | ○ |
| C-59 | 出力プロパティ検証 | E-11: L80 Select-DefaultView定義 | ○ |
| C-60 | 接続エラーハンドリング | E-11: L69-71 Stop-Function呼び出し | ○ |

### Import-DbaXESessionTemplate (UT-XEV-061 ~ UT-XEV-069)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-61 | テンプレートからセッション作成 | E-12: L247 CreateSessionFromTemplate呼び出し | ○ |
| C-62 | Nameパラメータのカスタム名 | E-12: L225-227 Name設定処理 | ○ |
| C-63 | StartUpState=Onの自動開始 | E-12: L252-258 AutoStart設定とStart呼び出し | ○ |
| C-64 | TargetFilePathの変更 | E-12: L179-218 ファイルパス置換処理 | ○ |
| C-65 | カスタムXMLインポート | E-12: L169-177 ファイルからXML読み込み | ○ |
| C-66 | 必須パラメータ検証 | E-12: L140-142 Path/Template両方なしエラー | ○ |
| C-67 | 同名セッション重複チェック | E-12: L241-243 Stop-Function呼び出し | ○ |
| C-68 | バージョン互換性チェック | E-12: L230-239 no2012/no2014チェック | ○ |
| C-69 | 無効テンプレート名エラー | E-12: L162-166 Stop-Function呼び出し | ○ |

### Invoke-DbaXEReplay (UT-XEV-070 ~ UT-XEV-076)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-70 | SQLリプレイ実行 | E-13: L141-154 sqlcmd実行 | ○ |
| C-71 | Databaseパラメータ | E-13: L89 Database パラメータ定義 | ○ |
| C-72 | Eventパラメータのフィルタ | E-13: L112-113 Name -notin $Event チェック | ○ |
| C-73 | Rawオプション | E-13: L138-146 Raw時の処理分岐 | ○ |
| C-74 | 複数サーバー対応 | E-13: L130 foreach ($instance in $SqlInstance) | ○ |
| C-75 | sqlcmd依存チェック | E-13: L105-108 Get-Command sqlcmd | ○ |
| C-76 | ALTER EVENT SESSION除外 | E-13: L117, L122 -notmatch "ALTER EVENT SESSION" | ○ |

### New-DbaXESession (UT-XEV-077 ~ UT-XEV-080)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-77 | 新規セッション作成 | E-14: L81 CreateSession($Name) | ○ |
| C-78 | 複数サーバー対応 | E-14: L69 foreach ($instance in $SqlInstance) | ○ |
| C-79 | WhatIf対応 | E-14: L76 $Pscmdlet.ShouldProcess | ○ |
| C-80 | 接続エラーハンドリング | E-14: L72-74 Stop-Function呼び出し | ○ |

### Read-DbaXEFile (UT-XEV-081 ~ UT-XEV-089)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-81 | XEファイル読み込み | E-15: L122, L128 Read-XEvent呼び出し | ○ |
| C-82 | Rawオプション | E-15: L120-125 Raw時の処理分岐 | ○ |
| C-83 | Get-ChildItemパイプライン | E-15: L90-91 FileInfo処理 | ○ |
| C-84 | Get-DbaXESessionパイプライン | E-15: L93-113 Session処理 | ○ |
| C-85 | 実行中セッションのファイルスキップ | E-15: L107-109 Select-Object -SkipLast 1 | ○ |
| C-86 | 動的プロパティ設定 | E-15: L143-158 hash設定処理 | ○ |
| C-87 | ファイル存在チェック | E-15: L116-118 Test-Path チェック | ○ |
| C-88 | 不正オブジェクト型エラー | E-15: L111-113 Stop-Function呼び出し | ○ |
| C-89 | ファイルなしセッションエラー | E-15: L94-96 Stop-Function呼び出し | ○ |

### Remove-DbaXESession (UT-XEV-090 ~ UT-XEV-096)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-90 | セッション削除 | E-16: L123 xe.Drop() | ○ |
| C-91 | AllSessionsの一括削除 | E-16: L153-156 AllSessionsフィルタ | ○ |
| C-92 | システムセッション保護 | E-16: L154 systemSessions配列定義 | ○ |
| C-93 | パイプライン入力対応 | E-16: L107 ParameterSetName = 'Object' | ○ |
| C-94 | WhatIf対応 | E-16: L121 $Pscmdlet.ShouldProcess | ○ |
| C-95 | Confirm対応 | E-16: L91 ConfirmImpact = 'High' | ○ |
| C-96 | 削除エラーハンドリング | E-16: L131-133 Stop-Function呼び出し | ○ |

### Start-DbaXESession (UT-XEV-097 ~ UT-XEV-103)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-97 | セッション開始 | E-17: L154 xe.Start() | ○ |
| C-98 | AllSessionsの一括開始 | E-17: L206-211 AllSessionsフィルタ | ○ |
| C-99 | StartAtスケジュール | E-17: L214-216 New-Job呼び出し | ○ |
| C-100 | StopAtスケジュール | E-17: L221-223 New-Job呼び出し | ○ |
| C-101 | パイプライン入力対応 | E-17: L199-200 InputObject処理 | ○ |
| C-102 | 既存実行中の警告 | E-17: L159-161 Write-Message -Level Warning | ○ |
| C-103 | 開始エラーハンドリング | E-17: L155-157 Stop-Function呼び出し | ○ |

### Stop-DbaXESession (UT-XEV-104 ~ UT-XEV-110)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-104 | セッション停止 | E-18: L130 xe.Stop() | ○ |
| C-105 | AllSessionsの一括停止 | E-18: L153-158 AllSessionsフィルタ | ○ |
| C-106 | システムセッション保護 | E-18: L156 systemSessions配列定義 | ○ |
| C-107 | パイプライン入力対応 | E-18: L144-147 InputObject処理 | ○ |
| C-108 | 既存停止中の警告 | E-18: L135-137 Write-Message -Level Warning | ○ |
| C-109 | WhatIf対応 | E-18: L128 $Pscmdlet.ShouldProcess | ○ |
| C-110 | 停止エラーハンドリング | E-18: L131-133 Stop-Function呼び出し | ○ |

### Watch-DbaXESession (UT-XEV-111 ~ UT-XEV-116)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-111 | リアルタイム監視 | E-19: L128 Read-XEvent呼び出し | ○ |
| C-112 | Rawオプション | E-19: L124-126 Raw時の処理分岐 | ○ |
| C-113 | パイプライン入力対応 | E-19: L87-88 ValueFromPipeline | ○ |
| C-114 | 動的プロパティ設定 | E-19: L130-144 hash設定処理 | ○ |
| C-115 | 停止中セッションエラー | E-19: L102-104 Stop-Function呼び出し | ○ |
| C-116 | セッション停止検知 | E-19: L147-153 Status確認とStop-Function | ○ |

## 4) 不足情報（Unknown / Missing）
- なし - 全てのテストケースがソースコードの実装に基づいて生成されている

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - 全てのテストケースがソースコードから直接導出されている

### 確認推奨項目
1. **実際のSQL Server環境でのテスト**: XEセッション操作はSQL Server環境依存のため、実環境でのテスト実施を推奨
2. **SQL Server Agentジョブ関連**: Start-DbaXESessionのStartAt/StopAtはSQL Server Agentに依存
3. **ファイルシステムアクセス**: Read-DbaXEFile, Get-DbaXESessionTargetFileはファイルシステム権限に依存
4. **リモートサーバーアクセス**: UNC共有経由のファイルアクセスはネットワーク環境に依存

## 6) レビュアーチェックリスト（最小）
- [ ] 各コマンドの基本機能（正常系）テストケースが網羅されているか確認
- [ ] パラメータバリデーション（異常系）テストケースが適切か確認
- [ ] システムセッション保護（AlwaysOn_health, system_health, telemetry_xevents）が考慮されているか確認
- [ ] パイプライン入力対応のテストケースが含まれているか確認
- [ ] SQL Serverバージョン要件（2008/2012以上）のテストが含まれているか確認
- [ ] ファイルパス解決（ローカル/UNC）のテストが適切か確認
