Wiki source code of 4. Windows Install Options

Version 4.1 by teamwire001 on 2025/08/19 08:19

Hide last authors
teamwire001 4.1 1 {{id name="4-quietinstall"/}}
teamwire001 1.1 2
teamwire001 4.1 3 = Quiet installation =
teamwire001 1.1 4
teamwire001 4.1 5 {{tabs idsToLabels="install1=Desktop 4, install2=Until Desktop 3.4.3"/}}
teamwire001 2.1 6
teamwire001 4.1 7 (% id="install1" %)
8 (((
9 Microsoft Windows Installer is an installation and configuration service provided with Windows. It allows to run processes with the Windows command {{code language="none"}}msiexec{{/code}} without any user interaction.
teamwire001 2.1 10
teamwire001 4.1 11 The {{code language="none"}}msiexec{{/code}} **display options** allow a quiet installation. All available parameters can be found here: [[Microsoft ~> msiexec ~> Display options>>url:https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec#display-options||rel="noopener noreferrer" target="_blank"]]
teamwire001 2.1 12
13
14 To install the Teamwire app quietly, use the following command and parameters:
15
teamwire001 4.1 16 {{code language="none"}}
teamwire001 2.1 17 msiexec.exe /i <path_to_package> /qn
18 {{/code}}
19
teamwire001 4.1 20 Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
21 )))
teamwire001 2.1 22
teamwire001 4.1 23 (% id="install2" %)
24 (((
25 You can install Teamwire in silent mode from a command line to avoid user interaction during the process.
teamwire001 2.1 26
teamwire001 4.1 27 Therefore the command syntax is
teamwire001 2.1 28
teamwire001 4.1 29 {{code language="none"}}
30 start "" /WAIT Teamwire-setup_XXX.exe /S [optional parameters] /D=<path>
31 {{/code}}
teamwire001 2.1 32
teamwire001 4.1 33 Please enter the path to the Teamwire setup file and use the option ##/D## to define a directory in which Teamwire is going to install its further contents.
teamwire001 2.1 34
teamwire001 4.1 35 Example:
teamwire001 2.1 36
teamwire001 4.1 37 {{code language="none"}}
38 start "" /WAIT Teamwire-setup_1.10.0.exe /S /D=C:\Program Files (x86)\Teamwire\
teamwire001 2.1 39 {{/code}}
40
teamwire001 4.1 41 An app shortcut will be created automatically and can be found in the Teamwire software directory.
teamwire001 2.1 42
teamwire001 4.1 43 The shortcut's target for the default installation is {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"{{/code}}
teamwire001 2.1 44
teamwire001 4.1 45 {{info}}
46 Please note, the ##/D## option must be the **last parameter used** in the command line and **must not contain any quotation marks** even if the path contains spaces.
47 {{/info}}
48 )))
teamwire001 2.1 49
50
51 {{id name="4-installcontext"/}}
52
53 == Installation context ==
54
teamwire001 4.1 55 {{tabs idsToLabels="context1=Desktop 4, context2=Until Desktop 3.4.3"/}}
56
57 (% id="context1" %)
58 (((
59 Microsoft Windows Installer is an installation and configuration service provided with Windows. It allows to run processes with the Windows command {{code language="none"}}msiexec{{/code}} without any user interaction.
60
teamwire001 2.1 61 Windows Installer can install a package on a computer into two installation contexts: per-machine and per-user.
62
teamwire003 2.2 63 A per-machine installation of the package is required to enable **all users** of the computer to access and use the application. Because a per-machine installation makes changes to the system that affect all users, administrative permissions are required. Further information available here: [[Microsoft ~> Windows Installer ~> Installation context>>https://learn.microsoft.com/en-us/windows/win32/msi/installation-context||rel="noopener noreferrer" target="_blank"]]
teamwire001 2.1 64
65
66 {{id name="4-context-user"/}}
67
teamwire001 4.1 68 (% class="numbox" %)A(%%) (% class="numbox-title" %)Per user installation
teamwire001 2.1 69
70 By default, the package is installed in the per-user installation context. The following command performs the per-user installation:
71
teamwire001 4.1 72 {{code language="none"}}
teamwire001 2.1 73 msiexec.exe /i <path_to_package>
74 {{/code}}
75
76 Teamwire will be installed to the following directory: ##%LOCALAPPDATA%\Programs\Teamwire##
77
78
79 {{id name="4-context-machine"/}}
80
teamwire001 4.1 81 (% class="numbox" %)B(%%) (% class="numbox-title" %)Per machine installation
teamwire001 2.1 82
83 To install the package in the per-machine installation context, the ##ALLUSERS## parameter is required. The following command performs the per-machine installation:
84
teamwire001 4.1 85 {{code language="none"}}
teamwire001 2.1 86 msiexec.exe /i <path_to_package> ALLUSERS=1
87 {{/code}}
88
89 Teamwire will be installed to the following directory: ##C:\Program Files\Teamwire##
90
91
92 {{id name="4-context-custom"/}}
93
teamwire001 4.1 94 (% class="numbox" %)C(%%) (% class="numbox-title" %)Custom installation directory
teamwire001 2.1 95
96 You can define a custom directory for the Teamwire app installation with the following parameters:
97
teamwire001 4.1 98 {{code language="none"}}
teamwire001 2.1 99 msiexec.exe /i <path_to_package> APPLICATIONFOLDER=<absolute_application_path>
100 {{/code}}
101
teamwire001 4.1 102 Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
103 )))
teamwire001 2.1 104
teamwire001 4.1 105 (% id="context2" %)
106 (((
107 {{id name="roamingdir"/}}
teamwire001 2.1 108
teamwire001 4.1 109 (% class="numbox" %)A(%%) (% class="numbox-title" %)Roaming user data directory
teamwire001 2.1 110
teamwire001 4.1 111 {{code language="none"}}/APPDATA=TRUE{{/code}} ## ##
teamwire001 2.1 112
teamwire001 4.1 113 This is an optional parameter.
teamwire001 2.1 114
teamwire001 4.1 115 By default, the user's data is written to the ##%LOCALAPPDATA%## directory (##..\AppData\Local\##).
teamwire001 2.1 116
teamwire001 4.1 117 In some corporate and virtual environments, a folder's content is deleted when the session is closed. In order to write into ##%APPDATA%## directory (##..\AppData\Roaming\##), please add the ##/APPDATA=TRUE## argument to your command.
teamwire001 2.1 118
teamwire001 1.1 119 Example:
120
teamwire001 4.1 121 {{code language="none"}}
122 start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\
teamwire001 1.1 123 {{/code}}
124
teamwire001 3.1 125 An app shortcut will be created automatically and can be found in the Teamwire software directory.
teamwire001 1.1 126
teamwire001 4.1 127 The shortcut's target incl. the roaming directory is {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir=%APPDATA%/Teamwire{{/code}}
teamwire001 3.1 128
teamwire001 1.1 129
teamwire001 4.1 130 {{id name="customdir"/}}
teamwire001 1.1 131
teamwire001 4.1 132 (% class="numbox" %)B(%%) (% class="numbox-title" %)Custom user data directory
teamwire001 1.1 133
teamwire001 4.1 134 {{code language="none"}}/USERDATADIR=<path>{{/code}} ## ##
teamwire001 1.1 135
teamwire001 3.1 136 This is an optional parameter.
137
teamwire001 4.1 138 In case you need to store your user data to a different location due to your network environment or retention policies for local data, you are able to define a custom path (e.g. mapped home directory for your users) with the parameter ##/USERDATADIR##. **You will have to put the path in quotation marks.**
teamwire001 1.1 139
teamwire001 4.1 140 The customised directories will not be created until the first run and registration. Please note, that despite the custom path of user data the original directories (##%LOCALAPPDATA%\Teamwire\User Data\Default\##) will still be created but do not contain any data.
teamwire001 1.1 141
142 Example:
143
teamwire001 4.1 144 {{code language="none"}}
145 start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\
teamwire001 1.1 146 {{/code}}
147
148 An app shortcut will be created automatically and can be found in the Teamwire software directory.
149
teamwire001 4.1 150 The shortcut's target incl. the customised directory is {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir="<userdata_directory>\Teamwire"{{/code}}
teamwire001 1.1 151
152
153
teamwire001 4.1 154 {{id name="runonstartup"/}}
teamwire001 1.1 155
teamwire001 4.1 156 (% class="numbox" %)C(%%) (% class="numbox-title" %)Run on startup
teamwire001 1.1 157
teamwire001 4.1 158 {{code language="none"}}/STARTUP=TRUE{{/code}} ## ##
159
teamwire001 3.1 160 This is an optional parameter.
161
teamwire001 4.1 162 With this parameter you enable the feature to run Teamwire on Windows startup.
teamwire001 1.1 163
164 Example:
165
teamwire001 4.1 166 {{code language="none"}}
167 start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\
teamwire001 1.1 168 {{/code}}
teamwire001 4.1 169 )))
teamwire001 1.1 170
171
teamwire001 4.1 172 {{id name="4-quietdeinstall"/}}
teamwire001 1.1 173
teamwire001 4.1 174 = Quiet deinstallation =
teamwire001 1.1 175
teamwire001 4.1 176 {{tabs idsToLabels="deinstall1=Desktop 4, deinstall2=Until Desktop 3.4.3"/}}
teamwire001 1.1 177
teamwire001 4.1 178 (% id="deinstall1" %)
179 (((
180 Microsoft Windows Installer is an installation and configuration service provided with Windows. It allows to run processes with the Windows command {{code language="none"}}msiexec{{/code}} without any user interaction.
teamwire001 1.1 181
teamwire001 4.1 182 The {{code language="none"}}msiexec{{/code}} **display options** allow a quiet deinstallation. All available parameters can be found here: [[Microsoft ~> msiexec ~> Display options>>url:https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec#display-options||rel="noopener noreferrer" target="_blank"]]
teamwire001 1.1 183
teamwire001 3.1 184
teamwire001 4.1 185 To deinstall the Teamwire app quietly, use the following command and parameters:
teamwire001 1.1 186
teamwire001 4.1 187 {{code language="none"}}
188 msiexec.exe /x <path_to_package> /qn
teamwire001 1.1 189 {{/code}}
190
teamwire001 4.1 191 The MSI file path required for the deinstallation depends on your data management.
teamwire001 1.1 192
teamwire003 1.2 193
teamwire001 4.1 194 **Example A:** {{code language="none"}}msiexec.exe /x "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
195 The file which was also used during the installation has remained in its directory.
teamwire001 1.1 196
teamwire001 4.1 197
198 **Example B:** {{code language="none"}}msiexec.exe /x "C:\Windows\Installer\34237a6a.msi" /qn{{/code}}
199 You use the MSI file cached by the system. By default, it's stored under ##%SystemRoot%\Installer##.
200 )))
201
202 (% id="deinstall2" %)
203 (((
teamwire001 1.1 204 You can deinstall Teamwire in silent mode from a command line to avoid user interaction during the process.
205
206 Therefore the command syntax is
207
teamwire001 4.1 208 {{code language="none"}}
teamwire001 1.1 209 start "" /WAIT "<path>\uninstall.exe" /S
210 {{/code}}
211
212 Enter the path to the uninstalling file, which is located in the Teamwire root directory. **You will have to put the path in quotation marks.**
213
teamwire001 4.1 214 Example: {{code language="none"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}}
teamwire001 1.1 215
teamwire001 4.1 216 {{info}}
teamwire001 1.1 217 Please note, the user data is not being removed for all users but the user performing the local deinstallation.
teamwire001 4.1 218 {{/info}}
teamwire001 1.1 219 )))
220
221 ## ##