به‌روزرسانی‌های ویندوز معمولاً بدون دردسر روی رایانه شخصی شما نصب می‌شوند. اما مواردی وجود دارد که نیاز به کمی کار دارد، به خصوص در مورد سازگاری و وصله ها. اگر با چنین خطاهای به روز رسانی ناموفق مواجه شدید، ابتدا باید کد خطا را به صورت دستی جستجو کنید و سپس به دنبال مراحل عیب یابی بگردید. همه اینها زمان می برد. بنابراین، مایکروسافت^(Microsoft) یک راه حل ساده ارائه کرده است - SetupDiag.exe .

SetupDiag.exe یک ابزار تشخیصی مستقل برای یافتن جزئیات مربوط به عدم نصب ارتقاء Windows 11/10همانطور که می دانید، فرآیند به روز رسانی در Windows 11/10 کاملاً ساده شده است، اما این بدان معنا نیست که همیشه بدون مشکل و از این رو ابزار است.

نحوه استفاده از SetupDiag.exe

SetupDiag.exe نیاز به نصب Microsoft.NET Framework 4 بر روی رایانه شخصی شما دارد. این ابزار با بررسی فایل‌های گزارش راه‌اندازی ویندوز^{(Windows Setup)} و تجزیه آن‌ها برای یافتن علت اصلی نقص در به‌روزرسانی یا ارتقای رایانه به ویندوز 10^{(Windows 10)} کار می‌کند. SetupDiag را می‌توان روی رایانه‌ای که به‌روزرسانی نشد اجرا کرد، یا می‌توانید گزارش‌ها را از رایانه به مکان دیگری صادر کنید و SetupDiag را در حالت آفلاین اجرا کنید.

هنگامی که ابزار را راه اندازی کردید، می توانید از آن برای انجام بررسی ها و تجزیه و تحلیل ها نیز استفاده کنید. هر زمان که ویندوز^(Windows) با موقعیتی روبرو می شود که احتمالاً قصد دارد عملکرد سیستم را به خطر بیندازد، سیستم متوقف می شود. به این حالت بررسی اشکال^{(bug check)} می گویند . معمولاً به عنوان a- نیز شناخته می شود

1. خرابی سیستم
2. خطای هسته
3. خطای توقف یا BSOD

علت معمول این مشکل یا یک دستگاه سخت افزاری، درایور سخت افزار یا برخی نرم افزارهای مرتبط است.

اگر بررسی اشکال در حین ارتقا رخ دهد، Windows Setup یک فایل minidump ( setupmem.dmp ) استخراج می کند.

برای رفع اشکال بررسی باگ مربوط به راه اندازی، باید:

/Mode: Offline و /LogsPath مشخص کنید و سعی کنید فایل تخلیه حافظه راه اندازی (setupmem.dmp) را از سیستم خراب جمع آوری کنید.

لطفاً^(Please) توجه داشته باشید که نمی‌توانید حافظه‌های خالی را در حالت آنلاین اشکال زدایی کنید.

Setupmem.dmp را در زیر هر دو پیدا خواهید کرد

%SystemDrive%$Windows.~bt\Sources\Rollback

یا

%WinDir%\Panther\NewOS\Rollback

بسته به زمانی که بررسی اشکال رخ می دهد.

پس از آن، می‌توانید Windows Debugging Tools را روی رایانه‌ای که SetupDiag را اجرا می‌کند نصب کنید. اگر ابزار را بدون پارامتر اجرا کنید، سعی می‌کند فایل‌های گزارشی را که ویندوز 11/10 در طول فرآیند ارتقا ایجاد می‌کند، در پوشه‌های پیش‌فرض دستگاه بیابد.

پس از پایان اسکن، SetupDiag Log.zip ، SetupDiag.exe.config^(Log.zip) و SetupDiagResults.log^{(SetupDiag.exe.config)} را در پوشه ای که SetupDiag.exe در آن قرار دارد ^{(SetupDiagResults.log)}ایجاد^{(SetupDiag.exe)} می کند.

