Skip to content

Commit 00c834c

Browse files
committed
Add script to test binary installer options
1 parent e4fe559 commit 00c834c

File tree

5 files changed

+1605
-1112
lines changed

5 files changed

+1605
-1112
lines changed
Original file line numberDiff line numberDiff line change
@@ -1,116 +1,147 @@
1-
Setup Command Line Parameters
1+
# Setup Command Line Parameters
22

33
(Taken from InnoSetup Help v. 6.1.2 Deember 2020)
44

55
The Setup program accepts optional command line parameters. These can be useful to system administrators, and to other programs calling the Setup program.
66

7-
/HELP, /?
7+
8+
**/HELP, /?**
9+
810
Shows a summary of this information. Ignored if the UseSetupLdr [Setup] section directive was set to no.
911

10-
/SP-
12+
13+
**/SP-**
14+
1115
Disables the This will install... Do you wish to continue? prompt at the beginning of Setup. Of course, this will have no effect if the DisableStartupPrompt [Setup] section directive was set to yes.
1216

13-
/SILENT, /VERYSILENT
17+
18+
**/SILENT, /VERYSILENT**
19+
1420
Instructs Setup to be silent or very silent. When Setup is silent the wizard and the background window are not displayed but the installation progress window is. When a setup is very silent this installation progress window is not displayed. Everything else is normal so for example error messages during installation are displayed and the startup prompt is (if you haven't disabled it with DisableStartupPrompt or the '/SP-' command line option explained above).
1521

1622
If a restart is necessary and the '/NORESTART' command isn't used (see below) and Setup is silent, it will display a Reboot now? message box. If it's very silent it will reboot without asking.
1723

18-
/SUPPRESSMSGBOXES
24+
25+
**/SUPPRESSMSGBOXES**
26+
1927
Instructs Setup to suppress message boxes. Only has an effect when combined with '/SILENT' or '/VERYSILENT'.
2028

2129
The default response in situations where there's a choice is:
2230

23-
•Yes in a 'Keep newer file?' situation.
24-
•No in a 'File exists, confirm overwrite.' situation.
25-
•Abort in Abort/Retry situations.
26-
•Cancel in Retry/Cancel situations.
27-
•Yes (=continue) in a DiskSpaceWarning/DirExists/DirDoesntExist/NoUninstallWarning/ExitSetupMessage/ConfirmUninstall situation.
28-
•Yes (=restart) in a FinishedRestartMessage/UninstalledAndNeedsRestart situation.
29-
•The recommended choice in a PrivilegesRequiredOverridesAllowed=dialog situation.
31+
- Yes in a 'Keep newer file?' situation.
32+
- No in a 'File exists, confirm overwrite.' situation.
33+
- Abort in Abort/Retry situations.
34+
- Cancel in Retry/Cancel situations.
35+
- Yes (=continue) in a DiskSpaceWarning/DirExists/DirDoesntExist/NoUninstallWarning/ExitSetupMessage/ConfirmUninstall situation.
36+
- Yes (=restart) in a FinishedRestartMessage/UninstalledAndNeedsRestart situation.
37+
- The recommended choice in a PrivilegesRequiredOverridesAllowed=dialog situation.
38+
3039
5 message boxes are not suppressible:
3140

32-
•The About Setup message box.
33-
•The Exit Setup? message box.
34-
•The FileNotInDir2 message box displayed when Setup requires a new disk to be inserted and the disk was not found.
35-
•Any (error) message box displayed before Setup (or Uninstall) could read the command line parameters.
36-
•Any task dialog or message box displayed by [Code] support functions TaskDialogMsgBox and MsgBox.
41+
- The About Setup message box.
42+
- The Exit Setup? message box.
43+
- The FileNotInDir2 message box displayed when Setup requires a new disk to be inserted and the disk was not found.
44+
- Any (error) message box displayed before Setup (or Uninstall) could read the command line parameters.
45+
- Any task dialog or message box displayed by [Code] support functions TaskDialogMsgBox and MsgBox.
46+
47+
**/ALLUSERS**
3748

38-
/ALLUSERS
3949
Instructs Setup to install in administrative install mode. Only has an effect when the [Setup] section directive PrivilegesRequiredOverridesAllowed allows the commandline override.
4050

41-
/CURRENTUSER
51+
**/CURRENTUSER**
52+
4253
Instructs Setup to install in non administrative install mode. Only has an effect when the [Setup] section directive PrivilegesRequiredOverridesAllowed allows the commandline override.
4354

44-
/LOG
55+
**/LOG**
56+
4557
Causes Setup to create a log file in the user's TEMP directory detailing file installation and [Run] actions taken during the installation process. This can be a helpful debugging aid. For example, if you suspect a file isn't being replaced when you believe it should be (or vice versa), the log file will tell you if the file was really skipped, and why.
4658

4759
The log file is created with a unique name based on the current date. (It will not overwrite or append to existing files.)
4860

4961
The information contained in the log file is technical in nature and therefore not intended to be understandable by end users. Nor is it designed to be machine-parsable; the format of the file is subject to change without notice.
5062

51-
/LOG="filename"
63+
**/LOG="filename"**
64+
5265
Same as /LOG, except it allows you to specify a fixed path/filename to use for the log file. If a file with the specified name already exists it will be overwritten. If the file cannot be created, Setup will abort with an error message.
5366

54-
/NOCANCEL
67+
**/NOCANCEL**
68+
5569
Prevents the user from cancelling during the installation process, by disabling the Cancel button and ignoring clicks on the close button. Useful along with '/SILENT' or '/VERYSILENT'.
5670

57-
/NORESTART
71+
**/NORESTART**
72+
5873
Prevents Setup from restarting the system following a successful installation, or after a Preparing to Install failure that requests a restart. Typically used along with /SILENT or /VERYSILENT.
5974

60-
/RESTARTEXITCODE=exit code
75+
**/RESTARTEXITCODE=exit code**
76+
6177
Specifies a custom exit code that Setup is to return when the system needs to be restarted following a successful installation. (By default, 0 is returned in this case.) Typically used along with /NORESTART. See also: Setup Exit Codes
6278

63-
/CLOSEAPPLICATIONS
79+
**/CLOSEAPPLICATIONS**
80+
6481
Instructs Setup to close applications using files that need to be updated by Setup if possible.
6582

66-
/NOCLOSEAPPLICATIONS
83+
**/NOCLOSEAPPLICATIONS**
84+
6785
Prevents Setup from closing applications using files that need to be updated by Setup. If /CLOSEAPPLICATIONS was also used, this command line parameter is ignored.
6886

69-
/FORCECLOSEAPPLICATIONS
87+
**/FORCECLOSEAPPLICATIONS**
88+
7089
Instructs Setup to force close when closing applications.
7190

72-
/NOFORCECLOSEAPPLICATIONS
91+
**/NOFORCECLOSEAPPLICATIONS**
92+
7393
Prevents Setup from force closing when closing applications. If /FORCECLOSEAPPLICATIONS was also used, this command line parameter is ignored.
7494

75-
/LOGCLOSEAPPLICATIONS
95+
**/LOGCLOSEAPPLICATIONS**
96+
7697
Instructs Setup to create extra logging when closing applications for debugging purposes.
7798

78-
/RESTARTAPPLICATIONS
99+
**/RESTARTAPPLICATIONS**
100+
79101
Instructs Setup to restart applications if possible.
80102

81-
/NORESTARTAPPLICATIONS
103+
**/NORESTARTAPPLICATIONS**
104+
82105
Prevents Setup from restarting applications. If /RESTARTAPPLICATIONS was also used, this command line parameter is ignored.
83106

84-
/LOADINF="filename"
107+
**/LOADINF="filename"**
108+
85109
Instructs Setup to load the settings from the specified file after having checked the command line. This file can be prepared using the '/SAVEINF=' command as explained below.
86110

87111
Don't forget to use quotes if the filename contains spaces.
88112

89-
/SAVEINF="filename"
113+
**/SAVEINF="filename"**
114+
90115
Instructs Setup to save installation settings to the specified file.
91116

92117
Don't forget to use quotes if the filename contains spaces.
93118

94-
/LANG=language
119+
**/LANG=language**
120+
95121
Specifies the language to use. language specifies the internal name of the language as specified in a [Languages] section entry.
96122

97123
When a valid /LANG parameter is used, the Select Language dialog will be suppressed.
98124

99-
/DIR="x:\dirname"
125+
**/DIR="x:\dirname"**
126+
100127
Overrides the default directory name displayed on the Select Destination Location wizard page. A fully qualified pathname must be specified. May include an "expand:" prefix which instructs Setup to expand any constants in the name. For example: '/DIR=expand:{autopf}\My Program'.
101128

102-
/GROUP="folder name"
129+
**/GROUP="folder name"**
130+
103131
Overrides the default folder name displayed on the Select Start Menu Folder wizard page. May include an "expand:" prefix, see '/DIR='. If the [Setup] section directive DisableProgramGroupPage was set to yes, this command line parameter is ignored.
104132

105-
/NOICONS
133+
**/NOICONS**
134+
106135
Instructs Setup to initially check the Don't create a Start Menu folder check box on the Select Start Menu Folder wizard page.
107136

108-
/TYPE=type name
137+
**/TYPE=type name**
138+
109139
Overrides the default setup type.
110140

111141
If the specified type exists and isn't a custom type, then any /COMPONENTS parameter will be ignored.
112142

113-
/COMPONENTS="comma separated list of component names"
143+
**/COMPONENTS="comma separated list of component names"**
144+
114145
Overrides the default component settings. Using this command line parameter causes Setup to automatically select a custom type. If no custom type is defined, this parameter is ignored.
115146

116147
Only the specified components will be selected; the rest will be deselected.
@@ -120,33 +151,63 @@ If a component name is prefixed with a "*" character, any child components will
120151
This parameter does not change the state of components that include the fixed flag.
121152

122153
Example:
154+
123155
Deselect all components, then select the "help" and "plugins" components:
124-
/COMPONENTS="help,plugins" Example:
156+
157+
```
158+
/COMPONENTS="help,plugins"
159+
```
160+
161+
Example:
162+
125163
Deselect all components, then select a parent component and all of its children with the exception of one:
126-
/COMPONENTS="*parent,!parent\child"
127-
/TASKS="comma separated list of task names"
164+
165+
```
166+
/COMPONENTS="*parent,!parent\child" /TASKS="comma separated list of task names"
167+
```
168+
128169
Specifies a list of tasks that should be initially selected.
129170

130171
Only the specified tasks will be selected; the rest will be deselected. Use the /MERGETASKS parameter instead if you want to keep the default set of tasks and only select/deselect some of them.
131172

132173
If a task name is prefixed with a "*" character, any child tasks will be selected as well (except for those that include the dontinheritcheck flag). If a task name is prefixed with a "!" character, the task will be deselected.
133174

134175
Example:
176+
135177
Deselect all tasks, then select the "desktopicon" and "fileassoc" tasks:
136-
/TASKS="desktopicon,fileassoc" Example:
178+
179+
```
180+
/TASKS="desktopicon,fileassoc"
181+
```
182+
183+
Example:
184+
137185
Deselect all tasks, then select a parent task and all of its children with the exception of one:
138-
/TASKS="*parent,!parent\child"
139-
/MERGETASKS="comma separated list of task names"
186+
187+
```
188+
/TASKS="*parent,!parent\child" /MERGETASKS="comma separated list of task names"
189+
```
190+
140191
Like the /TASKS parameter, except the specified tasks will be merged with the set of tasks that would have otherwise been selected by default.
141192

142193
If UsePreviousTasks is set to yes, the specified tasks will be selected/deselected after any previous tasks are restored.
143194

144195
Example:
196+
145197
Keep the default set of selected tasks, but additionally select the "desktopicon" and "fileassoc" tasks:
146-
/MERGETASKS="desktopicon,fileassoc" Example:
198+
199+
```
200+
/MERGETASKS="desktopicon,fileassoc"
201+
```
202+
203+
Example:
204+
147205
Keep the default set of selected tasks, but deselect the "desktopicon" task:
148-
/MERGETASKS="!desktopicon"
149-
/PASSWORD=password
206+
207+
```
208+
/MERGETASKS="!desktopicon" /PASSWORD=password
209+
```
210+
150211
Specifies the password to use. If the [Setup] section directive Password was not set, this command line parameter is ignored.
151212

152213
When an invalid password is specified, this command line parameter is also ignored.

0 commit comments

Comments
 (0)