Export (0) Print
Expand All

Appendix C - Batch-Mode File Syntax and Command-Line Switches

This appendix describes how you use batch files and command-line switches to customize Microsoft® Windows® Update Setup, as well as command-line parameters for starting Microsoft® Internet Explorer 6.

Related Information in the Resource Kit

  • For more information about using batch files and command-line switches to customize the setup program, see "Time-saving Strategies That Address Diverse User Needs." 

Using Internet Explorer Batch-Mode Setup

In addition to using the Internet Explorer Customization Wizard to control the functionality and user experience during Windows Update Setup for Internet Explorer 6 and Internet Tools, you can further control the setup process by using a batch file. For example, you can create a batch file that specifies a silent, hands-free installation of Internet Explorer 6 and Internet Tools, determines all of the users' setup choices, and does not show any error messages to users. You can use a batch file when you install only Internet Explorer and Internet Tools or when you install the browser with other applications.

You can also use a combination of a batch file and command-line switches. In most cases, the batch file gives you more control over the installation of individual components and involves fewer steps. The command-line switches are provided for backward compatibility and to support custom solutions. For more information about command-line switches, see "Using Command-Line Switches" later in this chapter.

Using a Batch File to Modify the Setup Program

To create a batch file, use a text editor such as Microsoft® Notepad, and name the file IEBatch.txt. Then use one of the following methods to modify the setup program by using your IEBatch.txt file:

  • Include the batch file with the setup program. You can use the batch file with or without creating a custom browser package. If you distribute Internet Explorer over the Internet or an intranet, copy the batch file to the site where users will download Internet Explorer. If you distribute Internet Explorer on other media, such as a compact disc, copy the batch file to the same folder as the file IE6Setup.exe on the disc. 

  • Include the batch file as part of your custom browser package. Place the batch file in the \Iebin\<Language>\Optional folder. <Language> represents the language of the version you create. For example, English-language versions are created in the En folder. 

Batch-File Syntax

The following table identifies the sections and entries for the IEBatch.txt file.

Batch file entry

Description

[Options]

SaveUninstallInfo=[0,1]

Determines whether the setup program will store uninstall information for Internet Explorer and Internet Tools on users' computers.
0 The setup program will not store uninstall information. If you use this entry, users will not be able to uninstall Internet Explorer and Internet Tools from Windows Control Panel.
1 (default) The setup program will store uninstall information.

[Options]

ExtraSection=< section,section >

Identifies the sections, specified in the file IESetup.inf, that the setup program will run. Separate sections with commas (for example, section1,section2,section3).

Quiet=[A,C,U]

Specifies that the installation will run silently with little or no input from users.
A The installation will run in administrative mode. Users will not see the setup program, and the setup program will not perform error checking.
C The Cancel button will not appear on the installation progress page. Users will not be able to cancel the installation.
U Users will not see the setup program unless required input, such as the download location, is not available.

ShowErrors=[0,1]

Determines whether the setup program will display error messages to users.
0 The setup program will not display error messages. It will automatically perform the default action for each error message without requesting input from users.
1 (default) The setup program will display error messages.

[Welcome]

Display=[0,1]

Determines whether the setup program will display the initial setup page to users.
0 The setup program will not display the initial setup page.
1 (default) The setup program will display the initial setup page.

[SetupChoice]

Display=[0,1]

Determines whether the setup program will display the setup-type page. This page allows users to choose whether to customize the setup program.
0 The setup program will not display the setup-type page.
1 (default) The setup program will display the setup-type page.

SetupChoice=[0,1]

Determines which setup option the setup program will select.
0 (default) The setup program will select Install now—Typical Setup of Components.
1 The setup program will select Custom Setup.

[Custom]

Display=[0,1]

Determines whether the setup program will display the Component Options page. This page allows users to select components and click Advanced to specify more options.
0 The setup program will not display the Component Options page.
1 (default) The setup program will display the Component Options page.

InstallDir=foldername

Specifies the folder where the setup program will copy the installation files. If you do not include this setting, the setup program will use the current settings in the file IESetup.inf. If users have installed an earlier version of Internet Explorer, the setup program will copy the installation files to the same folder as the earlier version.

InstallDirRO=[0,1]

Specifies whether users will be able to change the installation folder.
0 (default) Users will not be able to change the installation folder.
1 Users will be able to change the installation folder.

UseInfInstallDir=[0,1]

Specifies the folder where the setup program will install Internet Explorer and Internet Tools.
0 (default) The setup program will use the default installation folder or the same folder in which an earlier version of Internet Explorer is already installed.
1 The setup program will use the installation folder specified in the file IESetup.inf.

SetupMode=[0,1,2]

Specifies the type of installation that the setup program will perform.
0 The setup program will perform a Minimal installation.
1 (default) The setup program will perform a Typical installation.
2 The setup program will perform a Full installation.

SetupModeRO=[0,1]

Determines whether users will be able to change the type of installation that occurs.
0 Users will be able to change the type of installation.
1 (default) Users will not be able to change the type of installation.

[Custom]

Component=
[ ComponentID,ComponentID ]

