https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/Recent content in 模块发布历史 on PowerShell 模块 DNSServer.DebugLogParserHugocnFri, 24 Jul 2026 00:00:00 +0000https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/release-v1.2.2.0/Fri, 24 Jul 2026 00:00:00 +0000https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/release-v1.2.2.0/<h2 id="新增">新增</h2> <ul> <li><strong>新增</strong>：支持读取当前由 DNS 服务打开的 DNS 服务器调试日志文件 <ul> <li>允许处理活动日志文件，无需先关闭文件</li> <li>提升对仍在写入或被其他进程占用日志的兼容性</li> <li><strong>注意</strong>：处理实时日志时需谨慎，因为记录可能不完整或处于变化中</li> </ul> </li> <li><strong>新增</strong>：支持读取源日志文件时使用 SMB/UNC 路径 <ul> <li>允许解析器处理存储在网络共享和远程位置的文件</li> <li>提高集中式或共享存储环境下的可靠性</li> </ul> </li> </ul> <h2 id="变更">变更</h2> <ul> <li><strong>模块元数据</strong>：更新 ProjectUri 和 ReleaseNotes 指向 <strong>官方网站 <a href="https://dnsserverdebuglogparser.andibellstedt.com">https://dnsserverdebuglogparser.andibellstedt.com</a></strong>，以便更好地发现和访问文档</li> <li><strong>修正文件访问</strong>：更新底层文件打开逻辑，采用基于流的访问并显式设置共享读取选项 <ul> <li>改善对实时日志文件和 UNC 共享等替代路径类型的处理</li> <li>保持本地和远程文件源的一致行为</li> </ul> </li> </ul>https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/release-v1.2.1.0/Mon, 26 Jan 2026 00:00:00 +0000https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/release-v1.2.1.0/<h2 id="变更内容">变更内容</h2> <ul> <li><strong>性能</strong>：改进了多行记录处理，避免将大文件全部加载到内存中 <ul> <li>防止在处理超大日志文件时出现内存溢出错误</li> <li>继续完全支持 PACKET 详细块和缩进的续行</li> <li>内存使用量现在与文件大小无关，保持恒定</li> </ul> </li> <li><strong>进度</strong>：新增 <code>Write-Progress</code> 以反馈处理进度 <ul> <li>进度条每处理 1000 条记录更新一次，性能影响极小</li> <li>显示当前记录数和正在处理的文件名称</li> </ul> </li> </ul>https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/release-v1.2.0.0/Sun, 25 Jan 2026 00:00:00 +0000https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/release-v1.2.0.0/<h2 id="新增">新增</h2> <ul> <li><strong>新增</strong>：DNS PACKET 详细块的多行记录处理 <ul> <li>PACKET 上下文条目现在可以包含详细的 TCP/UDP 连接信息和 DNS 消息结构</li> <li>详细块被解析为结构化的 JSON 格式，存储在新的 <code>Details</code> 列中</li> <li>包含：套接字信息、远程地址/端口、时序数据、消息结构（XID、Flags、QCOUNT 等）</li> <li>DNS 部分（QUESTION、ANSWER、AUTHORITY、ADDITIONAL）捕获完整记录详情</li> <li>详细块中的编码域名自动转换为 FQDN 格式</li> </ul> </li> <li><strong>新增</strong>：CSV 输出中的 <code>Details</code> 列 <ul> <li>包含带有详细块的 PACKET 条目的结构化 JSON 数据</li> <li>对于无详细信息的 PACKET 条目及所有非 PACKET 上下文，该列为空</li> <li>支持对 DNS 查询/响应进行深度数据包分析和取证调查</li> </ul> </li> <li><strong>新增</strong>：性能优化的 <code>NoDetailsParsing</code> 开关参数 <ul> <li>跳过对 PACKET 详细块的昂贵 JSON 解析</li> <li><em><strong>可提升</strong></em>处理速度 <strong>30-50%</strong>，适用于包含大量详细块的日志</li> <li>适合处理超大文件（100MB+）且不需要详细包结构时使用</li> <li>详细块仍收集于 Information 列，但 Details 列保持为空</li> </ul> </li> <li><strong>新增</strong>：非 PACKET 上下文的多行续行支持 <ul> <li>EVENT、Note、DSPoll 等上下文现在可跨多行</li> <li>缩进的续行自动合并至主记录的 Information 字段</li> <li>保留完整的错误信息、区域更新和诊断输出</li> </ul> </li> <li><strong>新增</strong>：<code>ContextFilter</code> 识别更多上下文类型：<code>DSPoll</code>、<code>Init</code>、<code>Lookup</code>、<code>Recurse</code>、<code>Remote</code>、<code>Tombstone</code> <ul> <li>作用：<code>Convert-DNSDebugLogFile</code> 现在可通过 <code>-ContextFilter</code> 包含/排除这些诊断和生命周期条目</li> </ul> </li> <li><strong>新增</strong>：统计输出新增两个专用文件 <ul> <li><code>_Statistic.csv</code>：按日期和上下文类型的每日记录计数（Date、Context、Count、ComputerName）</li> <li><code>_PacketStatistic.csv</code>：按日期、客户端/协议/方向/类型的每日 PACKET 计数（Date、ClientIP、Protocol、Direction、QuestionType、Count、ComputerName）</li> <li>优势：更聚焦的报告（操作上下文量与 DNS 流量细分）</li> </ul> </li> <li>PACKET 详细块的 JSON 生成经过性能优化（手动解析替代正则）</li> </ul> <h2 id="变更">变更</h2> <ul> <li><strong>重大变更</strong>：CSV 输出现在包含 18 列（在 <code>ComputerName</code> 前新增 <code>Details</code> 列） <ul> <li>新列顺序：DateTime、ThreadId、Context、PacketId、Protocol、Direction、ClientIP、Xid、Type、Opcode、FlagsHex、FlagsChar、ResponseCode、QuestionType、QuestionName、Information、<strong>Details</strong>、ComputerName</li> <li>影响：依赖列位置的脚本需更新</li> <li>优势：丰富的数据包分析能力，同时不改变现有 Information 列行为</li> </ul> </li> <li>数据行处理重构为将所有行读入内存，以便高效检测多行记录 <ul> <li>性能：由于优化的 List<string> 使用，影响极小</li> <li>优势：支持准确的前瞻检测详细块和续行</li> </ul> </li> <li>缺失或编码为空的查询名现在优雅处理（无解析错误）；CSV 输出中缺失时 QuestionName 字段为空</li> </ul> <h2 id="改进">改进</h2> <ul> <li><code>Convert-DNSDebugLogFile</code> 解析更健壮：更严格的行验证和改进的提取减少了格式错误日志产生的虚假/无效行，同时保持 CSV/统计输出格式</li> <li>PACKET 上下文检测区分简单查询和带详细块的查询</li> <li>无详细信息的 PACKET 条目后空行正确跳过</li> <li>详细块中的域名解码使用现有的 <code>ConvertTo-Fqdn</code> 函数以保持一致性</li> </ul> <h2 id="性能">性能</h2> <ul> <li>对无详细块日志保持处理速度</li> <li><code>NoDetailsParsing</code> 开关在不需要 JSON 解析时提供 30-50% 的速度提升</li> <li>多行记录处理期间高效的状态管理</li> <li>使用优化的字符串操作（TrimStart、Join）替代正则处理续行</li> </ul> <h2 id="备注">备注</h2> <ul> <li>这些更改设计为向后兼容正常使用场景。如依赖特定上下文名称集或之前严格的解析行为，请验证下游脚本</li> <li>新的 <code>Details</code> 列始终存在于 CSV 输出中；使用 <code>NoDetailsParsing</code> 可保持其为空以提升性能</li> <li>现有按列位置解析 CSV 的脚本需考虑新增的 <code>Details</code> 列（位置为第17列，位于 ComputerName 之前）</li> </ul>https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/release-v1.0.0/Fri, 23 Jan 2026 00:00:00 +0000https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/release-v1.0.0/<h3 id="新增">新增</h3> <ul> <li>初始版本发布</li> <li><code>Convert-DNSDebugLogFile</code> - 高性能解析器，用于 Windows DNS 服务器调试日志文件</li> <li>解析 DNS 调试日志中的所有 15 个标准字段，转换为结构化的 CSV 格式</li> <li>支持自定义 CSV 分隔符（默认：分号）</li> <li>可选的 ComputerName 列，便于多服务器日志合并</li> <li>三种输出模式：仅 CSV 数据、仅统计信息或两者兼有</li> <li>按客户端 IP、协议和查询类型汇总的统计摘要</li> <li>支持管道处理，实现批量处理多个日志文件</li> <li>头部验证以确保数据完整性（可根据需要绕过）</li> <li>可选自动压缩输出文件（ZIP 格式）</li> <li>处理成功后可选删除源文件</li> <li>文化感知的日期解析和格式化，适用于国际 DNS 服务器</li> <li>针对大文件（100MB 以上）优化，采用流式 I/O 和高效字符串操作</li> <li>兼容 PowerShell 5.1+（桌面版和核心版）</li> <li>支持 Windows Server 2016+ 及 DNS Server 2012 R2 至 2025 日志格式</li> </ul>https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/release-v1.1.0.0/Fri, 23 Jan 2026 00:00:00 +0000https://DNSServerDebugLogParser.andibellstedt.com/cn/changelog/release-v1.1.0.0/<h2 id="新增">新增</h2> <ul> <li><strong>新增</strong>：ContextFilter 参数用于选择性日志解析 <ul> <li>按上下文类型过滤日志条目：PACKET（DNS 查询/响应）、EVENT（服务器事件）或 Note（诊断信息）</li> <li>允许针对特定日志条目类型进行聚焦分析</li> <li>默认值：All（包含所有上下文类型）</li> <li>使用场景：仅关注 DNS 流量，监控服务器事件，排查诊断问题</li> </ul> </li> <li><strong>新增</strong>：CSV 输出中的信息字段 <ul> <li>捕获 EVENT 和 Note 上下文条目的详细信息</li> <li>示例：“DNS 服务器已启动”、“区域加载完成”、套接字错误、内部状态消息</li> <li>增强对 DNS 服务器运行事件和诊断的可见性</li> <li>当 Context 为 EVENT 或 Note 时填充该字段；PACKET 条目为空</li> </ul> </li> </ul> <h2 id="变更">变更</h2> <ul> <li><strong>重大变更</strong>：ComputerName 列现在始终包含在所有输出记录的末尾 <ul> <li>之前：ComputerName 仅在指定参数时有条件地包含在开头</li> <li>现在：ComputerName 始终作为最后一列出现；未指定参数时为空</li> <li>优点：输出结构一致，简化多服务器日志合并和自动化处理</li> <li>影响：现有解析列位置或依赖条件列存在的脚本需更新</li> </ul> </li> </ul> <h2 id="新增-1">新增</h2> <ul> <li>通过 ContextFilter 参数实现上下文过滤，聚焦特定日志条目类型（PACKET、EVENT、NOTE）</li> </ul> <h2 id="改进">改进</h2> <ul> <li>重构 Convert-DNSDebugLogFile 的注释帮助，提升清晰度和简洁性</li> <li>更新参数描述，使其更具信息性和可操作性</li> <li>改进示例文档，提供更聚焦且实用的用例</li> <li>增强 about_DNSServer.DebugLogParser 帮助文件，反映当前功能</li> <li>增强详细日志记录，提供处理过程中的更详细进度信息</li> </ul>