SetupDiag
適用対象
- Windows 10
注
これは 300 レベルのトピック (中程度の高度なトピック) です。
この記事のトピックの完全な一覧については、「Windows 10 のアップグレード エラーの解決」をご覧ください。
SetupDiag について
SetupDiag の現在のダウンロード可能なバージョン: 1.6.2107.27002。
新しい機能や既知の問題の修正にアクセスできるように、常に最新バージョンの SetupDiag を実行してください。
SetupDiag は、Windows 10アップグレードが失敗した理由の詳細を取得するために使用できる診断ツールです。
SetupDiag は、Windows セットアップ ログ ファイルを調べることで機能します。 これらのログ ファイルを解析して、コンピューターを更新またはWindows 10にアップグレードできない根本的な原因を特定しようとします。 SetupDiag は、更新に失敗したコンピューターで実行することも、コンピューターから別の場所にログをエクスポートしてオフライン モードで SetupDiag を実行することもできます。
Windows 10 バージョン 2004 以降の SetupDiag
Windows 10 バージョン 2004 のリリースでは、SetupDiag が Windows セットアップに含まれています。
アップグレード プロセス中、Windows セットアップでは、すべてのソース ファイルが %SystemDrive%$Windows.~bt\Sources ディレクトリに 抽出されます。 Windows 10 バージョン 2004 以降では、 setupdiag.exeもこのディレクトリにインストールされます。 アップグレードに問題がある場合は、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 を手動で実行する場合、レジストリ パスは既定のレジストリ パスと同じではないことに注意してください。 SetupDiag が手動で実行され、/RegPath パラメーターが指定されていない場合、データは HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag のレジストリに格納されます。
重要
SetupDiag が複数のエラーがあったことを示す場合、ログ ファイルの最後のエラーは通常、最初のエラーではなく致命的なエラーです。
アップグレード プロセスが正常に進む場合、クリーンアップのためにsetupdiag.exeを含む Sources ディレクトリが %SystemDrive%\Windows.Old の下に移動されます。 後で Windows.old ディレクトリを削除すると、 setupdiag.exe も削除されます。
SetupDiag の使用
現在のコンピューターで SetupDiag をすばやく使用するには:
- システムが以下に説明する 要件 を満たしていることを確認します。 必要に応じて、 .NET Framework 4.6 をインストールします。
- SetupDiag をダウンロードします。
- Web ブラウザーでファイルの操作を求められた場合は、[保存] を選択 します。 既定では、ファイルは ダウンロード フォルダーに保存されます。 必要に応じて、[名前を付けて 保存] を使用して別の場所に保存することもできます。
- SetupDiag のダウンロードが完了したら、ファイルをダウンロードしたフォルダーを開きます。 既定では、このフォルダーはダウンロード フォルダーであり、左側のナビゲーション ウィンドウの [クイック アクセス] の下のエクスプローラーに表示されます。
- SetupDiag ファイルをダブルクリックして実行します。 プログラムの実行を承認するように求められた場合は、[ はい ] を選択します。
- ファイルをダブルクリックして実行すると、SetupDiag の分析が完了すると、コマンド ウィンドウが自動的に閉じます。 代わりにこのウィンドウを開いたままにし、表示されるメッセージを確認する場合は、ダブルクリックするのではなく、コマンド プロンプトで 「SetupDiag 」と入力してプログラムを実行します。 この方法で実行するには、ディレクトリを SetupDiag の場所に変更する必要があります。
- SetupDiag がコンピューターを診断している間、コマンド ウィンドウが開きます。 このプロセスが完了するまで待ちます。
- SetupDiag が完了すると、SetupDiag をダブルクリックしたのと同じフォルダーに 2 つのファイルが作成されます。 1 つは構成ファイル、もう 1 つはログ ファイルです。
- メモ帳を使用して、ログ ファイル SetupDiagResults.log を開きます。
- 表示される情報を確認します。 ルールが一致した場合、この情報は、コンピューターのアップグレードに失敗した理由と、問題を解決する方法を示します。 以下の テキスト ログ サンプル を参照してください。
オフライン モードでツールを実行する方法と、より高度なオプションを使用する方法については、以下の 「パラメーター と例」セクション を 参照してください。
この記事の下部にある リリース ノート セクションには、このツールの最近の更新に関する情報があります。
要件
宛先 OS はWindows 10する必要があります。
.NET Framework 4.6 をインストールする必要があります。 現在インストールされている .NET のバージョンがわからない場合は、「方法: インストールされている.NET Frameworkバージョンを確認する」を参照してください。 次のコマンド ライン クエリを使用して、インストールされている v4 バージョンを表示することもできます。
reg query "HKLM\SOFTWARE\Microsoft\Net Framework Setup\NDP\v4" /s
パラメーター
| パラメーター | 説明 |
|---|---|
| /? |
|
| /Output:<path to results file> |
|
| /LogsPath:<ログへのパス> |
|
| /ZipLogs:<True |False> |
|
| /Format:<xml | json> |
|
| /Scenario:[Recovery] |
|
| /Verbose |
|
| /NoTel |
|
| /AddReg |
|
| /RegPath |
|
注: /Mode パラメーターは、SetupDiag のバージョン 1.4.0.0 では非推奨です。
- 以前のバージョンでは、このコマンドは LogsPath パラメーターと共に使用され、SetupDiag をオフラインで実行して、別のコンピューターからキャプチャされた一連のログ ファイルを分析するように指定していました。 バージョン 1.4.0.0 では、/LogsPath を指定すると、SetupDiag は自動的にオフライン モードで実行されるため、/Mode パラメーターは必要ありません。
例:
次の例では、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
ログ ファイル
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 デバッグ ツール をインストールします。
次の例では、 setupmem.dmp ファイルが D:\Dump ディレクトリにコピーされ、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.6.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/2019 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/2019 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 は一連のルールを使用して既知の問題と照合します。 これらの規則は、SetupDiag の実行時に抽出されるrules.xml ファイルに含まれています。 新しいバージョンの SetupDiag が使用可能になると、rules.xml ファイルが更新される可能性があります。 詳細については、「 リリース ノート 」セクションを参照してください。
各ルール名とそれに関連付けられている一意のルール識別子は、既知のアップグレード ブロッキングの問題の説明と共に一覧表示されます。 ルールの説明では、"ダウン レベル" という用語は、アップグレード プロセスの最初のフェーズを指します。これは、開始 OS で実行されます。
- CompatScanOnly - FFDAFD37-DB75-498A-A893-472D49A1311D
- この規則は、セットアップが
setup.exeアップグレードではなく、互換性スキャンのみを実行することを示す特定のコマンド ライン パラメーターを使用して呼び出されたことを示します。
- この規則は、セットアップが
- BitLockerHardblock - C30152E2-938E-44B8-915B-D1181BA635AE
- これは、ターゲット OS で BitLocker がサポートされていないが、ホスト OS で BitLocker が有効になっている場合のアップグレード ブロックです。
- VHDHardblock - D9ED1B82-4ED8-4DFD-8EC0-BE69048978CC
- このブロックは、ホスト OS が VHD イメージに対して起動されるときに発生します。 ホスト OS が VHD イメージから起動されている場合、アップグレードはサポートされません。
- PortableWorkspaceHardblock - 5B0D3AB4-212A-4CE4-BDB9-37CA404BB280
- これは、ホスト OS が Windows To-Go デバイス (USB キー) から起動されていることを示します。 Windows To-Go環境ではアップグレードはサポートされていません。
- AuditModeHardblock - A03BD71B-487B-4ACA-83A0-735B0F3F1A90
- このブロックは、ホスト OS が現在監査モードで起動されていることを示します。これは、Windows 状態を変更するための特別なモードです。 この状態からのアップグレードはサポートされていません。
- SafeModeHardblock - 404D9523-B7A8-4203-90AF-5FBB05B6579B
- このブロックは、ホスト OS がセーフ モードで起動されていることを示します。アップグレードはサポートされていません。
- InsufficientSystemPartitionDiskSpaceHardblock - 3789FBF8-E177-437D-B1E3-D38B4C4269D1
- このブロックは、セットアップによって、システム パーティション (ブート ローダー ファイルが格納されている場所) に、アップグレード プロセス中に必要な新しいブート ファイルを処理するのに十分な領域がないと判断された場合に発生します。
- CompatBlockedApplicationAutoUninstall - BEBA5BC6-6150-413E-8ACE-5E1EC8D34DD5
- この規則は、セットアップを続行する前にアンインストールする必要があるアプリケーションがあることを示します。
- CompatBlockedApplicationDismissable - EA52620B-E6A0-4BBC-882E-0686605736D9
- /quiet モードでセットアップを実行する場合、コマンド ラインで "/compat ignorewarning" も指定されていない限り、ブロックになる無視可能なアプリケーション メッセージがあります。 このルールは、セットアップが /quiet モードで実行されたことを示しますが、セットアップを続行できないアプリケーションの無視可能なブロック メッセージがあります。
- CompatBlockedApplicationManualUninstall - 9E912E5F-25A5-4FC0-BEC1-CA0EA5432FF4
- この規則は、プログラムの追加と削除エントリのないアプリケーションがシステム上に存在し、セットアップの続行をブロックしていることを示します。 通常、このアプリケーションに関連付けられているファイルを手動で削除して続行する必要があります。
- HardblockDeviceOrDriver - ED3AEFA1-F3E2-4F33-8A21-184ADF215B1B
- このエラーは、ホスト OS に読み込まれたデバイス ドライバーが、新しい OS バージョンと互換性がなくなり、アップグレード前に削除する必要があることを示します。
- HardblockMismatchedLanguage - 60BA8449-CF23-4D92-A108-D6FCEFB95B45
- この規則は、ホスト OS とターゲット OS 言語エディションが一致しないことを示します。
- HardblockFlightSigning - 598F2802-3E7F-4697-BD18-7A6371C8B2F8
- このルールは、ターゲット OS がプレリリースであり、Windows Insider ビルドであり、ターゲット マシンでセキュア ブートが有効になっていることを示します。 これにより、マシンにインストールされている場合、プレリリースの署名付きビルドの起動がブロックされます。
- DiskSpaceBlockInDownLevel - 6080AFAC-892E-4903-94EA-7A17E69E549E
- このエラーは、アップグレードのダウンレベル操作中にシステムのディスク領域が不足したことを示します。
- DiskSpaceFailure - 981DCBA5-B8D0-4BA7-A8AB-4030F7A10191
- このエラーは、アップグレードへの最初の再起動後のある時点で、システム ドライブが使用可能なディスク領域を使い果たしたことを示します。
- DeviceInstallHang - 37BB1C3A-4D79-40E8-A556-FDA126D40BC6
- このエラールールは、アップグレードのデバイスインストールフェーズ中にシステムがハングまたはバグチェックされたことを示します。
- DebugSetupMemoryDump - C7C63D8A-C5F6-4255-8031-74597773C3C6
- このオフラインのみのルールは、セットアップ中にバグチェック発生したことを示します。 デバッガー ツールがシステムで使用できる場合、SetupDiag はメモリ ダンプをデバッグし、詳細を提供します。
- DebugSetupCrash - CEEBA202-6F04-4BC3-84B8-7B99AED924B1
- このオフラインのみのルールは、セットアップ自体でエラーが発生し、プロセス メモリ ダンプが発生したことを示します。 デバッガー ツールがシステムにインストールされている場合、SetupDiag はメモリ ダンプをデバッグし、詳細を提供します。
- DebugMemoryDump - 505ED489-329A-43F5-B467-FCAAF6A1264C
- このオフラインのみのルールは、セットアップ/アップグレード操作中に発生した memory.dmp ファイルに対するルールです。 デバッガー ツールがシステムにインストールされている場合、SetupDiag はメモリ ダンプをデバッグし、詳細を提供します。
- BootFailureDetected - 4FB446C2-D4EC-40B4-97E2-67EB19D1CFB7
- この規則は、更新の特定のフェーズ中にブート エラーが発生したことを示します。 ルールは、診断目的でエラー コードとフェーズを示します。
- FindDebugInfoFromRollbackLog - 9600EB68-1120-4A87-9FE9-3A4A70ACFC37
- この規則では、セットアップ/アップグレード プロセス中にバグチェックが発生したときに、メモリ ダンプが発生したが、デバッガー パッケージが実行中のマシン上に存在しない場合に、詳細が決定され、詳細が示されます。
- AdvancedInstallerFailed - 77D36C96-32BE-42A2-BB9C-AAFFE64FCADC
- セットアップ エラーの原因となる致命的な高度なインストーラー操作を検索します。
- FindMigApplyUnitFailure - A4232E11-4043-4A37-9BF4-5901C46FD781
- 更新の失敗の原因となった移行ユニットのエラーを検出します。 この規則は、移行プラグインの名前と、診断のために生成されたエラー コードを出力します。
- FindMigGatherUnitFailure - D04C064B-CD77-4E64-96D6-D26F30B4EE29
- 更新の失敗の原因となった移行収集ユニットのエラーを検出します。 このルールは、収集ユニット/プラグインの名前と、診断のために生成されたエラー コードを出力します。
- CriticalSafeOSDUFailure - 73566DF2-CA26-4073-B34C-C9BC70DBF043
- このルールは、SafeOS イメージを重要な動的更新プログラムで更新中にエラーが発生したことを示します。 診断目的で SafeOS イメージを更新しようとしたときに発生したフェーズとエラー コードを示します。
- UserProfileCreationFailureDuringOnlineApply - 678117CE-F6A9-40C5-BC9F-A22575C78B14
- 更新プログラムのオンライン適用フェーズ中にユーザー プロファイルの作成または変更中に重大なエラーが発生したことを示します。 これは、診断目的でエラーに関連付けられた操作とエラー コードを示します。
- WimMountFailure - BE6DF2F1-19A6-48C6-AEF8-D3B0CE3D4549
- この規則は、更新プログラムが WIM ファイルのマウントに失敗したことを示します。 WIM ファイルの名前と、診断目的でエラーに関連付けられているエラー メッセージとエラー コードが表示されます。
- FindSuccessfulUpgrade - 8A0824C8-A56D-4C55-95A0-22751AB62F3E
- 指定したセットアップが成功したかどうかを、ログに基づいて決定します。
- FindSetupHostReportedFailure - 6253C04F-2E4E-4F7A-B88E-95A69702F7EC
- アップグレード プロセスの早い段階で発生したエラーに関する情報をsetuphost.exe
- FindDownlevelFailure - 716334B7-F46A-4BAA-94F2-3E31BC9EFA55
- ダウンレベル フェーズの後半で、SetupPlatform によって表示されるエラー情報を提供します。
- FindAbruptDownlevelFailure - 55882B1A-DA3E-408A-9076-23B22A0472BD
- システムがダウンレベルで失敗したが、ログが突然終了した場合に、最後の操作エラー情報を提供します。
- FindSetupPlatformFailedOperationInfo - 307A0133-F06B-4B75-AEA8-116C3B53C2D1
- SetupPlatform が重大なエラーを示す場合に、最後のフェーズとエラー情報を提供します。 このルールは、診断目的でエラーに関連付けられた操作とエラーを示します。
- FindRollbackFailure - 3A43C9B5-05B3-4F7C-A955-88F991BB5A48
- ロールバックが発生した場合の最後の操作、失敗フェーズ、エラー情報を提供します。
- AdvancedInstallerGenericFailure - 4019550D-4CAA-45B0-A222-349C48E86F71
- AdvancedInstaller の読み取り/書き込みエラーを一般的な意味で一致させるルール。 呼び出されている実行可能ファイルと、報告されたエラー コードと終了コードを出力します。
- OptionalComponentFailedToGetOCsFromPackage - D012E2A2-99D8-4A8C-BBB2-088B92083D78 (注: この規則は、v1.10 に存在する OptionalComponentInstallFailure 規則に置き換えられます。
- これは、パッケージ内のコンポーネントを列挙しようとすると、特定の省略可能なコンポーネントエラーと一致します。 パッケージ名とエラー コードを出力します。
- OptionalComponentOpenPackageFailed - 22952520-EC89-4FBD-94E0-B67DF88347F6
- OC パッケージを開こうとしたときに、特定の省略可能なコンポーネントエラーと一致します。 パッケージ名とエラー コードを出力します。
- OptionalComponentInitCBSSessionFailed - 63340812-9252-45F3-A0F2-B2A4CA5E9317
- 高度なインストーラー サービスまたはコンポーネントがシステムで動作または開始されていない特定のエラーと一致します。 エラー コードを出力します。
- UserProfileCreationFailureDuringFinalize - C6677BA6-2E53-4A88-B528-336D15ED1A64
- セットアップの最終フェーズ中に特定のユーザー プロファイル作成エラーと一致します。 エラー コードを出力します。
- WimApplyExtractFailure - 746879E9-C9C5-488C-8D4B-0C811FF3A9A8
- セットアップの WIM 抽出フェーズ中の WIM 適用エラーと一致します。 拡張機能、パス、エラー コードを出力します。
- UpdateAgentExpanderFailure - 66E496B3-7D19-47FA-B19B-4040B9FD17E2
- Windows Updateからの更新のダウン レベル フェーズでの DPX エキスパンダーエラーと一致します。 パッケージ名、関数、式、エラー コードを出力します。
- FindFatalPluginFailure - E48E3F1C-26F6-4AFB-859B-BF637DA49636
- setupplatform がセットアップに致命的であると判断したプラグイン エラーと一致します。 プラグイン名、操作、エラー コードを出力します。
- AdvancedInstallerFailed - 77D36C96-32BE-42A2-BB9C-AAFFE64FCADC
- インストーラー パッケージの実行中に AdvancedInstaller で重大なエラーが発生したことを示します。呼び出されている.exe、フェーズ、モード、コンポーネント、エラー コードが含まれます。
- MigrationAbortedDueToPluginFailure - D07A24F6-5B25-474E-B516-A730085940C9
- 移行プラグインで重大な障害が発生し、セットアップによって移行が中止されることを示します。 セットアップ操作、プラグイン名、プラグイン アクション、エラー コードを提供します。
- DISMAddPackageFailed - 6196FF5B-E69E-4117-9EC6-9C1EAB20A3B9
- DISM パッケージの追加操作中に重大なエラーが発生したことを示します。 パッケージ名、DISM エラー、およびパッケージ エラー コードの追加を指定します。
- PlugInComplianceBlock - D912150B-1302-4860-91B5-527907D08960
- サーバー コンプライアンス プラグインからすべての compat ブロックを検出します。ブロック情報と修復を出力します。
- AdvancedInstallerGenericFailure - 4019550D-4CAA-45B0-A222-349C48E86F71
- 高度なインストーラーエラーを一般的な意味でトリガーし、フェーズ、モード、コンポーネント、エラー コードと呼ばれるアプリケーションを出力します。
- FindMigGatherApplyFailure - A9964E6C-A2A8-45FF-B6B5-25E0BD71428E
- 収集操作または適用操作で移行エンジンが失敗した場合のエラーを表示します。 移行オブジェクト (ファイルまたはレジストリ パス)、移行
- OptionalComponentFailedToGetOCsFromPackage - D012E2A2-99D8-4A8C-BBB2-088B92083D78
- 省略可能なコンポーネント (OC) の移行操作が、OC パッケージから省略可能なコンポーネントを列挙できなかった場合に失敗したことを示します。 パッケージ名とエラー コードを出力します。
- OptionalComponentOpenPackageFailed - 22952520-EC89-4FBD-94E0-B67DF88347F6
- 省略可能なコンポーネントの移行操作が、オプションのコンポーネント パッケージを開けなかった場合に失敗したことを示します。 パッケージ名とエラー コードを出力します。
- OptionalComponentInitCBSSessionFailed - 63340812-9252-45F3-A0F2-B2A4CA5E9317
- ダウン レベル システムのサービス スタックの破損を示します。 既存の OS でサービス コンポーネントを初期化しようとしたときに発生したエラー コードを出力します。
- DISMproviderFailure - D76EF86F-B3F8-433F-9EBF-B4411F8141F4
- 重要な操作で DISM プロバイダー (プラグイン) が失敗したときにトリガーされます。 ファイル (プラグイン名)、+ エラー コードと呼ばれる関数、およびプロバイダーからのエラー メッセージを出力します。
- SysPrepLaunchModuleFailure - 7905655C-F295-45F7-8873-81D6F9149BFD
- sysPrep プラグインが重要な操作で失敗したことを示します。 プラグイン名、操作名、エラー コードを示します。
- UserProvidedDriverInjectionFailure - 2247C48A-7EE3-4037-AFAB-95B92DE1D980
- セットアップ用に提供されたドライバー (コマンド ライン入力を使用) が何らかの方法で失敗しました。 ドライバーのインストール関数とエラー コードを出力します。
- PlugInComplianceBlock - D912150B-1302-4860-91B5-527907D08960
- これらはサーバーのアップグレード専用であり、必要なコンプライアンス ブロックと修復が出力されます。
- PreReleaseWimMountDriverFound - 31EC76CC-27EC-4ADC-9869-66AABEDB56F0
- 認識されないwimmount.sys ドライバーがシステムに登録されているためのエラーをキャプチャします。
- WinSetupBootFilterFailure - C073BFC8-5810-4E19-B53B-4280B79E096C
- カーネル モード ファイル操作でエラーを検出します。
- WimMountDriverIssue - 565B60DD-5403-4797-AE3E-BC5CB972FBAE
- システム上の登録WimMount.sysエラーを検出します。
- DISMImageSessionFailure - 61B7886B-10CD-4C98-A299-B987CB24A11C
- DISM がイメージ セッションを正常に開始できない場合のエラー情報をキャプチャします。
- FindEarlyDownlevelError - A4CE4FC9-5E10-4BB1-8ECE-3B29EB9D7C52
- セットアップ プラットフォームが呼び出される前に、ダウンレベル フェーズでエラーを検出します。
- FindSPFatalError - A4028172-1B09-48F8-AD3B-86CDD7D55852
- セットアップ プラットフォームで致命的なエラーが発生した場合のエラー情報をキャプチャします。
- UserProfileSuffixMismatch - B4BBCCCE-F99D-43EB-9090-078213397FD8
- ファイルまたはその他のオブジェクトによって、更新中にユーザー プロファイルの移行または作成が失敗するタイミングを検出します。
リリース ノート
2021 年 7 月 27 日 - SetupDiag v1.6.2107.27002 は、ダウンロード センターで使用できるスタンドアロン ツールとして、61 個のルールでリリースされます。
- このバージョンには、コンプライアンスの更新と軽微なバグ修正が含まれています。
- このリリース以降のリリースでは、ダウンロード可能な SetupDiag ツールのバージョン番号は、Windows セットアップに含まれているバージョンとは異なります。
2021 年 5 月 6 日 - SetupDiag v1.6.1.0 は、ダウンロード センターで使用できるスタンドアロン ツールとして、61 ルールでリリースされます。
- このバージョンの SetupDiag は、バージョン 21H1 Windows 10に含まれています。
- UserProfileSuffixMismatch という新しいルールが追加されました。
- コマンド ラインへのすべての出力が、時刻/日付形式の目的でインバリアント カルチャになりました
- "一致しない" 結果によってREG_SZ値が破損するレジストリ出力に関する問題を修正しました。
2019 年 8 月 8 日 - SetupDiag v1.6.0.42 は、ダウンロード センターから使用できるスタンドアロン ツールとして、60 個のルールでリリースされます。
- ログ検出のパフォーマンスが向上しました。 ログ検出には約 10 秒以下かかります。この場合、最大で 1 分かかる場合があります。
- 結果ログとレジストリ情報の両方に、セットアップ操作とセットアップ フェーズの情報を追加しました。
- これは、失敗が発生したときにセットアップが行われた最後の操作とフェーズです。
- /verbose が指定されている場合にログを出力するために、詳細なセットアップ操作とセットアップ フェーズ情報 (およびタイミング) を追加しました。
- 見つかった問題が互換性ブロックの場合は、セットアップ操作またはフェーズ情報がまだ存在しないため、使用できません。
- レジストリ出力に詳細情報を追加しました。
- 利用可能な場合は、詳細な 'FailureData' 情報。 例: "AppName = MyBlockedApplication" または "DiskSpace = 6603" (MB 単位)
- 検出されたエラーに固有の "Key = Value" データ。
- 'UpgradeStartTime'、'UpgradeEndTime' および 'UpgradeElapsedTime' を追加しました
- 'SetupDiagVersion'、'DateTime' (システムで SetupDiag が実行されたタイミングを示す)、'TargetOSVersion'、'HostOSVersion' などを追加しました。
- 利用可能な場合は、詳細な 'FailureData' 情報。 例: "AppName = MyBlockedApplication" または "DiskSpace = 6603" (MB 単位)
2019/06/19 - SetupDiag v1.5.0.0 は、ダウンロード センターから使用できるスタンドアロン ツールとして、60 ルールでリリースされます。
- すべての日付と時刻の出力は、ユーザー要求ごとにローカライズされた形式に更新されます。
- セットアップ操作とフェーズ情報を /verbose ログに追加しました。
- 最後のセットアップ操作と最後のセットアップ フェーズ情報を、意味のあるほとんどのルールに追加しました (以下の新しい出力を参照)。
- setupact.logs を検索して解析する正しいログを特定するパフォーマンスの向上。
- テキスト レポートに SetupDiag バージョン番号を追加しました (xml と json には常に含まれます)。
- ユーザー要求ごとに xml と json の "一致しない" レポートを追加しました。
- 読みやすくするために書式設定された Json 出力。
- セットアップ ログを検索するときのパフォーマンスの向上。これは今よりずっと速いはずです。
- PlugInComplianceBlock、PreReleaseWimMountDriverFound、WinSetupBootFilterFailure、WimMountDriverIssue、DISMImageSessionFailure、FindEarlyDownlevelError、FindSPFatalError の 7 つの新しいルールが追加されました。 詳細については、上記の 「ルール 」セクションを参照してください。
- HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag で診断情報がレジストリに出力されるようになりました
- /AddReg コマンドがレジストリ出力を切り替えるために追加されました。 この設定はオフライン モードでは既定でオフ、オンライン モードの場合は既定でオンになっています。 このコマンドはオンライン モードには影響せず、オフライン モードのレジストリ出力を有効にします。
- このレジストリ キーは、SetupDiag が 2 回目に実行されるとすぐに削除され、現在のデータに置き換えられるので、常に最新の状態になります。
- このレジストリ キーは、新しい更新インスタンスが呼び出されたときにも削除されます。
- 例については、「 サンプル レジストリ キー」を参照してください。
2019/05/17 - SetupDiag v1.4.1.0 は、ダウンロード センターから使用できるスタンドアロン ツールとして、53 ルールでリリースされます。
- このリリースでは、リセットと回復の失敗 (プッシュ ボタン リセット) を見つけて診断する機能を dds します。
2018/12/18 - SetupDiag v1.4.0.0 は、ダウンロード センターから使用できるスタンドアロン ツールとして、53 ルールでリリースされます。
- このリリースには、ルール処理パフォーマンスの大幅な改善が含まれています。ルール処理のパフォーマンスが最大 3 倍向上しました。
- FindDownlevelFailure ルールの速度は最大 10 倍です。
- Windows 10 バージョン 1809 へのアップグレードの失敗を分析するための新しいルールが追加されました。
- ルールの一致がこの種類のエラーを示している場合に、ダウンレベル OS でのサービス スタックエラーを解決するための新しいヘルプ リンクを使用できます。
- /Mode パラメーターを指定する必要がなくなりました。 これで、/LogsPath を指定すると、オフライン モードが自動的に想定されます。
- いくつかのルールに対して、いくつかの機能と出力の改善が行われました。
2018/07/16 - SetupDiag v1.3.1 は、ダウンロード センターから使用できるスタンドアロン ツールとして、44 個のルールでリリースされます。
- このリリースでは、setupmem.dmp ファイルを生成するがデバッガー バイナリがインストールされていないコンピューターで SetupDiag をオンライン モードで実行するときに発生する可能性がある問題が修正されます。
2018/07/10 - SetupDiag v1.30 は、ダウンロード センターから使用できるスタンドアロン ツールとして、44 個のルールでリリースされます。
- 一致し過ぎのプラグイン規則のバグ修正。 このルールは、重要な (セットアップ エラー) プラグインの問題にのみ正しく一致するようになりました。
- 新機能: JSON および XML 形式でログを出力する機能。
- "/Format:xml" または "/Format:json" コマンド ライン パラメーターを使用して、新しい出力形式を指定します。 このトピックの下部にある サンプル ログ を参照してください。
- "/Format:xml" または "/Format:json" パラメーターを省略すると、ログ出力形式は既定で text になります。
- 新機能: 可能な場合は、特定のエラーを修復するための特定の手順がルール出力に提供されるようになりました。 たとえば、互換性のないアプリのアンインストールやシステム ドライブ上の領域の解放など、既知のブロックの問題を修復するための手順が用意されています。
- 3 つの新しい規則が追加されました: AdvancedInstallerFailed、MigrationAbortedDueToPluginFailure、DISMAddPackageFailed。
2018 年 5 月 30 日 - SetupDiag v1.20 は、ダウンロード センターから使用できるスタンドアロン ツールとして、41 個のルールでリリースされます。
- オンライン モードでのデバイスインストールエラー検出のバグを修正しました。
- setupact.log のインスタンスなしで動作するように SetupDiag を変更しました。 以前は、SetupDiag では、動作するために少なくとも 1 つの setupact.log が必要でした。 この変更により、ツールは SetupHost を呼び出す前に発生した更新エラーを分析できます。
- テレメトリは、ルール名と GUID (ルールが一致しない場合は "NoRuleMatched") と Setup360 ReportId のみを送信するようにリファクタリングされます。 この変更により、ルールの処理中にデータのプライバシーが確保されます。
2018/05/02 - SetupDiag v1.10 は、ダウンロード センターから使用できるスタンドアロン ツールとして、34 個のルールでリリースされます。
- パフォーマンスの向上が追加され、ルール処理が高速化されました。
- ルールの出力に、該当する場合はサポート記事へのリンクが含まれるようになりました。
- SetupDiag で、処理するファイルのパスと名前が提供されるようになりました。
- SetupDiag を選択し、出力ログ ファイルを調べることで、SetupDiag を実行できるようになりました。
- ルールが一致したかどうかにかかわらず、出力ログ ファイルが常に作成されるようになりました。
2018/03/30 - SetupDiag v1.00 は、ダウンロード センターから使用できるスタンドアロン ツールとして、26 個のルールでリリースされます。
サンプル ログ
テキスト ログのサンプル
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/2018 9:47:16 PM
UpgradeEndTime = 3/21/2018 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://learn.microsoft.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://learn.microsoft.com/windows/deployment/upgrade/setupdiag">
<Version>1.6.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>2019-06-06T21:19:10</UpgradeStartTime>
<UpgradeElapsedTime />
<UpgradeEndTime>2019-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>2019-06-06 21:47:11, Error SP Error converting install time 5/2/2019 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: 2019-06-06 21:47:11, Error SP Error converting install time 5/2/2019 to structure[gle=0x00000057]</FailureData>
<FailureData>LogEntry: 2019-06-06 21:47:11, Error SP Error converting install time 5/2/2019 to structure[gle=0x00000057]</FailureData>
<FailureData>
Refer to "https://learn.microsoft.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":"2019-06-06 21:47:11, Error SP Error converting install time 5\/2\/2019 to structure[
gle=0x00000057
]",
"FailureData":[
"\u000aError: SetupDiag reports Fatal Error.\u000aLast Setup Phase = Downlevel\u000aLast Setup Operation: Gather data, scope: EVERYTHING\u000aError: 0x00000057",
"LogEntry: 2019-06-06 21:47:11, Error SP Error converting install time 5\/2\/2019 to structure[
gle=0x00000057
]",
"LogEntry: 2019-06-06 21:47:11, Error SP Error converting install time 5\/2\/2019 to structure[
gle=0x00000057
]",
"\u000aRefer to \"https:\/\/learn.microsoft.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
}
サンプル レジストリ キー