Specifies that the setup program will install only the listed components, which are identified by their ComponentID. The ComponentID is a string that uniquely identifies the component; you can find the corresponding string in the component sections of the file IESetup.cif.

ComponentListRO=[0,1]

Determines whether users will be able to specify which components are installed (in addition to the standard components for the selected type of installation).
0 (default) Users will be able to specify which components are installed.
1 Users will not be able to specify which components are installed.

DownloadOnly=[0,1]

Determines whether the setup program will only download Internet Explorer and Internet Tools or both download and install it.
0 (default) The setup program will download and install the files.
1 The setup program will download the files but not install them.

DownloadOnlyRO=[0,1]

Determines whether users will be able to specify if the setup program will only download Internet Explorer and Internet Tools or both download and install it.
0 (default) Users will be able to specify the download and installation activities.
1 Users will not be able to specify the download and installation activities.

ShowAdvanced=[0,1]

Determines whether the setup program will display the Advanced button on the Component Options page. When users click the Advanced button, the setup program displays the Download only, Compatibility, and Don't associate file types options.
0 The setup program will not display the Advanced button.
1 (default) The setup program will display theAdvanced button.

[Custom]

IEDefault=[0,1]

Determines whether Internet Explorer will be set as the default browser.
0 Internet Explorer will not be set as the default browser.
1 (default) Internet Explorer will be set as the default browser.

IEDefaultRO=[0,1]

Specifies whether users will be able to determine if Internet Explorer is set as the default browser.
0 Users will not be able to choose their default browser.
1 (default) Users will be able to choose their default browser.

[Download]

Display=[0,1]

Determines whether the setup program will display the option to download or install files on users' computers.
0 The setup program will not display the option to download or install files.
1 (default) The setup program will display the option to download or install files.

DownloadDir=foldername

Specifies the folder that the setup program will use for downloading files. If you do not include this setting, the setup program will create a folder named Windows Update Setup Files on the drive that has the most disk space.

DownloadDirRO=[0,1]

Specifies whether users will be able to change the folder that the setup program uses for downloading files.
0 (default) Users will be able to change the folder.
1 Users will not be able to change the folder.

DownloadOS=[0,1]

Specifies whether the setup program will download installation files for a specific operating system. This setting is valid only if users download but do not install files (DownloadOnly=1).
0 (default) The setup program will download installation files for the current operating system.
1 The setup program will download installation files for all operating systems.

[Download]

DownloadOSRO=[0,1]

Determines whether users will be able to specify the operating system for the installation files that the setup program downloads to their computers.
0 (default) Users will be able to specify the operating system for the installation files.
1 Users will not be able to specify the operating system for the installation files.

[DownloadSite]

Display=[0,1]

Determines whether the setup program will display the download sites to users.
0 The setup program will not display the download sites.
1 (default) The setup program will display the download sites.

DownloadLocation=URL

Specifies the address of the Web site that users will download cabinet (.cab) files from, if you plan to distribute Internet Explorer from the Web. If you set Display=0 for this section, or create any entry that would result in the download sites page not being displayed, specify a download site for this entry.

DownloadSiteList=URL

Specifies the location where the setup program will retrieve the list of download sites. By default, this list is the file IE6Sites.dat. If you do not include this setting, the setup program uses the current settings in the file IESetup.inf.

[PrepareSetup]

Display=[0,1]

Determines whether the setup program will display the Preparing Setup page on users' computers.
0 The setup program will not display the Preparing Setup page.
1 (default) The setup program will display the Preparing Setup page.

[Diskspace]

Display=[0,1]

Specifies whether the setup program will display the amount of disk space needed on users' computers.
0 The setup program will not display the amount of disk space needed on users' computers. If computers do not have enough disk space, the setup program will close.
1 (default) The setup program will display the amount of disk space needed on users' computers.

[Progress]

Display=[0,1]

Specifies whether the setup program will display the installation progress to users.
0 The setup program will not display the installation progress.
1 (default) The setup program will display the installation progress.

[RebootPartial]

Display=[0,1]

Determines whether the setup program will display the Installation Incomplete page if a component fails to install.
0 The setup program will not display the Installation Incomplete page.
1 (default) The setup program will display the Installation Incomplete page.

[Finish]

Display=[0,1]

Specifies whether the setup program will display the message about the computer restarting after setup is completed.
0 The setup program will not display the message about the computer restarting. Use this option if you plan to turn off restarting after installation (Reboot=0).
1 (default) The setup program will display the message about the computer restarting.

[Reboot]

Reboot=[0,1]

Specifies whether the setup program will restart users' computers when the installation is completed.
0 The setup program will not restart users' computers when the installation is completed. If you turn off restarting, your program must take care of restarting the computers. Internet Explorer will not be configured correctly until the computers are restarted.
1 (default) The setup program will restart users' computers when the installation is completed.

[Upgrade]

ReinstallAll=[0,1]

Specifies whether the setup program will reinstall all components if it is run a second time.
0 (default) The setup program will not run a second time if all components are already installed.
1 The setup program will reinstall all components if it is run a second time.

Sample Batch File