این برنامه همچنین پس از اتمام فرآیند اسکن ، یک فایل results.log در دایرکتوری خود ایجاد می کند. ^{(results.log file)}هر گونه مشکل ارتقا که با آن مواجه می شود به سرعت در فایل های گزارش در طول تجزیه شناسایی می شود.

جدای از موارد فوق، SetupDiag یک بایگانی فشرده از تمام فایل‌های گزارش پردازش شده ایجاد می‌کند و همچنین فایل Logs.zip را نیز در همان فهرست ذخیره می‌کند.

در نهایت، گزینه ای برای حتی اجرای SetupDiag.exe در حالت آفلاین برای تجزیه پوشه های کپی شده از دستگاه دیگر وجود دارد.

ابزار SetupDiag^(SetupDiag) اکنون در راه اندازی ویندوز گنجانده شده است^{(Windows Setup)}

در ویندوز 10^{(Windows 10)} و ویندوز 11^{(Windows 11)} ، ابزار SetupDiag همراه با ^(SetupDiag)راه اندازی ویندوز^{(Windows Setup)} گنجانده شده است .

در طول فرآیند ارتقا، Windows Setup تمام فایل‌های منبع خود را در %SystemDrive%$Windows.~btSourcesدایرکتوری استخراج می‌کند.

اکنون setupdiag.exe نیز در این پوشه نصب شده است و در صورت عدم موفقیت آپگرید، ابزار SetupDiag به صورت خودکار اجرا می شود تا علت عدم موفقیت آن را دریابد.

در این سناریو از پارامترهای زیر استفاده می شود:

/ZipLogs:False

/Format:xml

/Output:%windir%\logs\SetupDiag\SetupDiagResults.xml

/RegPath:HKEY_LOCAL_MACHINE\SYSTEM\Setup\SetupDiag\Results

تجزیه و تحلیل SetupDiag^(SetupDiag) حاصل را می توان در آدرس زیر یافت:

%WinDir%\Logs\SetupDiag\SetupDiagResults.xml

و در رجیستری تحت

HKLM\SYSTEM\Setup\SetupDiag\Results

• اگر فرآیند ارتقا به طور عادی پیش برود، دایرکتوری Sources شامل setupdiag.exe %SystemDrive%Windows.Oldبرای پاکسازی به زیر منتقل می شود.
• اگر فهرست Windows.old بعداً حذف شود، setupdiag.exe نیز حذف خواهد شد.

برای جزئیات کامل در مورد نحوه استفاده از SetupDiag.exe می توانید این Microsoft Doc را بخوانید .

How to use SetupDiag.exe to diagnose Windows Upgrade errors

Windows Updates usυally get installed on your РC without haѕsles. But there are occasions when it requires a bit of work, especially when it comes to compatibility and patches. If you come across such failed update errors, you first have to manually ѕearch the error code and then look for troubleshooting steps. All this consumes time. So, Microsoft has come up wіth a simple solution – SetupDiag.exe.

SetupDiag.exe is a standalone diagnostic tool for finding details about why a Windows 11/10 upgrade failed to install. As you know, the update process in Windows 11/10 has been thoroughly streamlined but that doesn’t mean it’s always problem-free and hence, the tool.

How to use SetupDiag.exe

SetupDiag.exe requires Microsoft .NET Framework 4 to be installed on your PC. The tool works by examining Windows Setup log files and parsing them to find the root cause of a failure to update or upgrade the computer to Windows 10. SetupDiag can be run on the computer that failed to update, or you can export logs from the computer to another location and run SetupDiag in offline mode.

Once you have the tool up and running, it can be used for performing checks and analyses also. Whenever Windows comes across a situation that likely intends to compromise safe system operation, the system halts. This condition is called a bug check. It is also commonly referred to as a-

1. System crash
2. Kernel error
3. Stop error or BSOD

The typical cause for this issue is either a hardware device, hardware driver, or some related software.

If the bug check occurs during an upgrade, Windows Setup extracts a minidump (setupmem.dmp) file.

To debug a setup related bug check, one must:

