(Winbom)
Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2
[section_name]
The [section_name] section contains entries for configuring the preinstallation of applications during Factory mode of Sysprep. You must preinstall the applications using the credentials specified in the UserName and Password entries in the [Factory] section of Winbom.ini.
This section can be used only with the [OEMRunOnce] section.
Answer-file entries for the [section_name] section
| Entry | Description |
|---|---|
CmdLine |
Specifies any parameters to append to the command, when running the application specified by the SetupFile entry, and the value of the InstallType entry is Attach or Standard. |
InstallType |
Specifies the method to use when preinstalling applications. |
Reboot |
Specifies whether to restart the computer after processing the [OEMRunOnce] section. |
RemoveStagePath |
Specifies whether to delete the folder specified by the StagePath entry. |
SectionName |
Specifies the section in the .inf file that contains the setup directives. |
SetupFile |
Specifies the setup or uninstall application in the location specified by the StagePath entry. |
SourcePath |
Specifies the location of files to stage, a Setup.exe, or an .inf file. |
StagePath |
Specifies either the location in which to place files or the location of files to remove. |
CmdLine
Specifies any parameters to append to the command, when running the application specified by the SetupFile entry, and the value of the InstallType entry is Attach or Standard.
Syntax
CmdLine = command line switches
| Value | Description |
|---|---|
command_line_switches |
Command line parameter. |
Example
[OEMRunOnce]
"Connect to shared folder", "net use R: \\server\share"
"First Application Stage", "Application1.Stage", MSI
"Second Application Stage", "Application2.Stage", MSI
"Third Application Stage", "Application3.Stage", MSI
[Application1.Stage]
CmdLine = -SMS
[Application2.Stage]
[Application3.Stage]
Comments
If the value of the InstallType entry is Detach, and the SetupFile entry does not have a value, Setup ignores the CmdLine entry.
If the value of the InstallType entry is Stage, Setup ignores the CmdLine entry.
If the command-line parameter specified by the CmdLine entry uses an InstallShield-based installer, you must add an -SMS parameter to the command line. You must capitalize -SMS. This command-line parameter ensures that the process created by the installer completes its operation before processing the next entry in the [OEMRunOnce] section.
InstallType
Specifies the method to use when preinstalling applications.
Syntax
InstallType = Attach | Detach | Stage | Standard
| Value | Description |
|---|---|
Attach |
Runs a setup program in a location specified by the StagePath entry, if you already staged the application files on the destination computer. |
Detach |
Removes the folder specified by the StagePath entry. |
Stage |
Copies the installed files and folders in a location specified by the SourcePath entry to a location specified by the StagePath entry, but does not configure any registry settings. If you specify the SetupFile entry, Setup ignores the StagePath entry and the Sysprep -factory command assumes that the SetupFile entry is a staging installation application. |
Standard |
Runs a standard setup application that is not an .msi file by using an application specified by the SetupFile entry at the location specified by the SourcePath entry. The command-line options specified by the CmdLine entry are appended to the command that runs the application specified by the SetupFile. The Standard entry is required if you install an application from an .inf file. |
Example
[OEMRunonce]
"Connect to shared folder", "net use R: \\server\share"
"First Application Stage", "Application1.Stage", MSI
"Second Application Stage", "Application2.Stage", MSI
"Third Application Stage", "Application3.Stage", MSI
[Application1.Stage]
InstallType = Attach
[Application2.Stage]
InstallType = Detach
[Application3.Stage]
InstallType = Stage
Comments
When you stage an application, all the files are placed on the computer but no changes are made to the registry. After the image of the master installation is placed onto the destination computer, you can either attach (complete the installation) or detach (remove all the files for) each application to configure the computer as ordered by the customer. This way, setting up the attached application is faster because Setup does not need to copy the files to the computer. And it is much faster to delete files from a computer than to install an application over a network connection, especially if this application is installed on a majority of the computers that you manufacture.
The following table shows the relationships between the InstallType values and the entries in the [OEMRunOnce] section.
Relationships Between InstallType Values [OEMRunOnce] Entries
| [OEMRunOnce] Entry | InstallType=Attach | InstallType=Detach | InstallType=Stage | InstallType=Standard |
|---|---|---|---|---|
CmdLine |
Append to SetupFile |
Ignored |
Ignored |
Append to SetupFile |
RemoveStagePath |
Default to Yes |
Ignored |
Ignored |
Ignored |
SectionName |
Ignored |
Ignored |
Ignored |
Required |
SetupFile |
Required if attaching an .msi file. Located in StagePath. |
Assumed to be Uninstall.exe. |
Required if staging an .msi file. Located in StagePath. |
Name of the .inf or .exe file. |
SourcePath |
Ignored |
Ignored |
Location of files to stage. |
Location of Setup.exe or .inf file. |
StagePath |
Required if attaching an .msi file. Location of files to stage. |
Required. Location of files to remove. |
Required. Location of files to stage |
|
If the value of the InstallType entry is Standard, you cannot process a second Winbom.ini file later to detach that application.
Reboot
Specifies whether to restart the computer after processing the [OEMRunOnce] section.
Syntax
Reboot = Yes | No
| Value | Description |
|---|---|
Yes |
Restarts the computer. |
No |
Does not restart the computer. |
Example
[OEMRunOnce]
"Connect to share folder", "net use R: \\server\share"
"First Application Stage", "Application1.Stage", MSI
"Second Application Stage", "Application2.Stage", MSI
"Third Application Stage", "Application3.Stage", MSI
[Application1.Stage]
Reboot = No
[Application2.Stage]
Reboot = No
[Application3.Stage]
Reboot = Yes
Comments
The default value is No.
RemoveStagePath
Specifies whether to restart the computer after processing the [OEMRunOnce] section.
Syntax
RemoveStagePath = Yes | No
| Value | Description |
|---|---|
Yes |
Deletes the StagePath folder and all of its contents. |
No |
Does not delete the folder. |
Example
[OEMRunOnce]
"Connect to shared folder", "net use R: \\server\share"
"First Application Stage", "Application1.Stage", MSI
"Second Application Stage", "Application2.Stage", MSI
"Third Application Stage", "Application3.Stage", MSI
[Application1.Stage]
RemoveStagePath = No
[Application2.Stage]
RemoveStagePath = Yes
[Application3.Stage]
RemoveStagePath = Yes
Comments
The default value is Yes.
Use this entry only when the value of the InstallType entry is Attach. If the location of your files specified by the SourcePath entry is local, and you do not want to delete these files, set the value of the RemoveStagePath entry to No. If the path is not local, Setup does not delete the source files.
If the value of the InstallType entry is Detach, Stage, or Standard, Setup ignores RemoveStagePath.
SectionName
Specifies the section in the .inf file that contains the setup directives.
Syntax
SectionName = sectionname
| Value | Description |
|---|---|
sectionname |
The name of the section containing the setup directives used during an .inf installation. |
Example
[OEMRunOnce]
"Connect to shared folder", "net use R: \\server\share"
"First Application Stage", "Application1.Stage", INF
"Second Application Stage", "Application2.Stage", INF
"Third Application Stage", "Application3.Stage", INF
[Application1.Stage]
SectionName = SectionNameA
[Application2.Stage]
SectionName = SectionNameB
[Application3.Stage]
SectionName = SectionNameC
Comments
The SectionName entry is required if the value of the InstallType entry is Standard and the application that you process is an .inf installation.
If the value of the InstallType entry is Attach, Detach, or Stage, Setup ignores the SectionName entry.
SetupFile
Specifies the setup or uninstall application in the location specified by the StagePath entry.
Syntax
SetupFile = filenname
| Value | Description |
|---|---|
filename |
The file name of the setup application. |
Example
[OEMRunOnce]
"Connect to share folder", "net use R: \\server\share"
"First Application Stage", "Application1.Stage", MSI
"Second Application Stage", "Application2.Stage", MSI
"Third Application Stage", "Application3.Stage", MSI
[Application1.Stage]
SetupFile = MySetupA.msi
[Application2.Stage]
SetupFile = MySetupB.msi
[Application3.Stage]
SetupFile = MySetupC.msi
Comments
The SetupFile entry is required if:
The value of the InstallType entry is Stage.
The value of the InstallType entry is Attach and the setup program is an .msi file.
If the value of the InstallType entry is Standard, the SetupFile entry is either an .inf file or an .exe file.
If the value of the InstallType entry is Detach, the SetupFile entry is assumed to be Uninstall.exe.
SourcePath
Specifies the location of files to stage, a Setup.exe, or an .inf file.
Syntax
SourcePath = source_path
| Value | Description |
|---|---|
source_path |
The file name of the setup application. |
Example
[OEMRunOnce]
"Connect to shared folder", "net use R: \\server\share"
"First Application Stage", "Application1.Stage", MSI
"Second Application Stage", "Application2.Stage", MSI
"Third Application Stage", "Application3.Stage", MSI
[Application1.Stage]
SourcePath = C:\MyFiles\Setup1.exe
[Application2.Stage]
SourcePath = C:\MyFiles\Setup2.exe
[Application3.Stage]
SourcePath = C:\MyFiles\Setup3.exe
Comments
The interpretation of source_path depends on the value of the InstallType entry.
If the value of InstallType entry is Stage, source_path is the location of the files to stage on the destination computer.
If the value of InstallType entry is Standard, source_path is the location of Setup.exe or an .inf file.
You must specify the value of the SourcePath entry if the value of the InstallType entry is Stage.
Setup ignores the SourcePath entry if the value of the InstallType entry is Attach or Detach.
StagePath
Specifies either the location in which to place files or the location of files to remove.
Syntax
StagePath = source_path
| Value | Description |
|---|---|
source_path |
The location of installation files. |
Example
[OEMRunOnce]
"Connect to shared folder", "net use R: \\server\share"
"First Application Stage", "Application1.Stage", MSI
"Second Application Stage", "Application2.Stage", MSI
"Third Application Stage", "Application3.Stage", MSI
[Application1.Stage]
StagePath = C:\MyFiles
[Application2.Stage]
StagePath = C:\MyFiles
[Application3.Stage]
StagePath = C:\MyFiles
Comments
The StagePath entry is required if:
The value of the InstallType entry is Stage.
The value of the InstallType entry is Attach and the setup program is an .msi file.
The value of the InstallType entry is Detach.
Setup ignores the StagePath entry if the value of the InstallType entry is Standard.
If the InstallType entry is Stage or Attach, stage_path is the location in which to place the files.
If the InstallType entry is Detach, target_path is the location of files to remove.