Msiexec

Provides the means to install, modify, and perform operations on Windows Installer from the command line.

To install or configure a product

Syntax

msiexec /i {package|ProductCode}

Parameters

/i   : Installs or configures a product.

package   : Specifies the name of the Windows Installer package file.

ProductCode   : Specifies the globally unique identifier (GUID) of the Windows Installer package.

Remarks

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

Examples

To install a product from A:\Example.msi, type:

msiexec /i A:\Example.msi

To use the administrative installation option

Syntax

msiexec /a package

Parameters

/ a   : Applies the administrative installation option.

package   : The name of the Windows Installer package file.

Remarks

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

To repair a product

Syntax

msiexec /f [p][o][e][d][c][a][u][m][s][v]{package|ProductCode}

Parameters

/f   : Enables one or more of the command-line options listed in the following table.

Command

Description

p

Reinstalls only if file is missing.

o

Reinstalls if file is missing or if an older version is installed.

e

Reinstalls if file is missing or an equal or older version is installed.

d

Reinstalls if file is missing or a different version is installed.

c

Reinstalls if file is missing or the stored checksum does not match the calculated value.

a

Forces all files to be reinstalled.

u

Rewrite all required user-specific registry entries.

m

Rewrites all required computer-specific registry entries.

s

Overwrites all existing shortcuts.

v

Runs from source and re-caches the local package.

package   : Name of the Windows Installer package file.

ProductCode   : Globally unique identifier (GUID) of the Windows Installer package.

Remarks

  • This option ignores any property values that you type at the command line.

  • The default parameter for this command-line option is /fpecms.

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

Examples

To repair the installation package, type:

msiexec /fpecms Example.msi

To uninstall a product

Syntax

msiexec /x {package|ProductCode}

Parameters

/x   : uninstalls a product.

package   : Name of the Windows Installer package file.

ProductCode   : Globally unique identifier (GUID) of the Windows Installer package.

Remarks

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

Examples

To remove or uninstall a package, type:

msiexec /x Example.msi

To advertise a product

Syntax

msiexec /j [{u|m}] package

msiexec {u|m} package /t TransformList 

msiexec {u|m} package /g LanguageID

Parameters

/j   : Advertises a product.

u   : Advertises to the current user.

m   : Advertises to all users of the computer.

package   : Specifies the Windows Installer package file.

/g   LanguageID   : Identifies the language.

/t   TransformList   : Applies transform to advertised package.

Remarks

  • This option ignores any property values that you type at the command line.

  • If you want to install the application with elevated privileges, use /jm.

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

Examples

To advertise a package to all users of this computer, type:

msiexec /jm Example.msi

To advertise a package to all users of this computer, type:

msiexec /jm Example.msi

To set logging level

Syntax

msiexec /L [i][w][e][a][r][u][c][m][p][v][+][!]LogFile**.txt**

Parameters

/L   : Specifies the path to the log file.

i   : Logs status messages.

w   : Logs nonfatal warnings.

e   : Logs all error messages.

a   : Logs startup of actions.

r   : Logs action-specific records.

u   : Logs user requests.

c   : Logs initial user interface parameters.

m   : Logs out-of-memory.

p   : Logs terminal properties.

v   : Logs verbose output. To use v, specify /L*v.

+   : Appends to existing file.

!   : Flushes each line to the log.

*   : Logs all information except for the v option. This is a wildcard.

LogFile .txt   : Name and path of the text log file.

Remarks

  • Windows Installer command-line options are not case-sensitive.

  • To include the v option in a log file using the wildcard flag, type /L*v at the command prompt.

  • The Windows Installer log file options can also be used with the uninstall and repair processes.

  • For more information about the Windows Installer command-line options, see Related Topics.

Examples

To install a package and create a log file that contains the information related to the status, out-of-memory, and error messages, type:

msiexec /i Example.msi /Lime logfile.txt

To apply a patch

Syntax

msiexec /p PatchPackage

Parameters

/p   : Applies a patch.

PatchPackage   : Specific patch.

Remarks

  • To apply a patch to an administrative installation package, use the following syntax:

    msiexec /p PatchPackage /a Example.msi

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

To install a transform using the command line

Syntax

msiexec /i packageTRANSFORMS=TransformList

Parameters

/i   : Installs or configures a product.

package   : Specifies the Windows Installer package file.

TRANSFORMS = : Property that is used to specify what transform (.mst) files should be applied to the package.

TransformList   : List of paths separated by semicolons.

Remarks

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

To advertise a product using a transform with the command line

Syntax

msiexec /j[u][m] package /t TransformList

Parameters

/j   : Advertises a product. This option ignores any property values entered on the command line.

u   : Advertises to the current user.

m   : Advertises to all users of this computer.

package   : Name of the Windows Installer package file.

/t   : Applies transform to advertised package.

TransformList   : List of paths separated by semicolons.

Remarks

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

To set the user interface level

Syntax

msiexec /q{n|b|r|f|n+|b+|b-}

Parameters

/qn   : Displays no user interface.

/qb   : Displays a basic user interface.

/qr   : Displays a reduced user interface with a modal dialog box displayed at the end of the installation.

/qf   : Displays the full user interface with a modal dialog box displayed at the end.

/qn+   : Displays no user interface, except for a modal dialog box displayed at the end.

/qb+   : Displays a basic user interface with a modal dialog box displayed at the end.

/qb-   : Displays a basic user interface with no modal dialog boxes.

Remarks

  • /qb+- is not a supported user interface level. The modal box is not displayed if the user cancels the installation.

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

Examples

To display the basic user interface options during the package installation of Example.msi, type:

msiexec /qb Example.msi

To display copyright information for the Windows Installer

Syntax

msiexec {/?|/h}

Parameters

{ /? | /h } : Displays the Windows Installer version and copyright information.

Remarks

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

To call the system API DllRegisterServer to self-register modules passed on the command line

Syntax

msiexec /y module

Parameters

/y   : Calls the system API DllRegisterServer to self-register modules passed on the command line.

module   : Specifies the file name of module.

Remarks

  • This option is used only for registry information that cannot be added using the registry tables of the .msi file.

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

Examples

The following example shows how you can use the msiexec /y command:

msiexec /y my_file.dll

To call the system API DllUnRegisterServer to unregister modules passed on the command line

Syntax

msiexec /z module

Parameters

/z   : Calls the system API DllUnRegisterServer to unregister modules passed on the command line.

module   : File name of module.

Remarks

  • This option is used only for registry information that cannot be added using the registry tables of the .msi file.

  • Windows Installer command-line options are not case-sensitive.

  • For more information about the Windows Installer command-line options, see Related Topics.

Examples

The following example shows how you can use the msiexec /z command:

msiexec /z my_file.dll

Formatting legend

Format

Meaning

Italic

Information that the user must supply

Bold

Elements that the user must type exactly as shown

Ellipsis (...)

Parameter that can be repeated several times in a command line

Between brackets ([])

Optional items

Between braces ({}); choices separated by pipe (|). Example: {even|odd}

Set of choices from which the user must choose only one

Courier font

Code or program output

Install a package using the command line

Install a transform using the command line

Install and advertise a product with a transform using the command line

Create an administrative installation package from the command line

Repair a package using the command line

Remove a package using the command line

Advertise a package using the command line

Create an installation log file using the command line

Command-line reference A-Z