ConfigureProduct Method (productCode, installLevel, installState, commandLine)

DTF API

Copy image CopyHover image
Deployment Tools Foundation ConfigureProduct Method (productCode, installLevel, installState, commandLine)
Deployment Tools Foundation NamespacesMicrosoft.Deployment.WindowsInstallerInstallerConfigureProduct(String, Int32, InstallState, String)
Installs or uninstalls a product.
Declaration Syntax
C# Visual Basic Visual C++ F#
public static void ConfigureProduct(
	string productCode,
	int installLevel,
	InstallState installState,
	string commandLine
)
Public Shared Sub ConfigureProduct ( 
	productCode As String,
	installLevel As Integer,
	installState As InstallState,
	commandLine As String
)
public:
static void ConfigureProduct(
	String^ productCode, 
	int installLevel, 
	InstallState installState, 
	String^ commandLine
)
static member ConfigureProduct : 
        productCode : string * 
        installLevel : int * 
        installState : InstallState * 
        commandLine : string -> unit 
Parameters
productCode (String)
Product code of the product to be configured.
installLevel (Int32)
Specifies the default installation configuration of the product. The installLevel parameter is ignored and all features are installed if the installState parameter is set to any other value than Default. This parameter must be either 0 (install using authored feature levels), 65535 (install all features), or a value between 0 and 65535 to install a subset of available features.
installState (InstallState)
Specifies the installation state for the product.
commandLine (String)
Specifies the command line property settings. This should be a list of the format Property=Setting Property=Setting.
Remarks

This method displays the user interface with the current settings and log mode. You can change user interface settings with the SetInternalUI(InstallUIOptions) and SetExternalUI(ExternalUIHandler, InstallLogModes) functions. You can set the log mode with the EnableLog(InstallLogModes, String) function.

The RebootRequired and RebootInitiated properties should be tested after calling this method.

Win32 MSI APIs: MsiConfigureProduct, MsiConfigureProductEx

Exceptions
Exception Condition
InstallerException There was an error configuring the product

Assembly: Microsoft.Deployment.WindowsInstaller (Module: Microsoft.Deployment.WindowsInstaller.dll) Version: 3.0.0.0 (3.11.1.2318)