Aaron Stebner's WebLog

Thoughts about setup and deployment issues, WiX, XNA, the .NET Framework and Visual Studio

.NET Framework Setup Verification Tool User's Guide

.NET Framework Setup Verification Tool User's Guide

Rate This

.NET Framework Setup Verification Tool User's Guide


This .NET Framework setup verification tool is designed to automatically perform a set of steps to verify the installation state of one or more versions of the .NET Framework on a computer.  It will verify the presence of files, directories, registry keys and values for the .NET Framework.  It will also verify that simple applications that use the .NET Framework can be run correctly.

If the verification tool finds any issues, there is a .NET Framework Repair Tool that can be found at the following locations:

Additional support can be obtained by visiting the .NET Framework setup forum at http://social.msdn.microsoft.com/Forums/en-US/netfxsetup/threads.

Download location

The .NET Framework setup verification tool is available for download at the following locations:

The .zip file that contains the tool also contains a file named history.txt that lists when the most recent version of the tool was published and what changes have been made to the tool over time.

Supported products

The .NET Framework setup verification tool supports verifying the following products:

  • .NET Framework 1.0
  • .NET Framework 1.1
  • .NET Framework 1.1 SP1
  • .NET Framework 2.0
  • .NET Framework 2.0 SP1
  • .NET Framework 2.0 SP2
  • .NET Framework 3.0
  • .NET Framework 3.0 SP1
  • .NET Framework 3.0 SP2
  • .NET Framework 3.5
  • .NET Framework 3.5 SP1
  • .NET Framework 4 Client
  • .NET Framework 4 Full
  • .NET Framework 4.5
  • .NET Framework 4.5.1
  • .NET Framework 4.5.2
  • .NET Framework 4.6
  • .NET Framework 4.6.1

By default, the .NET Framework setup verification tool will only list versions of the .NET Framework that it detects are installed on the computer that it is being run on.  As a result, the tool will not list all of the above versions of the .NET Framework.  This product filtering can be overridden by running the .NET Framework setup verification tool with the following command line switch:

netfx_setupverifier.exe /q:a /c:"setupverifier2.exe /a"

Silent mode

The .NET Framework setup verification tool does not support running in silent mode.

Exit codes

The verification tool can returns the following exit codes:

  • 0 - verification completed successfully for the specified product
  • 1 - the required file setupverifier.ini was not found in the same path as setupverifier.exe
  • 2 - a product name was passed in that cannot be verified because it does not support installing on the OS that the tool is running on
  • 3 - a product name was passed in that does not exist in setupverifier.ini
  • 100 - verification failed for the specified product
  • 1602 - verification was canceled

Log files

This verification tool creates 2 log files by default that can be used to determine what actions the tool is taking and what errors it encounters while verifying a product.  The 2 log files are listed below, and they are created in the %temp% directory by default.  Note that you can find the %temp% directory by clicking on the Windows start menu, choosing Run, typing %temp% and clicking OK to open the directory in Windows Explorer.

  • %temp%\setupverifier_main_*.txt - this log contains information about all actions taken during a verification tool session; it will include information about each resource that the tool attempts to verify for a chosen product and whether or not that resource was found on the system; this log tends to be fairly long, so errors will be logged with the prefix ****ERROR**** to make it easy to search and find them
  • %temp%\setupverifier_errors_*.txt - this log only contains information about any errors found during verification of a chosen product
  • %temp%\setupverifier_netfx20testapp_*.txt - this log contains error information for the .NET Framework test application that is run by the verification tool.  This log will only be created if there is an error while running the test application.

A new pair of log files will be created each time the verification tool is launched.  The date and time the tool is launched will be appended to the end of the log file names by default in place of the * in the names listed above.  If you want to control the exact names used for the log files, you can use the following command line parameters:

  • /l <filename> - specifies a name to replace the default value of setupverifier_main_*.txt for the main activity log for the verification tool
  • /e <filename> - specifies a name to replace the default value of setupverifier_errors_*.txt for the error log for the verification tool

For example, the following command line will allow you to specify non-default names for both log files:

netfx_setupverifier.exe /q:a /c:"setupverifier2.exe /l %temp%\my_main_log.txt /e %temp%\my_error_log.txt"


