SetupDiag

Сведения об установкеDiag

SetupDiag — это средство диагностики, которое можно использовать для получения сведений о причинах неудачного обновления Windows.

SetupDiag работает путем изучения файлов журнала программы установки Windows. Он пытается проанализировать эти файлы журнала, чтобы определить основную причину сбоя при обновлении компьютера или обновлении до Windows. SetupDiag можно запустить на компьютере, который не удалось обновить. Журналы также можно экспортировать с компьютера в другое расположение, а затем запустить SetupDiag в автономном режиме.

SetupDiag входит в программу установки Windows во всех поддерживаемых в настоящее время версиях Windows.

В процессе обновления программа установки Windows извлекает все исходные файлы, включая SetupDiag.exe, в каталог %SystemDrive%$Windows.~bt\Sources . Если с обновлением возникла проблема, программа SetupDiag автоматически запускается, чтобы определить причину сбоя.

При запуске с помощью программы установки Windows используются следующие параметры :

• /ZipLogs:False
• /Format:xml
• /Output:%windir%\logs\SetupDiag\SetupDiagResults.xml
• /RegPath:HKEY_LOCAL_MACHINE\SYSTEM\Setup\SetupDiag\Results

Результирующий анализ SetupDiag можно найти по адресу %WinDir%\Logs\SetupDiag\SetupDiagResults.xml и в реестре в разделе HKLM\SYSTEM\Setup\SetupDiag\Results.

Если процесс обновления продолжается обычно, каталог Sources , включающий SetupDiag.exe , перемещается в папку %SystemDrive%\Windows.Old для очистки. Если каталог Windows.old будет удален позже, SetupDiag.exe также удаляется.

Требования

1. Целевая версия Windows должна быть поддерживаемой в настоящее время версией Windows. Изначально установленная версия Windows может быть версией Windows, которая не поддерживается, если:

   • Целевая версия Windows является поддерживаемой в настоящее время версией Windows.
   • Обновление до целевой версии Windows поддерживается с исходной установленной версии Windows.

2. необходимо установить платформа .NET Framework 4.7.2 или более поздней версии. Чтобы определить, какая версия .NET предустановлена с определенной версией Windows, см. платформа .NET Framework требования к системе: Поддерживаемые клиентские операционные системы. Сведения о том, какая версия .NET установлена в настоящее время, см. в статье Практическое руководство. Определение установленных версий платформа .NET Framework.

   Следующий запрос командной строки можно использовать для отображения текущей установленной версии .NET:

   reg.exe query "HKLM\SOFTWARE\Microsoft\Net Framework Setup\NDP\v4" /s
   

   До тех пор, пока установлена по крайней мере требуемая версия .NET, никаких дополнительных действий не требуется, в том числе при установке более новой версии.

Использование SetupDiag

Чтобы быстро использовать SetupDiag на текущем компьютере, выполните следующие действия:

1. Убедитесь, что система соответствует требованиям.

2. Скачайте SetupDiag.

3. Если веб-браузер спрашивает, что делать с файлом, нажмите кнопку Сохранить. По умолчанию файл сохраняется в папке Загрузки . При необходимости файл также можно сохранить в другом расположении с помощью команды Сохранить как.

4. Когда setupDiag завершит загрузку, откройте папку, в которой был скачан файл. По умолчанию эта папка является папкой Загрузки, которая отображается в проводник в разделе Быстрый доступ в области навигации слева.

5. Дважды щелкните файл SetupDiag, чтобы запустить его. Выберите Да , если будет предложено утвердить запуск программы.

При двойном щелчке файла для его запуска окно команд автоматически закрывается после завершения анализа setupDiag. Чтобы оставить окно открытым для просмотра сообщений, создаваемых SetupDiag, запустите программу, введя SetupDiag в командной строке, а не дважды щелкнув ее. При запуске из командной строки обязательно измените каталоги на расположение SetupDiag.

1. Откроется командное окно, когда программа SetupDiag диагностирует компьютер. Дождитесь завершения этого процесса.

