SetupDiag 是微軟提供的免費診斷工具，旨在幫助 IT Pro 查找和解析 Windows 10 安裝日志，以確定升級或更新未能在 Windows 10 PC 上正常安裝的根本原因。SetupDiag 可以在更新安裝失敗的計算機上直接執行診斷，也可以將日志從一臺 PC 導出到另一臺計算機，并以脫機模式運行 SetupDiag 進行分析。

使用 SetupDiag 工具有 2 個必要的前提條件：

• 必需是使用 Windows 10 操作系統的設備
• 必須安裝 .NET Framework 4.6

如果您不確定當前系統使用了哪個 .NET Framework 版本，可以在 CMD 中執行 reg query “HKLM\SOFTWARE\Microsoft\Net Framework Setup\NDP\v4” /s 命令進行查看。

Windows 10 version 1803 馬上就要發布，如果您遇到升級問題（烏鴉嘴 ），馬上就可以使用它來進行診斷咯！

如何使用SetupDiag診斷工具

在 Microsoft 官網下載 SetupDiag 工具之后就可以直接運行（聯機模式），如果不帶任何參數，它會自動嘗試查找并檢測 Windows 10 在升級過程中在設備默認文件夾中生成的升級日志文件。

命令執行完掃描后，會在 SetupDiag.exe 工具的相同目錄下生成一個名為 SetupDiagResults.log 的結果文件，其中會包含在升級日志文件中檢測到的升級問題。與此同時，還會在同一目錄下創建一個所有日志文件的 Logs.zip 打包存檔。

Windows 安裝日志文件和事件日志中包含了有關 Windows 在安裝期間創建日志的信息。 如果要脫機模式使用 SetupDiag，就需要將以下日志文件夾復制到脫機位置：

• -\$Windows.~bt\sources\panther
• \$Windows.~bt\Sources\Rollback
• \Windows\Panther
• \Windows\Panther\NewOS

如果您復制了父文件夾和所有子文件夾，SetupDiag 將自動搜索所有子目錄中的日志文件。

Bug check分析

當 Windows 10 遇到危及操作系統安全（Kernel mode）的情況時，系統將會主動暫停。這種情況被專稱為「錯誤檢查（bug check）」，通常也叫系統崩潰、內核錯誤、Stop 錯誤或 BSOD，其實就是藍屏。。。（一般硬件驅動或相關軟件會導致此錯誤）

如果你的系統啟用了崩潰轉儲，在藍屏時就會主動創建崩潰轉儲文件。如果在 Windows 10 升級過程中發生 bug check，Windows 安裝程序會自動提取一個小型轉儲 setupmem.dmp 文件，而 SetupDiag 工具也可以調試這些設置相關的 dump 文件。

要調試設置相關的 bug check 必須：

• 指定 /Mode:Offline 和 /LogsPath 參數，無法在聯機模式下調試內存轉儲。
• 采集到 setupmem.dmp 內存轉儲文件。（位于 %SystemDrive%$Windows.~bt\Sources\Rollback 或 %WinDir%\Panther\NewOS\Rollback 文件夾，取決于 bug check 發生的時機）~
• 執行 SetupDiag 的計算機中安裝了 Windows Debugging Tools

在以下示例中，已經將 setupmem.dmp 文件復制到 D:\Dump 目錄，并在運行 SetupDiag 之前安裝了 Windows 調試工具：

SetupDiag.exe /Output:C:\SetupDiag\Dumpdebug.log /Mode:Offline /LogsPath:D:\Dump

SetupDiag工作原理

其實說白了 SetupDiag 就是一個規則匹配工具，它可以自動通過微軟定義的 26 個唯一標識符來查找 Windows 10 升級日志中的匹配項。對規則的依賴意味著 SetupDiag 只能識別已經在其規則集中定義好的問題，微軟已經在 Microsoft Docs 網站上列出了共 26 個唯一標識符。