Custom installation and profile creation of the Oxtender 2 for Microsoft Outlook

This page contains information for administrators who would like to customize the installation or profile creation process for the OXtender 2 for Microsoft Outlook.


Custom installation

Silent or customized installations of the OXtender 2 for Microsoft Outlook can be done using the executable "Msiexec.exe" that is located in the "Windows\System32" directory by default. Detailed usage instructions are shown when starting Msiexec.exe without parameters or at http://msdn.microsoft.com/en-us/library/aa367988%28v=vs.85%29.aspx .

Besides the default msi commandline switches, the following properties can be used to customize the installation and profile creation process:

OXtender properties
Property name Description Default value
OX_CREATEPROFILE whether to create a profile during installation or not (0/1) 1
OX_PROFILENAME the name of the profile to be created OXtender 2
OX_SERVERURL the OX server URL used for profile creation https://
OX_USERNAME the username used during profile creation
OX_PASSWORD the password used during profile creation
OX_OVERWRITEPROFILE whether to overwrite an existing profile with the same name or not (0/1) 0
OX_DEFAULTPROFILE whether to mark the profile as default or not (0/1) 0
OX_PROFILESHOWUI whether to allow UI at profile creation during installation (uiNever = 0 / ulAllowed = 1 / ulAlways = 2) 1
OX_SETPICKLOGONPROFILE sets the 'PickLogonProfile' to the value set during profile creation (/0/1) 1

For example, to perform a quiet installation with automatic profile creation, one could use:

Msiexec.exe /qb /i "OXtender 2 for Microsoft Outlook_v7.0.26_en-us.msi" OX_CREATEPROFILE=1 OX_PROFILENAME="Jens Mander" OX_SERVERURL="https://ox.example.invalid" OX_USERNAME="jens.mander@ox.example.invalid" OX_PASSWORD="secret" OX_DEFAULTPROFILE=1 OX_SETPICKLOGONPROFILE=0


Profile creation

In a similar way, the utitlity OXProfileHelper.exe can be used to create OXtender 2 mail profiles from the commandline. This utitlity is automatically installed with the Oxtender 2 for Microsoft Outlook package and is located inside the "Profile" subdirectory of the installation folder, (e.g. C:\Program Files\Open-Xchange\OXtender 2 for Microsoft Outlook\Profile). The following table shows the possible commandline parameters (you can also see a list of available options by executing OXProfileHelper.exe without any parameters):

OXProfileHelper options
Option Description Default value
profilename Name of the profile to be created OXtender 2
defaultprofile true/false False
overwriteprofile true/false False
serverurl URL of the OX server http://
username Username on the OX server
password Password on the OX server
serverwins true/false True
showui 0 = never, 1 = allowed, 2 = always 1
parenthandle Handle of the parent window 0
picklogonprofile Sets PickLogonProfile in the registry 1

For example, to create profile, one could use:

OXProfileHelper.exe -profilename "Jens Mander" -serverurl "https://ox.example.invalid" -username "jens.mander@ox.example.invalid" -password "secret" -picklogonprofile 0