How to manage settings for the Exclaimer Exchange Transport Agent using PowerShell

Scenario

You have installed the Exclaimer Exchange Transport Agent and want to view or change settings, such as changing which users' emails are routed to Exclaimer, viewing the current settings for troubleshooting or documentation purposes, and/or updating the settings on multiple Exchange servers at a time.

Resolution

Select an option below to view the related instructions:

Viewing Exclaimer - Exchange On-Premises current settings for troubleshooting or documentation purposes

To view the Exclaimer - Exchange On-Premises current settings using PowerShell:

Open Windows PowerShell.
Run the following command to get the current list of accepted groups:

Get-ExclaimerServiceAcceptedGroups
Run the following command to get the current API key:

Get-ExclaimerServiceApiKey
Run the following command to get the service URI:

Get-ExclaimerServiceUri
Run the following command to get the current list of accepted senders:

Get-ExclaimerServiceAcceptedSenders

Updating Exclaimer Exchange Transport Agent settings

To update Exclaimer Exchange Transport Agent current settings using PowerShell:

Open Windows PowerShell.
Run the following command to update the list of accepted senders:

Set-ExclaimerServiceAcceptedSenders -AcceptedSenders "first user's email address","second user's email address"
Run the following command to clear the list of accepted senders:

Set-ExclaimerServiceAcceptedSenders -ClearList
Run the following command to set the list of accepted groups:

Set-ExclaimerServiceAcceptedGroups -AcceptedGroups "first group's display name","second group's display name"
Run the following command to clear the list of accepted groups:

Set-ExclaimerServiceAcceptedGroups -ClearList
Run the following command to set the API key:

Set-ExclaimerServiceApiKey -ApiKey "your api key from the cloud portal"
Run the following command to set the service URI:

Set-ExclaimerServiceUri -Uri "your service uri from the cloud portal"

Additional information

These commands can also be run remotely to view or update the settings using the following command:

Invoke-Command -ComputerName <server name> {<command>}
For example:

Invoke-Command -ComputerName Server01 {Get-ExclaimerServiceUri} Invoke-Command -ComputerName Server01,Server02,Server03 {Get-ExclaimerServiceUri}
To view cmdlet help:

Get-Help <command>
For example:

Get-Help Set-ExclaimerServiceAcceptedGroups

Troubleshooting

If you encounter the following error:

You may need to reinstall the module.

Check that you can access the following file path: C:\Program Files\Exclaimer Ltd\Cloud Signatures for Exchange\Modules\Manage-ExclaimerAgentConfiguration
Open Powershell.
Run the following command:

Import-Module -Name "C:\Program Files\Exclaimer Ltd\Cloud Signatures for Exchange\Modules\Manage-ExclaimerAgentConfiguration"
If the problem persists, raise a Support ticket.

How easy was it to find what you needed?