Last modified by teamwire001 on 2026/07/08 06:34

From version 6.1
edited by teamwire001
on 2026/07/08 06:34
Change comment: DOC-573
To version 2.1
edited by teamwire001
on 2023/11/07 11:38
Change comment: DOC-248

Summary

Details

Page properties
Content
... ... @@ -1,39 +1,66 @@
1 -{{id name="4-quietinstall"/}}
1 += Desktop 4.0.0 or newer =
2 2  
3 -= Quiet installation =
4 4  
5 -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.
4 +Microsoft Windows Installer is an installation and configuration service provided with Windows. It allows to run processes with the Windows command {{code}}msiexec{{/code}}.
6 6  
7 -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"]]
6 +This command can be used, for example, to install Teamwire without any user interaction in [[quiet mode>>doc:||anchor="4-quietinstall"]]. Or to define the [[installation contexts>>doc:||anchor="4-installcontext"]].
8 8  
9 9  
9 +{{id name="4-quietinstall"/}}
10 +
11 +== Quiet installation ==
12 +
13 +The {{code}}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"]]
14 +
15 +
10 10  To install the Teamwire app quietly, use the following command and parameters:
11 11  
12 -{{code language="none"}}
18 +{{code language="shell"}}
13 13  msiexec.exe /i <path_to_package> /qn
14 14  {{/code}}
15 15  
16 -Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
22 +Example: {{code language="shell"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
17 17  
18 18  
25 +{{id name="4-quietdeinstall"/}}
26 +
27 +== Quiet deinstallation ==
28 +
29 +The {{code}}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"]]
30 +
31 +
32 +To deinstall the Teamwire app quietly, use the following command and parameters:
33 +
34 +{{code language="shell"}}
35 +msiexec.exe /x <path_to_package> /qn
36 +{{/code}}
37 +
38 +The MSI file path required for the deinstallation depends on your data management.
39 +
40 +
41 +Example A: {{code language="shell"}}msiexec.exe /x "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
42 +The file which was also used during the installation has remained in its directory.
43 +
44 +Example B: {{code language="shell"}}msiexec.exe /x "C:\Windows\Installer\34237a6a.msi" /qn{{/code}}
45 +You use the MSI file cached by the system. By default, it's stored under ##%SystemRoot%\Installer##.
46 +
47 +
19 19  {{id name="4-installcontext"/}}
20 20  
21 21  == Installation context ==
22 22  
23 -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.
24 -
25 25  Windows Installer can install a package on a computer into two installation contexts: per-machine and per-user.
26 26  
27 -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"]]
54 +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"]]
28 28  
29 29  
30 30  {{id name="4-context-user"/}}
31 31  
32 -(% class="numbox" %)A(%%) (% class="numbox-title" %)Per user installation
59 +=== Per user ===
33 33  
34 34  By default, the package is installed in the per-user installation context. The following command performs the per-user installation:
35 35  
36 -{{code language="none"}}
63 +{{code language="shell"}}
37 37  msiexec.exe /i <path_to_package>
38 38  {{/code}}
39 39  
... ... @@ -42,11 +42,11 @@
42 42  
43 43  {{id name="4-context-machine"/}}
44 44  
45 -(% class="numbox" %)B(%%) (% class="numbox-title" %)Per machine installation
72 +=== Per machine ===
46 46  
47 47  To install the package in the per-machine installation context, the ##ALLUSERS## parameter is required. The following command performs the per-machine installation:
48 48  
49 -{{code language="none"}}
76 +{{code language="shell"}}
50 50  msiexec.exe /i <path_to_package> ALLUSERS=1
51 51  {{/code}}
52 52  
... ... @@ -55,41 +55,148 @@
55 55  
56 56  {{id name="4-context-custom"/}}
57 57  
58 -(% class="numbox" %)C(%%) (% class="numbox-title" %)Custom installation directory
85 +=== Custom installation directory ===
59 59  
60 60  You can define a custom directory for the Teamwire app installation with the following parameters:
61 61  
62 -{{code language="none"}}
89 +{{code language="shell"}}
63 63  msiexec.exe /i <path_to_package> APPLICATIONFOLDER=<absolute_application_path>
64 64  {{/code}}
65 65  
66 -Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
93 +Example: {{code language="shell"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
67 67  
68 68  
69 -{{id name="4-quietdeinstall"/}}
70 70  
71 -= Quiet deinstallation =
97 +----
72 72  
73 -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.
99 +{{id name="desktop-previous"/}}
74 74  
75 -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"]]
101 += Until Desktop 3.4.2 =
76 76  
77 77  
78 -To deinstall the Teamwire app quietly, use the following command and parameters:
104 +You can install Teamwire in silent mode from a command line to avoid user interaction during the process.
79 79  
80 -{{code language="none"}}
81 -msiexec.exe /x <path_to_package> /qn
106 +Therefore the command syntax is
107 +
108 +{{code language="plain"}}
109 +start "" /WAIT Teamwire-setup_XXX.exe /S [optional parameters] /D=<path>
82 82  {{/code}}
83 83  
84 -The MSI file path required for the deinstallation depends on your data management.
112 +## ##
85 85  
114 +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.
86 86  
87 -**Example A:** {{code language="none"}}msiexec.exe /x "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
88 -The file which was also used during the installation has remained in its directory.
116 +Example:
89 89  
118 +{{code language="plain"}}
119 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /D=C:\Program Files (x86)\Teamwire\
120 +{{/code}}
90 90  
91 -**Example B:** {{code language="none"}}msiexec.exe /x "C:\Windows\Installer\34237a6a.msi" /qn{{/code}}
92 -You use the MSI file cached by the system. By default, it's stored under ##%SystemRoot%\Installer##.
122 +## ##
93 93  
124 +(% class="box infomessage" %)
125 +(((
126 +Please note, ##/D## must be the **last parameter used** in the command line and **must not contain any quotation marks** even if the path contains spaces.
127 +)))
94 94  
95 95  ## ##
130 +
131 +An app shortcut will be created automatically and can be found in the Teamwire software directory.
132 +
133 +The shortcut's target for the default installation is {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"{{/code}}
134 +
135 +
136 +{{id name="optional"/}}
137 +
138 += Optional parameters =
139 +
140 +The following parameters are optional and support additional settings to be enabled during the installation.
141 +
142 +Furthermore, please note that 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.
143 +
144 +
145 +{{id name="roamingdir"/}}
146 +
147 +== Roaming User Directory ==
148 +
149 +{{code language="plain"}}/APPDATA=TRUE{{/code}} ## ##
150 +
151 +By default, the user's data is written to the ##%LOCALAPPDATA%## directory ( ##..\AppData\Local\## ).
152 +
153 +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.
154 +
155 +Example:
156 +
157 +{{code language="plain"}}
158 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\
159 +{{/code}}
160 +
161 +## ##
162 +
163 +An app shortcut will be created automatically and can be found in the Teamwire software directory.
164 +
165 +The shortcut's target incl. the roaming directory is {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir=%APPDATA%/Teamwire{{/code}}
166 +
167 +
168 +{{id name="customdir"/}}
169 +
170 +== Custom User Directory ==
171 +
172 +{{code language="plain"}}/USERDATADIR=<path>{{/code}} ## ##
173 +
174 +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.**
175 +
176 +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.
177 +
178 +Example:
179 +
180 +{{code language="plain"}}
181 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\
182 +{{/code}}
183 +
184 +## ##
185 +
186 +An app shortcut will be created automatically and can be found in the Teamwire software directory.
187 +
188 +The shortcut's target incl. the customised directory is {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir="<userdata_directory>\Teamwire"{{/code}}
189 +
190 +
191 +{{id name="runonstartup"/}}
192 +
193 +== Run on Startup ==
194 +
195 +{{code language="plain"}}/STARTUP=TRUE{{/code}} ## ##
196 +
197 +With this parameter you enable the feature to run Teamwire on Windows startup.
198 +
199 +Example:
200 +
201 +{{code language="plain"}}
202 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\
203 +{{/code}}
204 +
205 +## ##
206 +
207 +{{id name="silentdeinstall"/}}
208 +
209 += Silent Deinstallation =
210 +
211 +You can deinstall Teamwire in silent mode from a command line to avoid user interaction during the process.
212 +
213 +Therefore the command syntax is
214 +
215 +{{code language="plain"}}
216 +start "" /WAIT "<path>\uninstall.exe" /S
217 +{{/code}}
218 +
219 +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.**
220 +
221 +Example: {{code language="plain"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}}
222 +
223 +
224 +(% class="box infomessage" %)
225 +(((
226 +Please note, the user data is not being removed for all users but the user performing the local deinstallation.
227 +)))
228 +
229 +## ##