4. Windows Install Options
Desktop 4.0.0 or newer
Microsoft Windows Installer is an installation and configuration service provided with Windows. It allows to run processes with the Windows command msiexec.
This command can be used, for example, to install Teamwire without any user interaction in quiet mode. Or to define the installation contexts.
Quiet installation
The msiexec display options allow a quiet installation. All available parameters can be found here: Microsoft > msiexec > Display options
To install the Teamwire app quietly, use the following command and parameters:
Example: msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn
Quiet deinstallation
The msiexec display options allow a quiet deinstallation. All available parameters can be found here: Microsoft > msiexec > Display options
To deinstall the Teamwire app quietly, use the following command and parameters:
The MSI file path required for the deinstallation depends on your data management.
Example A: msiexec.exe /x "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn
The file which was also used during the installation has remained in its directory.
Example B: msiexec.exe /x "C:\Windows\Installer\34237a6a.msi" /qn
You use the MSI file cached by the system. By default, it's stored under %SystemRoot%\Installer.
Installation context
Windows Installer can install a package on a computer into two installation contexts: per-machine and per-user.
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
Per user
By default, the package is installed in the per-user installation context. The following command performs the per-user installation:
Teamwire will be installed to the following directory: %LOCALAPPDATA%\Programs\Teamwire
Per machine
To install the package in the per-machine installation context, the ALLUSERS parameter is required. The following command performs the per-machine installation:
Teamwire will be installed to the following directory: C:\Program Files\Teamwire
Custom installation directory
You can define a custom directory for the Teamwire app installation with the following parameters:
Example: msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"
Until Desktop 3.4.2
You can install Teamwire in silent mode from a command line to avoid user interaction during the process.
Therefore the command syntax is
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.
Example:
An app shortcut will be created automatically and can be found in the Teamwire software directory.
The shortcut's target for the default installation is "<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"
Optional parameters
The following parameters are optional and support additional settings to be enabled during the installation.
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.
Roaming User Directory
/APPDATA=TRUE
By default, the user's data is written to the %LOCALAPPDATA% directory ( ..\AppData\Local\ ).
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.
Example:
An app shortcut will be created automatically and can be found in the Teamwire software directory.
The shortcut's target incl. the roaming directory is "<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir=%APPDATA%/Teamwire
Custom User Directory
/USERDATADIR=<path>
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.
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.
Example:
An app shortcut will be created automatically and can be found in the Teamwire software directory.
The shortcut's target incl. the customised directory is "<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir="<userdata_directory>\Teamwire"
Run on Startup
/STARTUP=TRUE
With this parameter you enable the feature to run Teamwire on Windows startup.
Example:
Silent Deinstallation
You can deinstall Teamwire in silent mode from a command line to avoid user interaction during the process.
Therefore the command syntax is
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.
Example: start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S