Specify the /Mode: Offline and /LogsPath parameters and try gathering the setup memory dump file (setupmem.dmp) from the failing system.

Please note that you cannot debug memory dumps in online mode.

You will find Setupmem.dmp under either

%SystemDrive%$Windows.~bt\Sources\Rollback

Or

%WinDir%\Panther\NewOS\Rollback

depending on when the bug check occurs.

Thereafter, you can install the Windows Debugging Tools on the computer that runs SetupDiag. If you chose to run the tool without parameters, it attempts to locate log files that Windows 11/10 creates during the upgrade process in the default folders on the device.

Once the scan is over, SetupDiag will generate Log.zip, SetupDiag.exe.config, and SetupDiagResults.log in the folder where the SetupDiag.exe is located.

The program also creates a results.log file in its directory after the completion of the scanning process. Any upgrade issues encountered are rapidly detected in the log files during parsing.

Apart from the above, SetupDiag creates a zip archive of all logfiles that is processed and also saves Logs.zip file in the same directory as well.

Lastly, there’s an option to even run SetupDiag.exe in offline mode to parse folders copied from another device.

SetupDiag tool is now included with Windows Setup

In Windows 10 and Windows 11, SetupDiag tool is included with Windows Setup.

During the upgrade process, Windows Setup will extract all its sources files to the %SystemDrive%$Windows.~bt\Sources directory.

Now, setupdiag.exe is also installed in this folder and in case the upgrade fails, SetupDiag tool will automatically run to find out why it failed.

In this scenario, the following parameters are used:

/ZipLogs:False

/Format:xml

/Output:%windir%\logs\SetupDiag\SetupDiagResults.xml

/RegPath:HKEY_LOCAL_MACHINE\SYSTEM\Setup\SetupDiag\Results

The resulting SetupDiag analysis can be found at:

%WinDir%\Logs\SetupDiag\SetupDiagResults.xml

and in the Registry under

HKLM\SYSTEM\Setup\SetupDiag\Results

• If the upgrade process proceeds normally, the Sources directory including setupdiag.exe is moved under %SystemDrive%\Windows.Old for cleanup.
• If the Windows.old directory is deleted later, setupdiag.exe will also be removed.

For full details on how to use SetupDiag.exe you can read this Microsoft Doc.

Related posts

• ویندوز 10 Upgrade error کدهای و راه حل ها

• system registry شامل مسیرهای فایل نامعتبر - ویندوز 10 Upgrade error

• چگونه به روز رسانی از Windows 7 به Windows 10 بدون از دست دادن داده ها

• Fix Windows Upgrade error 0xc1900204

• Remove Windows قبلی Windows پس از ارتقاء Windows 10

• Defer or Delay ویندوز 10 version 21H1 یا Feature Upgrades

• Modern Setup Host کار را متوقف کرده است - ویندوز 10 خطا

• Fix ویندوز 10 Upgrade error 0x8007042B - 0x4000D

• رفع خطای “Windows Anytime Upgrade was not موفقیت”.

• ویژگی های Microsoft Family پس از Windows 10 Upgrade یا به روز رسانی خاموش شد

• چگونه Pre-Upgrade Validation Check را در Windows 10 اجرا کنید

• نصب ویندوز 10 شکست خورده است - خطای ارتقاء ویندوز

• ویندوز 10 Update Assistant در 99٪ گیر کرده است

• Please درج رسانه های ذخیره سازی خارجی و press OK

• ویندوز 10 Media Creation Tool: Create Installation Media

• 0x800707E7 - 0x3000D، نصب و راه اندازی در FIRST_BOOT phase شکست خورده

• چگونه می توان بررسی کرد که آیا می توانید به 64 بیتی ویندوز 10 بر روی همان کامپیوتر ارتقا دهید

• نحوه رزرو آپدیت رایگان به ویندوز 10

• سازمان شما مدیریت به روز رسانی در این PC message بر روی ویندوز 10

• Windows Fresh Start vs Refresh vs Reset vs Clean Install و بیشتر