2. После завершения установкиDiag в той же папке, из которой была запущена программа SetupDiag, создаются два файла. Один из них — файл конфигурации, другой — файл журнала.

3. Используйте Блокнот, чтобы открыть файл журнала SetupDiagResults.log.

4. Просмотрите отображаемые сведения. Если правило было сопоставлено, эта информация может сказать, почему не удалось выполнить обновление компьютера, и, возможно, как устранить проблему. См. раздел Пример текстового журнала.

Инструкции по запуску средства в автономном режиме и с более расширенными параметрами см. в разделах Параметры и Примеры.

Параметры

Примеры:

• В следующем примере программа SetupDiag выполняется с параметрами по умолчанию в интерактивном режиме. Файл результатов SetupDiagResults.log в той же папке, где выполняется SetupDiag.

  SetupDiag.exe
  

• В следующем примере SetupDiag выполняется в интерактивном режиме (этот режим используется по умолчанию). Он знает, где искать журналы в текущей (сбойной) системе, поэтому нет необходимости собирать журналы заранее. Указано пользовательское расположение для результатов.

  SetupDiag.exe /Output:C:\SetupDiag\Results.log
  

• В следующем примере параметр /Output используется для сохранения результатов в имени пути, содержащего пробел:

  SetupDiag /Output:"C:\Tools\SetupDiag\SetupDiag Results\Results.log"
  

• В следующем примере указывается, что SetupDiag выполняется в автономном режиме и обрабатывает файлы журналов, найденные в папке D:\Temp\Logs\LogSet1.

  SetupDiag.exe /Output:C:\SetupDiag\Results.log /LogsPath:D:\Temp\Logs\LogSet1
  

• В следующем примере задается сценарий восстановления в автономном режиме. В этом примере SetupDiag ищет журналы сброса и восстановления в указанном расположении LogsPath и выводит результаты в каталог, указанный параметром /Output .

  SetupDiag.exe /Output:C:\SetupDiag\RecoveryResults.log /LogsPath:D:\Temp\Cabs\PBR_Log /Scenario:Recovery
  

• В следующем примере задается сценарий восстановления в оперативном режиме. В этом примере SetupDiag ищет журналы сброса и восстановления в текущей системе, а выходные данные — в формате XML.

  SetupDiag.exe /Scenario:Recovery /Format:xml
  

• Ниже приведен пример автономного режима. SetupDiag содержит инструкции по анализу файлов журнала установки и обновления в каталоге LogsPath и выводу результатов в C:\SetupDiag\Results.txt.

  SetupDiag.exe /Output:C:\SetupDiag\Results.txt /LogsPath:D:\Temp\Logs\Logs1 /RegPath:HKEY_CURRENT_USER\SYSTEM\SetupDiag
  

• В следующем примере приведен пример режима "в сети". SetupDiag предписывает искать журналы установки и обновления в текущей системе и выводить результаты в формате XML в C:\SetupDiag\Results.xml.

  SetupDiag.exe /Output:C:\SetupDiag\Results.xml /Format:xml
  

• В следующем примере показан пример режима "в сети", в котором параметры не требуются и не используются. SetupDiag предписывает искать журналы установки и обновления в текущей системе и выводить результаты в тот же каталог, где находится SetupDiag.

  SetupDiag.exe
  

• Ниже приведен пример режима сброса и восстановления в автономном режиме. SetupDiag предписывает искать журналы сброса и восстановления в указанном расположении LogsPath. Затем он выводит результаты в каталог, указанный параметром /Output .

  SetupDiag.exe /Output:C:\SetupDiag\RecoveryResults.log /LogsPath:D:\Temp\Cabs\PBR_Log /Scenario:Recovery
  

• В следующем примере показан пример режима сброса и восстановления в сети. SetupDiag предписывает искать журналы сброса и восстановления в текущей системе и выводить результаты в формате XML.

  SetupDiag.exe /Scenario:Recovery /Format:xml
  

Файлы журнала

Файлы журнала установки Windows и журналы событий содержат сведения о том, где создаются журналы во время установки Windows. Для автономной обработки программа SetupDiag должна выполняться для содержимого всей папки. Например, в зависимости от того, когда произошел сбой обновления, скопируйте одну из следующих папок в автономное расположение:

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

