Export (0) Print
Expand All

[section_name] (Winbom)

Updated: March 28, 2003

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.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft