Microsoft KB Archive/262841

= Command-line switches for Windows software update packages =

Article ID: 262841

Article Last Modified on 10/26/2007

-

APPLIES TO


 * Microsoft Windows Server 2003, 64-Bit Datacenter Edition
 * Microsoft Windows Server 2003, 64-Bit Enterprise Edition
 * Microsoft Windows Server 2003, Datacenter Edition (32-bit x86)
 * Microsoft Windows Server 2003, Enterprise Edition
 * Microsoft Windows Server 2003, Standard Edition (32-bit x86)
 * Microsoft Windows Server 2003, Web Edition
 * Microsoft Windows XP Professional
 * Microsoft Windows XP Home Edition
 * Microsoft Windows XP Tablet PC Edition
 * Microsoft Windows XP Media Center Edition 2002
 * Microsoft Windows XP Media Center Edition 2004
 * Microsoft Windows XP Professional for Itanium-based systems
 * Microsoft Windows XP Professional for Itanium-based systems
 * Microsoft Windows 2000 Datacenter Server
 * Microsoft Windows 2000 Advanced Server
 * Microsoft Windows 2000 Professional Edition
 * Microsoft Windows 2000 Server
 * Microsoft Windows NT Server 4.0, Terminal Server Edition
 * Microsoft Windows NT Server 4.0 Standard Edition
 * Microsoft Windows NT Workstation 4.0 Developer Edition

-



This article was previously published under Q262841



SUMMARY
''Some Microsoft software updates use Hotfix.exe or Update.exe as the Setup program. These Setup programs check your Windows service pack version and operating system language, install and register the software update on your computer, and back up files to allow for removal of the software update.

Software updates that use one of these Setup programs support several command-line switches that administrators can use to deploy the updates.

To determine whether a software update uses Hotfix.exe or Update.exe as the Setup program for packages released after July 2004, examine the Installer Engine value on the Version tab of the Properties dialog box for the software update package. For packages released before July 2004, you must extract the package contents to check which installer is used.

''



INTRODUCTION
Microsoft packages software updates using several different self-extracting file formats that automatically run a Setup program that is contained inside the package. This article describes the command-line switches that you can use with software update packages that use Hotfix.exe or Update.exe as the Setup program. This is referred to in the rest of this article as &quot;Windows software update packages.&quot;

For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

824684 Description of the standard terminology that is used to describe Microsoft software updates



MORE INFORMATION
To determine whether a software update package uses Update.exe as the Setup program, and to determine what version it uses, follow these steps:
 * 1) Right-click the package, and then click Properties.
 * 2) On the Version tab, under Other Version Information, click Installer Engine. Update.exe should appear in the Value field.
 * 3) To determine the version, click Installer Version. The the version of the installer that is used in the package appears in the Value field.

For packages released before July 2004, or those packages whose Description value on the General tab is Self-Extracting Cabinet, follow these steps to determine whether Update.exe or Hotfix.exe is used, and to determine what version is used:  Extract the software update package to a unique temporary folder. For example, to extract the files for an update package that is named KBArticleNumber.exe to a folder that is named ExtractedPackage on drive C, type the following at a command prompt:

KBArticleNumber /X:C:\ExtractedPackage

 Open the temporary folder that contains the extracted files for the software update package. For example, open C:\ExtractedPackage. Locate the Update.exe or Hotfix.exe file in the temporary folder or a subfolder. To determine the version of Update.exe or Hotfix.exe, right-click that file and then click Properties. Click the Version tab, and then note the value on the File version line.

Note If the package description is Win32 Cabinet Self-Extractor, the software update package is an IExpress package. For additional information, click the following article number about IExpress packages to view the article about IExpress packages in the Microsoft Knowledge Base:

197147 Command-line switches for IExpress software update packages

If the package uses the .msi or .msp file name extension, the software update package uses Windows Installer as the Setup program. For additional information about command-line options that Windows Installer uses, visit the following Microsoft Web site:

http://msdn2.microsoft.com/en-us/library/aa367988.aspx

Software updates for Windows NT 4.0 and those included in Windows 2000 Service Pack 3 or earlier use Hotfix.exe as the Setup program.

Update.exe is used as the Setup program for software updates that are included in Windows 2000 Service Pack 4 and later versions and that are included in Windows XP and Windows Server 2003.

Note Some software update packages for the versions of Windows that are listed in the &quot;Applies to&quot; section use IExpress or Windows Installer packages. These packages do not use Hotfix.exe or Update.exe as the Setup program.

Overview of the installation process
When you run a Windows software update package without command-line switches, the Hotfix.exe or Update.exe Setup program is automatically run to install the software update. The following actions are performed by the Setup program: <ul> The installation program (Hotfix.exe or Update.exe) examines the service pack version you currently are using. If your service pack version is earlier than the software update version, but not earlier than the minimum version specified by the software update, and the language is the same, the Setup program automatically installs the software update. If your service pack version is later than the software update version, the installation does not continue.</li> If the software update language version does not match your operating system language, the installation does not continue.</li> If no version conflict exists, Hotfix.exe or Update.exe installs the software update.</li> The installation program registers the software update under one of the following registry keys:

</li> Removal information for the software update is stored in a hidden folder named $NtUninstallQ $ or $NtUninstallKB $ in %Systemroot%.</li></ul>

Command-line switches for the Update.exe program
The following tables list the command-line switches that are supported by each different version of the Update.exe program.

Notes <ul> We are adopting a consistent set of command-line switches that you can use to deploy packages that contain software updates. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

824687 Command-line switches for Microsoft software update packages

For backward compatibility, Windows software updates that implement the new standard switch names also support the setup switches that are used by the earlier version of the Update.exe. However, we recommend that you stop using the old switches because this support may be removed in future software updates.</li> All the switch options that are listed use a forward slash (/). For compatibility with older versions, a hyphen (-) can still be used instead of the forward slash (/).</li> To safely remove a software update, remove the one most recently installed first. For example, assume that hotfix A and hotfix B both replace the same file or registry keys, and that you installed hotfix A before you installed hotfix B. To return your system to the state before the installation of hotfix A, you must uninstall hotfix B before you uninstall hotfix A. For more information about how to remove Update.exe updates, click the following article number to view the article in the Microsoft Knowledge Base:

823836 Removing Windows software updates in the wrong order may cause the operating system to stop functioning

</li></ul>

Command-line switches for the Hotfix.exe program
The following table lists the command-line switches that are supported by the Hotfix.exe program.

For more information about how to install and remove software updates that use Hotfix.exe, click the following article number to view the article in the Microsoft Knowledge Base:

184305 How to install and remove hotfixes with Hotfix.exe

<div class="references_section">