Если родительская папка и все вложенные папки копируются, SetupDiag автоматически выполняет поиск файлов журналов во всех подкаталогах.

Анализ проверка ошибок установки

Когда Microsoft Windows сталкивается с условием, которое скомпрометирует безопасную работу системы, система останавливается. Это условие называется ошибкой проверка. Это условие также часто называется сбоем системы, ошибкой ядра, stop-ошибкой или BSOD. Обычно эта ошибка возникает на аппаратном устройстве, драйвере оборудования или связанном программном обеспечении.

Если в системе включены аварийные дампы, создается файл аварийного дампа. Если ошибка проверка возникает во время обновления, программа установки Windows извлекает файл minidump (setupmem.dmp). SetupDiag также может выполнять отладку этих мини-модулей, связанных с установкой.

Чтобы выполнить отладку проверка ошибок, связанных с установкой, выполните следующее:

• Укажите параметр /LogsPath . Дампы памяти не могут быть отлажены в оперативном режиме.

• Соберите файл дампа памяти установки (setupmem.dmp) из системы, включающей сбой.

  Setupmem.dmpсоздается в %SystemDrive%$Windows.~bt\Sources\Rollback или в %WinDir%\Panther\NewOS\Rollback в зависимости от того, когда произошла ошибка проверка.

• Установите средства отладки Windows на компьютере, на котором запущена программа SetupDiag.

В следующем примере файл копируется в D:\Dump каталог, setupmem.dmp а перед запуском SetupDiag устанавливаются средства отладки Windows:

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

Известные проблемы

• Обработка некоторых правил может занять много времени, если задействованные файлы журнала имеют большой размер.

Пример выходных данных

Следующая команда является примером, в котором SetupDiag выполняется в автономном режиме.

D:\SetupDiag>SetupDiag.exe /output:c:\setupdiag\result.xml /logspath:D:\Tests\Logs\f55be736-beed-4b9b-aedf-c133536c946e /format:xml

SetupDiag v1.7.0.0
Copyright (c) Microsoft Corporation. All rights reserved.

Searching for setup logs...
Found d:\tests\Logs\f55be736-beed-4b9b-aedf-c133536c946e\setupact_6.log with update date 6/12/2023 2:44:20 PM to be the correct setup log.
Found d:\tests\Logs\f55be736-beed-4b9b-aedf-c133536c946e\setupact_1.log with update date 6/12/2023 2:45:19 PM to be the correct rollback log.

Gathering baseline information from setup logs...

SetupDiag: processing rule: CompatScanOnly.
...No match.

...

SetupDiag: processing rule: DISMImageSessionFailure.
..
Error: SetupDiag reports DISM provider failure.
Last Phase: Safe OS
Last Operation: Apply Optional Component status
Message = Failed to get the IDismImage instance from the image session
Function: CDISMManager::CloseImageSession
Error: 0x800706ba
Recommend you re-download the update source files, reboot and try the update again.

SetupDiag found 1 matching issue.

SetupDiag results were logged to: c:\setupdiag\results.xml
Logs ZipFile created at: c:\setupdiag\Logs_14.zip

Правила

При поиске файлов журнала программа SetupDiag использует набор правил для сопоставления известных проблем. Эти правила содержатся в XML-файле. Xml-файл может быть обновлен новыми и обновленными правилами по мере того, как становятся доступными новые версии SetupDiag.

Имя каждого правила и связанный с ним уникальный идентификатор правила перечислены с описанием известной проблемы, блокирующей обновление. В описаниях правил термин нижнего уровня относится к первому этапу процесса обновления, который выполняется в исходной ОС.

Примеры журналов

Пример текстового журнала

