Wiki source code of 4. Windows Install Options

Last modified by teamwire001 on 2025/09/11 14:59

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
teamwire001 4.2 50 (% style="border-color:var(--gili_blue_300)" %)
51 ----
teamwire001 2.1 52
teamwire001 4.2 53
teamwire001 2.1 54 {{id name="4-installcontext"/}}
55
56 == Installation context ==
57
teamwire001 4.1 58 {{tabs idsToLabels="context1=Desktop 4, context2=Until Desktop 3.4.3"/}}
59
60 (% id="context1" %)
61 (((
62 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.
63
teamwire001 2.1 64 Windows Installer can install a package on a computer into two installation contexts: per-machine and per-user.
65
teamwire003 2.2 66 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 67
68
69 {{id name="4-context-user"/}}
70
teamwire001 4.1 71 (% class="numbox" %)A(%%) (% class="numbox-title" %)Per user installation
teamwire001 2.1 72
73 By default, the package is installed in the per-user installation context. The following command performs the per-user installation:
74
teamwire001 4.1 75 {{code language="none"}}
teamwire001 2.1 76 msiexec.exe /i <path_to_package>
77 {{/code}}
78
79 Teamwire will be installed to the following directory: ##%LOCALAPPDATA%\Programs\Teamwire##
80
81
82 {{id name="4-context-machine"/}}
83
teamwire001 4.1 84 (% class="numbox" %)B(%%) (% class="numbox-title" %)Per machine installation
teamwire001 2.1 85
86 To install the package in the per-machine installation context, the ##ALLUSERS## parameter is required. The following command performs the per-machine installation:
87
teamwire001 4.1 88 {{code language="none"}}
teamwire001 2.1 89 msiexec.exe /i <path_to_package> ALLUSERS=1
90 {{/code}}
91
92 Teamwire will be installed to the following directory: ##C:\Program Files\Teamwire##
93
94
95 {{id name="4-context-custom"/}}
96
teamwire001 4.1 97 (% class="numbox" %)C(%%) (% class="numbox-title" %)Custom installation directory
teamwire001 2.1 98
99 You can define a custom directory for the Teamwire app installation with the following parameters:
100
teamwire001 4.1 101 {{code language="none"}}
teamwire001 2.1 102 msiexec.exe /i <path_to_package> APPLICATIONFOLDER=<absolute_application_path>
103 {{/code}}
104
teamwire001 4.1 105 Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
106 )))
teamwire001 2.1 107
teamwire001 4.1 108 (% id="context2" %)
109 (((
110 {{id name="roamingdir"/}}
teamwire001 2.1 111
teamwire001 4.1 112 (% class="numbox" %)A(%%) (% class="numbox-title" %)Roaming user data directory
teamwire001 2.1 113
teamwire001 4.1 114 {{code language="none"}}/APPDATA=TRUE{{/code}} ## ##
teamwire001 2.1 115
teamwire001 4.1 116 This is an optional parameter.
teamwire001 2.1 117
teamwire001 4.1 118 By default, the user's data is written to the ##%LOCALAPPDATA%## directory (##..\AppData\Local\##).
teamwire001 2.1 119
teamwire001 4.1 120 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 121
teamwire001 1.1 122 Example:
123
teamwire001 4.1 124 {{code language="none"}}
125 start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\
teamwire001 1.1 126 {{/code}}
127
teamwire001 3.1 128 An app shortcut will be created automatically and can be found in the Teamwire software directory.
teamwire001 1.1 129
teamwire001 4.1 130 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 131
teamwire001 1.1 132
teamwire001 4.1 133 {{id name="customdir"/}}
teamwire001 1.1 134
teamwire001 4.1 135 (% class="numbox" %)B(%%) (% class="numbox-title" %)Custom user data directory
teamwire001 1.1 136
teamwire001 4.1 137 {{code language="none"}}/USERDATADIR=<path>{{/code}} ## ##
teamwire001 1.1 138
teamwire001 3.1 139 This is an optional parameter.
140
teamwire001 4.1 141 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 142
teamwire001 4.1 143 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 144
145 Example:
146
teamwire001 4.1 147 {{code language="none"}}
148 start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\
teamwire001 1.1 149 {{/code}}
150
151 An app shortcut will be created automatically and can be found in the Teamwire software directory.
152
teamwire001 4.1 153 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 154
155
156
teamwire001 4.1 157 {{id name="runonstartup"/}}
teamwire001 1.1 158
teamwire001 4.1 159 (% class="numbox" %)C(%%) (% class="numbox-title" %)Run on startup
teamwire001 1.1 160
teamwire001 4.1 161 {{code language="none"}}/STARTUP=TRUE{{/code}} ## ##
162
teamwire001 3.1 163 This is an optional parameter.
164
teamwire001 4.1 165 With this parameter you enable the feature to run Teamwire on Windows startup.
teamwire001 1.1 166
167 Example:
168
teamwire001 4.1 169 {{code language="none"}}
170 start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\
teamwire001 1.1 171 {{/code}}
teamwire001 4.1 172 )))
teamwire001 1.1 173
teamwire001 4.2 174 (% style="border-color:var(--gili_blue_300)" %)
175 ----
teamwire001 1.1 176
teamwire001 4.2 177
teamwire001 4.1 178 {{id name="4-quietdeinstall"/}}
teamwire001 1.1 179
teamwire001 4.1 180 = Quiet deinstallation =
teamwire001 1.1 181
teamwire001 4.1 182 {{tabs idsToLabels="deinstall1=Desktop 4, deinstall2=Until Desktop 3.4.3"/}}
teamwire001 1.1 183
teamwire001 4.1 184 (% id="deinstall1" %)
185 (((
186 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 187
teamwire001 4.1 188 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 189
teamwire001 3.1 190
teamwire001 4.1 191 To deinstall the Teamwire app quietly, use the following command and parameters:
teamwire001 1.1 192
teamwire001 4.1 193 {{code language="none"}}
194 msiexec.exe /x <path_to_package> /qn
teamwire001 1.1 195 {{/code}}
196
teamwire001 4.1 197 The MSI file path required for the deinstallation depends on your data management.
teamwire001 1.1 198
teamwire003 1.2 199
teamwire001 4.1 200 **Example A:** {{code language="none"}}msiexec.exe /x "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
201 The file which was also used during the installation has remained in its directory.
teamwire001 1.1 202
teamwire001 4.1 203
204 **Example B:** {{code language="none"}}msiexec.exe /x "C:\Windows\Installer\34237a6a.msi" /qn{{/code}}
205 You use the MSI file cached by the system. By default, it's stored under ##%SystemRoot%\Installer##.
206 )))
207
208 (% id="deinstall2" %)
209 (((
teamwire001 1.1 210 You can deinstall Teamwire in silent mode from a command line to avoid user interaction during the process.
211
212 Therefore the command syntax is
213
teamwire001 4.1 214 {{code language="none"}}
teamwire001 1.1 215 start "" /WAIT "<path>\uninstall.exe" /S
216 {{/code}}
217
218 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.**
219
teamwire001 4.1 220 Example: {{code language="none"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}}
teamwire001 1.1 221
teamwire001 4.1 222 {{info}}
teamwire001 1.1 223 Please note, the user data is not being removed for all users but the user performing the local deinstallation.
teamwire001 4.1 224 {{/info}}
teamwire001 1.1 225 )))
226
teamwire001 4.2 227 (% style="border-color:var(--gili_blue_300)" %)
228 ----
229
teamwire001 1.1 230 ## ##