IconViewer Home
Bot Productions Home

Advanced Setup Options

IconViewer's installation package (e.g. IconViewer3.01-Setup-x86.exe) can accept several command-line switches for modifying the setup experience. These can be used to assist in deployment.

In addition, once installed, the setup program setup.exe can accept command-line switches for uninstall.

Install - Command-line switches

package.exe [/passive | /quiet] [/u:unattend.txt]
SwitchMeaning
passiveUnattended Setup mode. No user interaction is required, but installation status is displayed.
quietQuiet mode. This is the same as unattended mode, but no status or error messages are displayed.
u:unattend.txtInstall options will be retrieved from the file unattend.txt. See the section Using an unattend file below for more information.

When in passive or quiet mode, and an unttend file is not specified or does not specify all options, Setup will use default install options.

Note: When in passive or quiet mode, the IconViewer license agreement is not displayed to the end user. You must read and agree to the License Agreement before installing IconViewer on your computer or deploying it to another computer.

Uninstall - Command-line switches

Setup.exe is located in the folder in which you installed IconViewer, e.g. C:\Program Files\IconViewer.

setup.exe /uninstall [/passive | /quiet] [/u:unattend.txt]
SwitchMeaning
uninstallRequired for uninstall.
passiveUnattended Setup mode. No user interaction is required, but uninstallation status is displayed.
quietQuiet mode. This is the same as unattended mode, but no status or error messages are displayed.
u:unattend.txtUninstall options will be retrieved from the file unattend.txt. See the section Using an unattend file below for more information.

When in passive or quiet mode, and an unttend file is not specified or does not specify all options, Setup will use default uninstall options.

Using an unattend file

An unattend file is used to specify responses to the questions that the Setup wizard asks during installation. For normal mode (that is, when the quiet or passive switches are not specified), Setup uses the unattend file's values to populate the wizard, but the user can change the settings. In passive and quiet mode, the unattend file's values are used and cannot be changed.

An unattend file has the same format as a standard Windows configuration (ini) file. It consists of sections, containing key/value pairs.

Settings used during install only:

KeyMeaning
[Setup]
InstallPath
The folder to install IconViewer into. You may use environment variables, such as %ProgramFiles%.

The default installation folder is %ProgramFiles%\IconViewer.

[Setup]
SMShortcutHelp
Whether to create a Start Menu shortcut to the IconViewer help file. Set to one of the following values:

1Create the shortcut.
0(Default) Do not create the shortcut.
[Setup]
SMShortcutUninstall
Whether to create a Start Menu shortcut for uninstalling IconViewer. Set to one of the following values:

1Create the shortcut.
0(Default) Do not create the shortcut.
[Setup]
SMFolderType
Where to create IconViewer Start Menu shortcuts. Set to one of the following values:

0(Default) Let Setup decide. If only one shortcut is to be created, create it in the main Programs folder; if more than one, create them in the IconViewer subfolder.
1Create the shortcut(s) in the main Programs folder.
2Create the shortcut(s) in a new subfolder specified by the SMNewFolder setting.
3Create the shortcut(s) in the existing subfolder specified by the SMExistingFolder setting.
[Setup]
SMNewFolder
The new Start Menu folder that should be created for the program shortcut(s), if the SMFolderType setting or the user specifies to create a new folder.

The default folder is named IconViewer.

[Setup]
SMExistingFolder
The existing Start Menu folder that in which to create shortcut(s), if the SMFolderType setting or the user specifies to use an existing folder.

This setting is only used if SMFolderType=3. If the folder does not exist, it will be treated as the value of SMNewFolder and SMFolderType will be treated as 2.

Settings used during uninstall only:

KeyMeaning
[UserInit]
DeleteUserData
Whether to delete user-specific IconViewer settings. On Windows 95, 98, and Me, this only includes settings for the user currently logged in. On Windows NT, 2000, XP, and newer versions, this includes all users who have used IconViewer on the local machine. Set to one of the following values:

1(Default) Delete the settings.
0Do not delete the settings.
[UserInit]
DeleteMachineData
Whether to delete machine-wide IconViewer settings (those that apply to all users). Set to one of the following values:

1(Default) Delete the settings.
0Do not delete the settings.

Following is an example of an unattend file for IconViewer:

[Setup]
InstallPath=%ProgramFiles%\My Folder
SMShortcutHelp=1
SMShortcutUninstall=0
SMFolderType=2
SMNewFolder=IconViewer Help

[UserInit]
DeleteUserData=0
DeleteMachineData=0

When specifying an unattend file on the command line, you may use an individual file name, relative path, or absolute path. If the path or file name contains spaces, enclose it in quotes. For example:

IconViewer3.01-Setup-x86.exe /quiet
   /u:"C:\My Files\unattend.txt"

©2020 Bot Productions. All rights reserved.Last Updated: May 2, 2008