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

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

• 必需是使用 Windows 10 操作系統(tǒng)的設(shè)備
• 必須安裝 .NET Framework 4.6

如果您不確定當(dāng)前系統(tǒng)使用了哪個(gè) .NET Framework 版本，可以在 CMD 中執(zhí)行 reg query “HKLM\SOFTWARE\Microsoft\Net Framework Setup\NDP\v4” /s 命令進(jìn)行查看。

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

如何使用SetupDiag診斷工具

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

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

Windows 安裝日志文件和事件日志中包含了有關(guān) Windows 在安裝期間創(chuàng)建日志的信息。 如果要脫機(jī)模式使用 SetupDiag，就需要將以下日志文件夾復(fù)制到脫機(jī)位置：

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

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

Bug check分析

當(dāng) Windows 10 遇到危及操作系統(tǒng)安全（Kernel mode）的情況時(shí)，系統(tǒng)將會主動暫停。這種情況被專稱為「錯(cuò)誤檢查（bug check）」，通常也叫系統(tǒng)崩潰、內(nèi)核錯(cuò)誤、Stop 錯(cuò)誤或 BSOD，其實(shí)就是藍(lán)屏。。。（一般硬件驅(qū)動或相關(guān)軟件會導(dǎo)致此錯(cuò)誤）

如果你的系統(tǒng)啟用了崩潰轉(zhuǎn)儲，在藍(lán)屏?xí)r就會主動創(chuàng)建崩潰轉(zhuǎn)儲文件。如果在 Windows 10 升級過程中發(fā)生 bug check，Windows 安裝程序會自動提取一個(gè)小型轉(zhuǎn)儲 setupmem.dmp 文件，而 SetupDiag 工具也可以調(diào)試這些設(shè)置相關(guān)的 dump 文件。

要調(diào)試設(shè)置相關(guān)的 bug check 必須：

• 指定 /Mode:Offline 和 /LogsPath 參數(shù)，無法在聯(lián)機(jī)模式下調(diào)試內(nèi)存轉(zhuǎn)儲。
• 采集到 setupmem.dmp 內(nèi)存轉(zhuǎn)儲文件。（位于 %SystemDrive%$Windows.~bt\Sources\Rollback 或 %WinDir%\Panther\NewOS\Rollback 文件夾，取決于 bug check 發(fā)生的時(shí)機(jī)）~
• 執(zhí)行 SetupDiag 的計(jì)算機(jī)中安裝了 Windows Debugging Tools

在以下示例中，已經(jīng)將 setupmem.dmp 文件復(fù)制到 D:\Dump 目錄，并在運(yùn)行 SetupDiag 之前安裝了 Windows 調(diào)試工具：

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

SetupDiag工作原理

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