Matching Profile found: OptionalComponentOpenPackageFailed - 22952520-EC89-4FBD-94E0-B67DF88347F6
System Information:
    Machine Name = Offline
    Manufacturer = MSI
    Model = MS-7998
    HostOSArchitecture = x64
    FirmwareType = PCAT
    BiosReleaseDate = 20160727000000.000000+000
    BiosVendor = BIOS Date: 07/27/16 10:01:46 Ver: V1.70
    BiosVersion = 1.70
    HostOSVersion = 10.0.15063
    HostOSBuildString = 15063.0.amd64fre.rs2_release.170317-1834
    TargetOSBuildString = 10.0.16299.15 (rs3_release.170928-1534)
    HostOSLanguageId = 2057
    HostOSEdition = Core
    RegisteredAV = Windows Defender,
    FilterDrivers = WdFilter,wcifs,WIMMount,luafv,Wof,FileInfo,
    UpgradeStartTime = 3/21/2023 9:47:16 PM
    UpgradeEndTime = 3/21/2023 10:02:40 PM
    UpgradeElapsedTime = 00:15:24
    ReportId = dd4db176-4e3f-4451-aef6-22cf46de8bde

Error: SetupDiag reports Optional Component installation failed to open OC Package. Package Name: Foundation, Error: 0x8007001F
Recommend you check the "Windows Modules Installer" service (Trusted Installer) is started on the system and set to automatic start, reboot and try the update again.  Optionally, you can check the status of optional components on the system (search for Windows Features), uninstall any unneeded optional components, reboot and try the update again.
Error: SetupDiag reports down-level failure, Operation: Finalize, Error: 0x8007001F - 0x50015
Refer to https://video2.skills-academy.com/windows/deployment/upgrade/upgrade-error-codes for error information.

Пример журнала XML

<?xml version="1.0" encoding="utf-16"?>
<SetupDiag xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://video2.skills-academy.com/windows/deployment/upgrade/setupdiag">
  <Version>1.7.0.0</Version>
  <ProfileName>FindSPFatalError</ProfileName>
  <ProfileGuid>A4028172-1B09-48F8-AD3B-86CDD7D55852</ProfileGuid>
  <SystemInfo>
    <MachineName>Offline</MachineName>
    <Manufacturer>Gigabyte Technology Co., Ltd.</Manufacturer>
    <Model>X470 AORUS ULTRA GAMING</Model>
    <HostOSArchitecture>1033</HostOSArchitecture>
    <FirmwareType>UEFI</FirmwareType>
    <BiosReleaseDate>20180808000000.000000+000</BiosReleaseDate>
    <BiosVendor>F3</BiosVendor>
    <BiosVersion />
    <HostOSVersion>10.0.18908</HostOSVersion>
    <HostOSBuildString>18908.1000.amd64fre.rs_prerelease.190524-1658</HostOSBuildString>
    <TargetOSBuildString>10.0.18912.1001 (rs_prerelease.190601-1739)</TargetOSBuildString>
    <HostOSLanguageId />
    <HostOSEdition>Professional</HostOSEdition>
    <RegisteredAV>Windows Defender</RegisteredAV>
    <FilterDrivers />
    <UpgradeStartTime>2023-06-06T21:19:10</UpgradeStartTime>
    <UpgradeElapsedTime />
    <UpgradeEndTime>2023-06-06T22:21:49</UpgradeEndTime>
    <RollbackStartTime>0001-01-01T00:00:00</RollbackStartTime>
    <RollbackEndTime>0001-01-01T00:00:00</RollbackEndTime>
    <RollbackElapsedTime />
    <FinalizeStartTime>0001-01-01T00:00:00</FinalizeStartTime>
    <PostOOBESuccessTime>0001-01-01T00:00:00</PostOOBESuccessTime>
    <TotalOfflineTime />
    <CommercialId>Offline</CommercialId>
    <CV>MgUweCZk90KdwUiZ</CV>
    <SetupReportId>F21F8FB6-00FD-4349-84FB-2AC75F389E73</SetupReportId>
    <ReportId>F21F8FB6-00FD-4349-84FB-2AC75F389E73</ReportId>
  </SystemInfo>
  <LogErrorLine>2023-06-06 21:47:11, Error                 SP     Error converting install time 5/2/2023 to structure[gle=0x00000057]</LogErrorLine>
  <FailureData>
