SetupDiag

SetupDiag について

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にあります。

アップグレード プロセスが正常に進む場合、クリーンアップのためにSetupDiag.exe を含む Sources ディレクトリが %SystemDrive%\Windows.Old の下に移動されます。 後で Windows.old ディレクトリを削除すると、 SetupDiag.exe も削除されます。

要件

1. 移行先のバージョンの Windows は、現在サポートされているバージョンの Windows である必要があります。 最初にインストールされたバージョンの Windows は、次の場合に限りサポート対象外のバージョンの Windows にすることができます。

   • 移行先のバージョンの Windows は、現在サポートされているバージョンの Windows です。
   • 移行先バージョンの Windows へのアップグレードは、インストールされた元のバージョンの Windows からサポートされています。

2. .NET Framework 4.7.2 以降をインストールする必要があります。 特定のバージョンの Windows でプレインストールされている .NET のバージョンを確認するには、「.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. Web ブラウザーでファイルの操作を求められた場合は、[保存] を選択 します。 既定では、ファイルは ダウンロード フォルダーに保存されます。 必要に応じて、[名前を付けて保存] を使用して別の場所にファイル を保存することもできます。

4. SetupDiag のダウンロードが完了したら、ファイルがダウンロードされたフォルダーを開きます。 既定では、このフォルダーはダウンロード フォルダーであり、左側のナビゲーション ウィンドウの [クイック アクセス] の下のエクスプローラーに表示されます。

5. SetupDiag ファイルをダブルクリックして実行します。 プログラムの実行を承認するように求められたら、[ はい ] を選択します。

ファイルをダブルクリックして実行すると、SetupDiag が分析を完了すると、コマンド ウィンドウが自動的に閉じます。 代わりに、ウィンドウを開いたままにして SetupDiag が生成するメッセージを確認するには、ダブルクリックするのではなく、コマンド プロンプトで 「SetupDiag 」と入力してプログラムを実行します。 コマンド プロンプトからを実行する場合は、必ず、SetupDiag が配置されている場所にディレクトリを変更してください。

1. SetupDiag がコンピューターを診断している間にコマンド ウィンドウが開きます。 このプロセスが完了するまで待ちます。

2. SetupDiag が完了すると、SetupDiag が実行されたのと同じフォルダーに 2 つのファイルが作成されます。 1 つは構成ファイル、もう 1 つはログ ファイルです。

3. メモ帳を使用して、ログ ファイル SetupDiagResults.logを開きます。

4. 表示される情報を確認します。 ルールが一致した場合、この情報には、コンピューターのアップグレードに失敗した理由と、問題を解決する方法が示されている可能性があります。 「テキスト ログのサンプル」セクションを参照してください。

オフライン モードでツールを実行する方法と、より高度なオプションを使用する方法については、「 パラメーター と例」セクション を参照してください。

パラメーター

例

• 次の例では、SetupDiag は既定のパラメーターを使用してオンライン モードで実行されます。 結果 ファイルは、 SetupDiag が実行されているのと同じフォルダーにSetupDiagResults.logされます。

  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
  

• 次の例は、Reset/Recovery Online Mode の例です。 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 セットアップはミニダンプ (setupmem.dmp) ファイルを抽出します。 SetupDiag では、これらのセットアップ関連のミニダンプをデバッグすることもできます。

セットアップ関連のバグ チェックをデバッグするには:

• /LogsPath パラメーターを指定します。 メモリ ダンプをオンライン モードでデバッグすることはできません。

• 障害が発生したシステムからセットアップ メモリ ダンプ ファイル ('setupmem.dmp) を収集します。

  Setupmem.dmpは、バグチェックが発生したタイミングに応じて、%SystemDrive%$Windows.~bt\Sources\Rollback、または %WinDir%\Panther\NewOS\Rollback で作成されます。

• SetupDiag を実行するコンピューターに Windows デバッグ ツール をインストールします。

次の例では、ファイルがディレクトリにD:\Dumpコピーされ、setupmem.dmpSetupDiag を実行する前に 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 ファイルに含まれています。 新しいバージョンの SetupDiag が使用可能になると、xml ファイルが新しい規則と更新された規則で更新される場合があります。

各ルール名とそれに関連付けられている一意のルール識別子は、既知のアップグレード ブロッキングの問題の説明と共に一覧表示されます。 ルールの説明では、 ダウン レベル という用語は、元の OS で実行されるアップグレード プロセスの最初のフェーズを指します。

サンプル ログ

テキスト ログのサンプル

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 アップグレード エラーの解決: IT 担当者向けの技術情報。