Microsoft Exchange extension settings
Overview
The Cayosoft Administrator Exchange extension ensures provisioning, update, suspension, and management of recipients in on-premises Microsoft Exchange Server. This includes mailbox-enabled and mail-enabled users, distribution lists, contacts, and shared mailboxes.
To perform recipient management tasks in Exchange Server, Cayosoft Administrator must be connected to Exchange Server. Connection and other general settings related to the mailbox management in the Exchange Server are configured in the Microsoft Exchange extension settings screen in the Cayosoft Administrator console. Some of these settings are related directly to Exchange Server; other settings are related to the configuration of the Cayosoft Administrator automation rules.
Microsoft Exchange extension settings
To configure the extension, in the Cayosoft Administrator console, navigate to Home > Configuration > Connected Systems Extensions. Select the extension and configure the following:
| Setting name | Description |
|---|---|
| Extension is enabled | Enable or disable the Microsoft Exchange extension. See the Initial configuration wizard article section to determine which extensions can be used in your environment. |
| Exchange credentials |
Specify the Active Directory user account that Cayosoft Administrator will use to connect to Microsoft Exchange. The Exchange connection account should have the Exchange Organization Management role. For more information, see the Cayosoft Administrator System Requirements and Permissions required for Exchange On-Premises Management articles. |
| Connect URI |
Specify the remote PowerShell connection URL of the target Exchange server. The default URL is:
or
|
| Maximum returned results | Limit the maximum number of objects returned from the Microsoft Exchange server. By default, all objects that you have in Exchange Server are returned. |
Advanced
| Command name | Description |
|---|---|
| Additional connection parameters |
Specify additional connection options. See the Microsoft Docs article for New-PSSessionOption for details. The default value is:
Copy
|
Actions
| Command name | Description |
|---|---|
| Check settings | This command validates the specified settings and verifies that the account credentials are correct. For additional information, refer to the Notes section. |
Troubleshooting Exchange Server connection issues
Notes
To connect and authenticate to Microsoft Exchange Server, Cayosoft Administrator creates a remote PowerShell session to access Exchange Server. To access the server, the port 5985 or 5986 is used depending on the protocol. The following script replicates the session creation workflow:
###
$ExchangeOnPrem_ConnectUri="<ExchangeOnPrem_ConnectUri>"
$ExchangeOnPrem_Cred = (Get-Credential)
###
[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12 -bor [Net.SecurityProtocolType]::Ssl3
$connectionParams = @{}
if($ExchangeOnPrem_ConnectUri.Trim() -like"http:*"){ $connectionParams.Add("Authentication", "Kerberos") }else{ $connectionParams.Add("Authentication", "Basic") }
$url = $ExchangeOnPrem_ConnectUri.Trim()
if ($url.EndsWith("/") -eq$false) { $url = $url + "/" }
$global:OnPremisesSession = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri $url -AllowRedirection -SessionOption (New-PSSessionOption -SkipRevocationCheck) -Credential $ExchangeOnPrem_Cred @connectionParams
$tmpImported = Import-PSSession$global:OnPremisesSession
###IMPORTANT: Replace the <ExchangeOnPrem_ConnectUri> placeholder with the Connect URI value. A Connect URL value follows the http://<ServerFQDN>/PowerShell/ format. For additional information, see the Connect URI setting.
When you run the script, you are prompted for credentials to connect to Exchange Server—provide the credentials of a user with the Exchange Organization Management role and click OK to proceed. If no error is prompted, the session has been created successfully. In case of an error, refer to the following article: Troubleshooting Cayosoft Administrator Exchange On-premises Connections.
Change History
| Version | Notes |
|---|---|
| 12.2.3 | Additional information on the connection and authentication process has been added. |
| 10.3.0 | Additional connection parameters setting has been added. |
Comments
0 comments
Please sign in to leave a comment.