Error: SetupDiag reports Fatal Error.
Last Setup Phase = Downlevel
Last Setup Operation: Gather data, scope: EVERYTHING
Error: 0x00000057</FailureData>
  <FailureData>LogEntry: 2023-06-06 21:47:11, Error                 SP     Error converting install time 5/2/2023 to structure[gle=0x00000057]</FailureData>
  <FailureData>LogEntry: 2023-06-06 21:47:11, Error                 SP     Error converting install time 5/2/2023 to structure[gle=0x00000057]</FailureData>
  <FailureData>
Refer to "https://video2.skills-academy.com/windows/desktop/Debug/system-error-codes" for error information.</FailureData>
  <FailureDetails>Err = 0x00000057, LastOperation = Gather data, scope: EVERYTHING, LastPhase = Downlevel</FailureDetails>
</SetupDiag>

Пример журнала JSON

{
    "Version":"1.6.0.0",
    "ProfileName":"FindSPFatalError",
    "ProfileGuid":"A4028172-1B09-48F8-AD3B-86CDD7D55852",
    "SystemInfo":{
        "BiosReleaseDate":"20180808000000.000000+000",
        "BiosVendor":"F3",
        "BiosVersion":"F3",
        "CV":"MgUweCZk90KdwUiZ",
        "CommercialId":"Offline",
        "FilterDrivers":"",
        "FinalizeStartTime":"\/Date(-62135568000000-0800)\/",
        "FirmwareType":"UEFI",
        "HostOSArchitecture":"x64",
        "HostOSBuildString":"18908.1000.amd64fre.rs_prerelease.190524-1658",
        "HostOSEdition":"Professional",
        "HostOSLanguageId":"",
        "HostOSVersion":"",
        "MachineName":"Offline",
        "Manufacturer":"Gigabyte Technology Co., Ltd.",
        "Model":"X470 AORUS ULTRA GAMING",
        "PostOOBESuccessTime":"\/Date(-62135568000000-0800)\/",
        "RegisteredAV":"Windows Defender",
        "ReportId":"F21F8FB6-00FD-4349-84FB-2AC75F389E73",
        "RollbackElapsedTime":"PT0S",
        "RollbackEndTime":"\/Date(-62135568000000-0800)\/",
        "RollbackStartTime":"\/Date(-62135568000000-0800)\/",
        "SetupReportId":"F21F8FB6-00FD-4349-84FB-2AC75F389E73",
        "TargetOSArchitecture":null,
        "TargetOSBuildString":"10.0.18912.1001 (rs_prerelease.190601-1739)",
        "TotalOfflineTime":"PT0S",
        "UpgradeElapsedTime":"PT1H2M39S",
        "UpgradeEndTime":"\/Date(1559884909000-0700)\/",
        "UpgradeStartTime":"\/Date(1559881150000-0700)\/"
    },
    "LogErrorLine":"2023-06-06 21:47:11, Error                 SP     Error converting install time 5\/2\/2023 to structure[
        gle=0x00000057
    ]",
    "FailureData":[
        "\u000aError: SetupDiag reports Fatal Error.\u000aLast Setup Phase = Downlevel\u000aLast Setup Operation: Gather data, scope: EVERYTHING\u000aError: 0x00000057",
        "LogEntry: 2023-06-06 21:47:11, Error                 SP     Error converting install time 5\/2\/2023 to structure[
            gle=0x00000057
        ]",
        "LogEntry: 2023-06-06 21:47:11, Error                 SP     Error converting install time 5\/2\/2023 to structure[
            gle=0x00000057
        ]",
        "\u000aRefer to \"https:\/\/video2.skills-academy.com\/windows\/desktop\/Debug\/system-error-codes\" for error information."
    ],
    "FailureDetails":"Err = 0x00000057, LastOperation = Gather data, scope: EVERYTHING, LastPhase = Downlevel",
    "DeviceDriverInfo":null,
    "Remediation":[
        
    ],
    "SetupPhaseInfo":null,
    "SetupOperationInfo":null
}

Пример раздела реестра

Связанные статьи

• Устранение ошибок обновления Windows: Техническая информация для ИТ-специалистов.