The following sample batch file shows installation directory choices, performs the first listed installation option, and automatically restarts the computer.

[Welcome]
Display=0

[SetupChoice]
Display=0

[Custom]
Display=0
Mode=0
InstallDir=c:\ie\en\

[Download]
Display=0
DownloadDir=c:\iedown\
[Finish]
Display=0
[Reboot]
Reboot=1

Using Command-Line Switches

You might want to control the way that the installation program (IE6wzd.exe) is run. You can use command-line switches to choose the type of installation, specify a quiet mode (which removes or reduces the prompts the user receives), or control whether the computer is restarted after installation.

You can have users include these switches when they run Setup, but a more typical scenario is to package Internet Explorer with another program for a batch installation. You can use the IExpress Wizard or another program to package your setup files.

The following table identifies Internet Explorer switches.

Internet Explorer switch

Description

/B: iebatch.tx t

Specifies the batch file that the setup program will use.

/D

Specifies that the setup program will download only the files for the current operating system.

/D:1

Specifies that the setup program will download files for Windows and Microsoft® Windows NT® operating systems.

/E: ComponentID,
ComponentID

Specifies additional components that the setup program will install, regardless of the type of installation. Use this switch to install components that are not a part of the installation type you specified in the Customization Wizard. This switch also overrides settings in the batch file, if used. The ComponentID is a string that uniquely identifies a component; you can find the corresponding string in the component sections of the file IESetup.cif.

/F -(Fix)

Specifies that the setup program will reinstall all items on users' computers that are the same version or newer than the Internet Explorer files being installed.

/G: section,section

Identifies the sections, specified in the file IESetup.inf, that the setup program will run. Separate sections with commas (for example, section1,section2,section3).

/M:[0|1|2|3...]

Specifies the type of installation that the setup program will perform. For custom browser packages, 0 refers to the first installation choice, 1 refers to the second choice, and so on (for example, 0=minimal, 1=typical (default), 2=full).

/P

Specifies that the setup program will display the amount of disk space needed for the installation based on the options selected.

/Q

Specifies that the installation will run in a quiet "hands-free" mode. The setup program will prompt users only for information that is not already specified.

/Q:A

Specifies that the installation will run in a quiet mode with no user prompts.

/Q:C

Specifies that the installation will run in a quiet mode, and the setup program will not display the Cancel button. Users will not be able to cancel the installation. The Corporate version of the Internet Explorer Customization Wizard uses this switch if you select the Install package silently option.

/R:N

Specifies that the setup program will not restart users' computers when the installation is completed. If you turn off restarting, your program must take care of restarting the computers. Internet Explorer will not be configured correctly until the computers are restarted.

/S:""#e""

Designates the source path where Setup will locate IE6Setup.exe. The ""#e"" refers to the full path and name of the executable (.exe) file. You must enclose the path with two pairs of double quotation marks.

/X

Specifies that the setup program will install Internet Explorer and Internet Tools without the shell, icons, or links. This option is useful for hosting browser controls in your own application.

/X:1

Specifies that the setup program will install Internet Explorer and Internet Tools with the shell, icons, or links, but will not take over default browser or HTTP protocol associations.

IExpress Switches

The following table identifies frequently used IExpress switches that control the extraction process during the setup. These switches are not specific to Internet Explorer.

IExpress switch

Description

/Q

Specifies that the installation will run in quiet mode.

/QU

Specifies that the installation will run in user-quiet mode, which presents some dialog boxes to users.

/QA

Specifies that the installation will run in administrator-quiet mode, which does not present any dialog boxes to users.

/C:<>

Specifies the path and name of the Setup.inf or .exe file that the setup program will use.

/R:N

Specifies that the setup program will never restart the computers after installation.

/R:A

Specifies that the setup program will always restart the computers after installation.

/R:S

Specifies that the setup program will restart the computers after installation without prompting users.

/T: <directory path>

Specifies the target folder that the setup program will use for extracting files.

Examples of Command-Line Switches

The following scenarios provide examples of how to use command-line switches:

  • The following command line runs the third installation option: 

    IE6Setup.exe /C:"ie6wzd /S:""#e"" /M:2"
    
    
  • The following command line performs an installation in quiet mode. It does not prompt users, and their computers are not restarted after the installation: 

    IE6Setup.exe /C:"ie6wzd /S:""#e"" /Q /R:N"
    
    

Command-Line Parameters for Starting Internet Explorer

In addition to using command-line switches to customize Setup, you can use command-line parameters to customize how Internet Explorer is started. For example, you can start Internet Explorer in Kiosk (full-screen) mode by adding a parameter to the Internet Explorer executable file name, as shown in the following syntax:

/path/Iexplore.exe -k

The following table identifies the parameters that you can use for starting Internet Explorer.

Parameter

Description

-new

Specifies that the browser window will start a new browsing process.

-k

Specifies that the browser will start in Kiosk (full-screen) mode.

-nohome

Specifies that the browser will start without its home page.

-embedding

Specifies that the Web browser control will start if no home page is displayed.

-channelband

Specifies that the browser will display the Channels folder.


Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft