To use the Exchange On-Premises feature, you need to install the Exclaimer Exchange Transport Agent. If you want to install it on Windows Server Desktop Experience - see Installing Exclaimer Exchange Transport Agent (on Windows Server Desktop Experience).
This page describes the process of how you can retrieve the Exclaimer Exchange Transport Agent and install the Exclaimer Exchange Transport Agent.
Before you install the Exclaimer Exchange Transport Agent, please ensure you have:
- Windows Server 2016 and up
- Exchange 2016 and up running the latest Cumulative Updates (CU)
- A configured Exclaimer Cloud: Signatures for Microsoft 365 subscription
- Azure AD Connect configured and synchronized
- A Domain Administrator account
- PowerShell 4 and .Net Framework 4.7.2 installed
NOTE: Exclaimer Support is only provided for the versions listed here.
To retrieve the Exclaimer Transport Agent:
- Click the Download link highlighted below (Exclaimer Exchange Transport Agent) to download the latest version of the Exclaimer Exchange Transport Agent onto your computer, then copy the downloaded files to each of your mailbox servers.
- Click New Key to create a new API Key.
The Add API Key window is displayed. - Enter a descriptive name for the new API Key.
- Click OK to create the key, else click Cancel to close the window without creating the new key.
The new API Key is displayed in the API Keys list.
This concludes the steps you need to do on the portal.
At this stage, you copy the API key to a Notepad as the API Key is displayed in full. Once you exit from this window, the API key is encrypted, and you cannot copy it. And once it is encrypted, the only solution to proceed with the installation is to create a new API key. You will need the API key when you enter the parameter details for installation.
You can also copy the Service Uri to a Notepad, making it easy to copy the path when you enter the parameter details for the installation.
To install the Exclaimer Exchange Transport Agent on Windows Server Core:
- Once the files have been successfully downloaded, open the Exchange Management Shell.
- Enter the command to the folder path where the file has been downloaded.
cd 'C:\Users\<username>\Downloads'NOTE: In most cases, Windows stores the Downloads folder under your user profile. To navigate to the Downloads folder quickly, type in the following PowerShell command:
cd $env:userprofile\downloads
- Enter the following command to run the installer:
msiexec /i "\<full path to MSI>"For example: msiexec /i “C:\Temp\ExclaimerCloudForExchange.msi” - Follow the steps onscreen to complete the installation.
As it is a Microsoft Installer (MSI), there are a number of values you can pass to the MSI when installing it via msiexec to allow for an installation that requires little graphical interaction.
The different parameters you can pass in the MSI are listed below with examples:
Name |
Required |
Description |
---|---|---|
IMPRINTFRONTEND_URL | Yes | The URL is given in the Portal - this is the address of the imprint server your emails will pass through in order to receive a signature. Example: msiexec /i “C:\Temp\ExclaimerCloudForExchange.msi” IMPRINTFRONTEND_URL="https://us.imprint.exclaimer.net" API_KEY="*****************************************************" /q
For more information, see Service Uri in Exclaimer Cloud Signatures for Exchange. |
API_KEY | Yes | The API Key you created within the Portal - this needs to be validated in order to route an email to the Exclaimer service. For more information, including how to add and remove API keys, see the API Keys section in Exclaimer Cloud Signatures for Exchange. |
INSTALLFOLDER | No | The location where the routing agent will be installed. We recommend it to be on the root drive of the server, that is C:\Program Files\ |
ACCEPTED_SENDERS | No | This is a comma-separated array of SMTP email addresses. It is used to limit the routing agent to a specific list of sender addresses that will be processed. |
ACCEPTED_GROUPS | No |
This is a comma-separated array of distribution groups. It is used to limit the routing agent to a specific list of distribution groups whose members will be processed. |
For more information, please see: How to manage Exclaimer Cloud Signatures for Exchange settings using PowerShell?