Attachment: netfx_setupverifier_new_2015_12_18.zip
  • When I tried to install net framework 2 sp2, a dialog box appeared:

    setup cannot continue because this version of the net framework is incompatible with a previously installed one...

    Any ideas?

  • Hello,

    I am running into trouble with Net 4.0 I have a Windows 7 OS. 64bits

    I have ran netfx_setupverifier and I get error only for Net 4.0 I can post the error log if needed.

    I have removed Net.4 and Net 4 extended, both usung Remove program in Control Panel, and dotNetFx40_Client_x86_x64.exe.  I have reinstalled Net with dotNetFx40_Client_x86_x64.exe

    With no success.

    The error message I get opening some program is: "to run this application you first must install one of the following version of the .Net Framework: v4.0.30319"

    Thank you for any help.


  • Hi Haha12345678910 - I'd suggest trying to install the .NET Framework 4.5 from www.microsoft.com/.../details.aspx. It is a super-set of the .NET Framework 4, and it might help resolve this error.

    If that doesn't help, then can you please copy and paste the full text of the errors in your netfx_setupverifier error log file so I can take a closer look?

  • Hi Satria - What version of Windows do you see that compatibility message for?  Window 7 and Windows 8 both include the .NET Framework 2.0 SP2 as a part of the OS, so you don't need to install the standalone version of the .NET Framework 2.0 SP2 on those versions of Windows.

  • Hi,

    I facing this issue.

    My pc keep showing this error message

    ".NET Framework error. Please install .NET Framework MDS version".

    Where can I download this version?

    Please reply me.


  • Hi Mohzack - I don't recognize this name - there isn't a MDS version of the .NET Framework that I know of.  What is the program that you're trying to run when you see this error?  It might help to search on the web site for the manufacturer of the program that you're trying to run to see if they have any troubleshooting steps that they suggest for this type of error.

  • hey man !!

    I have downloaded it, but it shows me TO DOWNLOAD REGISTRATION KEY PLEASE

    how will I get it ?

    I am confused

    please help

  • Hi manas ranjan - I'm not sure I understand your comment.  Do you see that error when you try to download the tool or when you try to run it?  Can you please provide a screenshot that shows the exact error that you're seeing?

  • Hey Aaron,

    Big fan of the .NET setup verification tool.  Any plans to update it for .NET 4.5.1?


  • Hi Don B. - Thank you for the kind words.  Yes, I'll be working on an update to this tool to support the .NET Framework 4.5.1 soon.

  • Hi, I run the new version setupverifier on windows 8.1 witch should have .net 4.5.1 integrated, but the tool says:

    [11/11/13,10:02:16] Install state for .NET Framework 4.5.1: not installed.

    [11/11/13,10:02:16] Not adding product '.NET Framework 4.5.1' because it is not currently installed

    also it writes

    [11/11/13,10:02:16] Detected operating system: Windows 8 (x64)

    but should write 8.1

  • Hi Aaron, In doing some research I came across your links and page. I have a question and it may have been answered somewhere in this site, but there's just too much to read through. I recently discovered that Windows Update is not working on my husbands desktop. He runs Windows 7. That last regular updates were in June of 2012. Three more updates were in October of 2013 but that's it. I tried to do things manually with windows update, including rebooting after each change but I can't seem to get it to work. I've followed suggestions I've found online, but to no avail. I'm not much of a tech, just stuff I've learned myself and would appreciate any help you can give me with this. Thanx.

  • Hi Alex - I didn't update the logging in the verification tool to differentiate between Windows 8 and 8.1, so the last item you listed is expected.  I'm not sure why it isn't correctly detecting the install state of the .NET Framework 4.5.1 though.  I'll look into that and update the tool with a fix if needed.

  • Hi Alex - I found and fixed a problem with the .NET Framework 4.5.1 detection logic on Windows 8.1, and I've uploaded a new version of the setup verification tool.  Please give it a try when you get a chance and let me know if you run into any further issues.

  • Hi Carrie - I'd suggest trying to use the information in the knowledge base article at support.microsoft.com/.../971058 to reset Windows Update on your computer to see if that help resolves the problems you're describing.

Page 18 of 26 (378 items) «1617181920»
Leave a Comment
  • Please add 7 and 5 and type the answer here:
  • Post