Skip to Content
Last modified by teamwire001 on 2025/09/11 14:59
From version 2.1
edited by teamwire001
on 2023/11/07 11:38
Change comment: DOC-248
To version 4.2
edited by teamwire001
on 2025/09/11 14:59
Change comment: DOC-434

Summary

Details

Page properties
Content
... ... @@ -1,48 +1,54 @@
1 -= Desktop 4.0.0 or newer =
1 +{{id name="4-quietinstall"/}}
2 2  
3 += Quiet installation =
3 3  
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}}.
5 +{{tabs idsToLabels="install1=Desktop 4, install2=Until Desktop 3.4.3"/}}
5 5  
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"]].
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.
7 7  
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"]]
8 8  
9 -{{id name="4-quietinstall"/}}
10 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 -
16 16  To install the Teamwire app quietly, use the following command and parameters:
17 17  
18 -{{code language="shell"}}
16 +{{code language="none"}}
19 19  msiexec.exe /i <path_to_package> /qn
20 20  {{/code}}
21 21  
22 -Example: {{code language="shell"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
20 +Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
21 +)))
23 23  
23 +(% id="install2" %)
24 +(((
25 +You can install Teamwire in silent mode from a command line to avoid user interaction during the process.
24 24  
25 -{{id name="4-quietdeinstall"/}}
27 +Therefore the command syntax is
26 26  
27 -== Quiet deinstallation ==
29 +{{code language="none"}}
30 +start "" /WAIT Teamwire-setup_XXX.exe /S [optional parameters] /D=<path>
31 +{{/code}}
28 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"]]
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.
30 30  
35 +Example:
31 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
37 +{{code language="none"}}
38 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /D=C:\Program Files (x86)\Teamwire\
36 36  {{/code}}
37 37  
38 -The MSI file path required for the deinstallation depends on your data management.
41 +An app shortcut will be created automatically and can be found in the Teamwire software directory.
39 39  
43 +The shortcut's target for the default installation is {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"{{/code}}
40 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.
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 +)))
43 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##.
50 +(% style="border-color:var(--gili_blue_300)" %)
51 +----
46 46  
47 47  
48 48  {{id name="4-installcontext"/}}
... ... @@ -49,18 +49,24 @@
49 49  
50 50  == Installation context ==
51 51  
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 +
52 52  Windows Installer can install a package on a computer into two installation contexts: per-machine and per-user.
53 53  
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"]]
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"]]
55 55  
56 56  
57 57  {{id name="4-context-user"/}}
58 58  
59 -=== Per user ===
71 +(% class="numbox" %)A(%%) (% class="numbox-title" %)Per user installation
60 60  
61 61  By default, the package is installed in the per-user installation context. The following command performs the per-user installation:
62 62  
63 -{{code language="shell"}}
75 +{{code language="none"}}
64 64  msiexec.exe /i <path_to_package>
65 65  {{/code}}
66 66  
... ... @@ -69,11 +69,11 @@
69 69  
70 70  {{id name="4-context-machine"/}}
71 71  
72 -=== Per machine ===
84 +(% class="numbox" %)B(%%) (% class="numbox-title" %)Per machine installation
73 73  
74 74  To install the package in the per-machine installation context, the ##ALLUSERS## parameter is required. The following command performs the per-machine installation:
75 75  
76 -{{code language="shell"}}
88 +{{code language="none"}}
77 77  msiexec.exe /i <path_to_package> ALLUSERS=1
78 78  {{/code}}
79 79  
... ... @@ -82,148 +82,137 @@
82 82  
83 83  {{id name="4-context-custom"/}}
84 84  
85 -=== Custom installation directory ===
97 +(% class="numbox" %)C(%%) (% class="numbox-title" %)Custom installation directory
86 86  
87 87  You can define a custom directory for the Teamwire app installation with the following parameters:
88 88  
89 -{{code language="shell"}}
101 +{{code language="none"}}
90 90  msiexec.exe /i <path_to_package> APPLICATIONFOLDER=<absolute_application_path>
91 91  {{/code}}
92 92  
93 -Example: {{code language="shell"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
105 +Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
106 +)))
94 94  
108 +(% id="context2" %)
109 +(((
110 +{{id name="roamingdir"/}}
95 95  
112 +(% class="numbox" %)A(%%) (% class="numbox-title" %)Roaming user data directory
96 96  
97 -----
114 +{{code language="none"}}/APPDATA=TRUE{{/code}} ## ##
98 98  
99 -{{id name="desktop-previous"/}}
116 +This is an optional parameter.
100 100  
101 -= Until Desktop 3.4.2 =
118 +By default, the user's data is written to the ##%LOCALAPPDATA%## directory (##..\AppData\Local\##).
102 102  
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.
103 103  
104 -You can install Teamwire in silent mode from a command line to avoid user interaction during the process.
105 -
106 -Therefore the command syntax is
107 -
108 -{{code language="plain"}}
109 -start "" /WAIT Teamwire-setup_XXX.exe /S [optional parameters] /D=<path>
110 -{{/code}}
111 -
112 -## ##
113 -
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.
115 -
116 116  Example:
117 117  
118 -{{code language="plain"}}
119 -start "" /WAIT Teamwire-setup_1.10.0.exe /S /D=C:\Program Files (x86)\Teamwire\
124 +{{code language="none"}}
125 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\
120 120  {{/code}}
121 121  
122 -## ##
123 -
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 -)))
128 -
129 -## ##
130 -
131 131  An app shortcut will be created automatically and can be found in the Teamwire software directory.
132 132  
133 -The shortcut's target for the default installation is {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"{{/code}}
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}}
134 134  
135 135  
136 -{{id name="optional"/}}
133 +{{id name="customdir"/}}
137 137  
138 -= Optional parameters =
135 +(% class="numbox" %)B(%%) (% class="numbox-title" %)Custom user data directory
139 139  
140 -The following parameters are optional and support additional settings to be enabled during the installation.
137 +{{code language="none"}}/USERDATADIR=<path>{{/code}} ## ##
141 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.
139 +This is an optional parameter.
143 143  
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.**
144 144  
145 -{{id name="roamingdir"/}}
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.
146 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 155  Example:
156 156  
157 -{{code language="plain"}}
158 -start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\
147 +{{code language="none"}}
148 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\
159 159  {{/code}}
160 160  
161 -## ##
162 -
163 163  An app shortcut will be created automatically and can be found in the Teamwire software directory.
164 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}}
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}}
166 166  
167 167  
168 -{{id name="customdir"/}}
169 169  
170 -== Custom User Directory ==
157 +{{id name="runonstartup"/}}
171 171  
172 -{{code language="plain"}}/USERDATADIR=<path>{{/code}} ## ##
159 +(% class="numbox" %)C(%%) (% class="numbox-title" %)Run on startup
173 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.**
161 +{{code language="none"}}/STARTUP=TRUE{{/code}} ## ##
175 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.
163 +This is an optional parameter.
177 177  
165 +With this parameter you enable the feature to run Teamwire on Windows startup.
166 +
178 178  Example:
179 179  
180 -{{code language="plain"}}
181 -start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\
169 +{{code language="none"}}
170 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\
182 182  {{/code}}
172 +)))
183 183  
184 -## ##
174 +(% style="border-color:var(--gili_blue_300)" %)
175 +----
185 185  
186 -An app shortcut will be created automatically and can be found in the Teamwire software directory.
187 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}}
178 +{{id name="4-quietdeinstall"/}}
189 189  
180 += Quiet deinstallation =
190 190  
191 -{{id name="runonstartup"/}}
182 +{{tabs idsToLabels="deinstall1=Desktop 4, deinstall2=Until Desktop 3.4.3"/}}
192 192  
193 -== Run on Startup ==
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.
194 194  
195 -{{code language="plain"}}/STARTUP=TRUE{{/code}} ## ##
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"]]
196 196  
197 -With this parameter you enable the feature to run Teamwire on Windows startup.
198 198  
199 -Example:
191 +To deinstall the Teamwire app quietly, use the following command and parameters:
200 200  
201 -{{code language="plain"}}
202 -start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\
193 +{{code language="none"}}
194 +msiexec.exe /x <path_to_package> /qn
203 203  {{/code}}
204 204  
205 -## ##
197 +The MSI file path required for the deinstallation depends on your data management.
206 206  
207 -{{id name="silentdeinstall"/}}
208 208  
209 -= Silent Deinstallation =
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.
210 210  
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 +(((
211 211  You can deinstall Teamwire in silent mode from a command line to avoid user interaction during the process.
212 212  
213 213  Therefore the command syntax is
214 214  
215 -{{code language="plain"}}
214 +{{code language="none"}}
216 216  start "" /WAIT "<path>\uninstall.exe" /S
217 217  {{/code}}
218 218  
219 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 220  
221 -Example: {{code language="plain"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}}
220 +Example: {{code language="none"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}}
222 222  
223 -
224 -(% class="box infomessage" %)
225 -(((
222 +{{info}}
226 226  Please note, the user data is not being removed for all users but the user performing the local deinstallation.
224 +{{/info}}
227 227  )))
228 228  
227 +(% style="border-color:var(--gili_blue_300)" %)
228 +----
229 +
229 229  ## ##