Windows Installer Provider::Install


Installs a Microsoft® Windows® Installer package file (.msi). Used by Microsoft® Provisioning Framework (MPF).

XML Input Schema

The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.

<executeData>1..1
  <userName>1..1</userName>
  <userPassword>1..1</userPassword>
  <installedServer>1..1</installedServer>
  <msiInstallHelper>1..1</msiInstallHelper>
  <msiPackage path="..">1..1
	<property name=".." value="..">0..unbounded</property>
  </msiPackage>
</executeData>

XML Output Schema

Install does not return data.

Elements and Attributes

The following table describes the XML elements and attributes. Unless otherwise indicated, the data type is string.

Element Description, relationships, and attributes
executeData Description:
Encapsulates the procedure's input data.

Children:
installedServer (minOccurs="1" maxOccurs="1")
msiInstallHelper (minOccurs="1" maxOccurs="1")
msiPackage (minOccurs="1" maxOccurs="1")
property (minOccurs="0" maxOccurs="*")
userName (minOccurs="1" maxOccurs="1")
userPassword (minOccurs="1" maxOccurs="1")

installedServer Description:
Target computer for the install.

Maximum Length:
1,024

Parent:
executeData

msiInstallHelper Description:
Path of the MPF InstallHelper agent that communicates with the Windows Installer on the target computer. Found in the Providers\InstallHelper\installhelper.msi file (usually located in Program Files\Microsoft Provisioning).

Maximum Length:
1,024

Parent:
executeData

msiPackage Description:
Windows Installer package file (.msi) to install.

Maximum Length:
1,024

Parent:
executeData

Attribute:

path Required. Windows Installer package file (.msi) to install.
property Description:
Install parameters for the .msi file.

Parent:
executeData

Attribute:

name Required. Name of the install property. Maximum length 1,024.
value Required. Value for the install property. Maximum length 1,024.
userName Description:
User security context to impersonate for the installation.

Maximum Length:
256

Parent:
executeData

userPassword Description:
Password for the user to impersonate for the installation.

Maximum Length:
256

Parent:
executeData

Remarks

The following example shows a sample Windows Installer install request.

<request>
  <data>
	<userName>bob1</userName>
	<userPassword>abc</userPassword>
	<installedServer>machine4</installedServer>
	<msiInstallHelper>c:\installhelper.msi</msiInstallHelper>
	<msiPackage path="\\machine4\c$\hello.msi">
	<property name="prop1" value="value1" />
	<property name="prop2" value="value2" />
	<property name="prop3" value="value3" />
	</msiPackage>
  </data>
  <procedure> 
	<execute procedure="Install" namespace="Windows Installer Provider">
	<before source="data" destination="executeData" mode="merge" />
	</execute>
  </procedure> 
</request>

See Also

Uninstall, Windows Installer Provider


Up Top of Page
© 1999-2002 Microsoft Corporation. All rights reserved.