Email

Description

Specifies the default mail server to use when Automate sends an email On Task Error, or when the Connection parameter is set to System for the Email - Send message activity.

To access the Email properties for Task Agents, select Options on the Server Management Console's navigation bar, and then select Default Properties > Task Agents > Email.

NOTE: By default, these properties are inherited by all agents on the system unless they are set by way of the individual agent, workflow, or task level. For more details regarding inheritance hierarchies, see Property Inheritance.

Related Topics

Mail server

Property Description
SMTP/Microsoft Exchange The mail server to use for outgoing email. The available options are:
  • SMTP - Uses Simple Mail Transfer Protocol (SMTP) as the mail server. Refer to the SMTP parameters for this option.
  • Microsoft Exchange - Uses Exchange as the mail server. Refer to the Microsoft Exchange parameters for this option.

SMTP parameters

The following parameters are available when the mail server is set to SMTP:

Property Description
Server The default SMTP mail server to use (for example, mail.yourdomain.com).
Port The port number to use for the default SMTP mail server. If the Security parameter is set to No Security or Explicit TLS/SSL the default port number is 25, and if it is set to Implicit TLS/SS, the default port number is 465. The port number can also vary for special network configurations.
Authentication type Specifies the type of authentication to use. The available options are:
  • None (default) - Select this option if authentication is not required.
  • Auto - This option automatically determines the authentication type to use.
  • Plain - Authentication is through the Plain protocol.  
  • Digest-MD5 - Authentication is through the Digest-MD5 protocol.
  • CRAM-MD5 - Authentication is through the CRAM-MD5 protocol.
  • Login - Authentication is through the Login protocol.
  • NTLM - Authentication is through the NTML protocol.
  • GSS-API - Authentication is through the GSS-API protocol.
Username The username to use to sign in to the SMTP mail server and authenticate the mail transaction. This parameter becomes available and is required when the Authentication type parameter is set to Auto, Plain, Digest-MD5, CRAM-MD5, Login, NTLM, or GSS-API.
Password The password to use to sign in to the SMTP mail server and authenticate the mail transaction. This parameter becomes available and is required when the Authentication type parameter is set to Auto, Plain, Digest-MD5, CRAM-MD5, Login, NTLM, or GSS-API.
Security Specifies the SMTP security settings. The available options are:
  • No security (default) - Select this option if encryption is not required.
  • Explicit TLS/SSL - Allows incoming connections to use the StartTLS command to initiate a secure TLS connection.
  • Implicit TLS/SSL - Allows a secondary dedicated port for secure SSL connections to be opened. The implicit SSL port will also be affected by all the normal port bindings and limits.
Certificate Specifies the path and file name of the certificate (.pfx) to use to authenticate. Select the icon to browse to the SSL certificate file. This parameter is only available if the Security parameter is set to Explicit TLS/SSL or Implicit TLS/SSL.
Passphrase The certificate passphrase to use to authenticate. This parameter is only available if the Security parameter is set to Explicit TLS/SSL or Implicit TLS/SSL.
Ignore invalid server certificate If selected, invalid or expired SSL server certificates are ignored. If disabled (default) and an invalid server certificate is found, this step throws an error stating that the security certificate on the server is not valid. This parameter is only available if the Security parameter is set to Explicit TLS/SSL or Implicit TLS/SSL.
Proxy Specifies the proxy type for use when attempting network communications through a proxy server. The available options are:
  • None - Select this option if a proxy server is not required.
  • SOCKS 4 - Communication is through a SOCKS 4-compliant server.
  • SOCKS 4A - Communication is through a SOCKS 4a -compliant server.
  • SOCKS 5 - Communication is through a SOCKS 5-compliant server.
  • HTTP - Communication is through an HTTP-compliant server.
NOTE: If you are unsure of the value to use in this parameter, contact your network administrator.
Proxy Server The hostname (server.domain.com) or IP address of the proxy server. This parameter is only available and required if the Proxy parameter is set to SOCKS 4, SOCKS 4A, SOCKS 5, or HTTP.
Proxy Port The proxy port number to use to connect to the proxy server. The default port is 0. Most proxy servers operate on port 1028, however, a proxy server can operate on other ports. This parameter is only available and required when the Proxy type parameter is set to SOCKS 4, SOCKS 4A, SOCKS 5, or HTTP.
Proxy Username The username to use to authenticate with the proxy server. This parameter is only available and required when the Proxy parameter is set to SOCKS 5 or HTTP.
Proxy Password The password corresponding with the Proxy Username parameter to use to authenticate with the proxy server. This parameter is encrypted in Task Builder. This parameter is only available and required when the Proxy parameter is set to SOCKS 5 or HTTP.

Microsoft Exchange parameters

The following properties are available when the mail server is set to Microsoft Exchange:

Property Description
Protocol Specifies the Exchange server protocol to use. The available options are:
  • EWS (Exchange 2007 & newer) - Uses the Exchange Web Services (EWS) protocol. Compatible with Microsoft Exchange Server 2007 and newer versions.
  • EWS Online - Uses the EWS protocol to access Microsoft Exchange Online by way of Modern Authentication.
  • WEBDAV (Exchange 2003, 2007) - Uses the Web Distributed Authoring and Provisioning (WEBDAV) protocol. Compatible with Microsoft Exchange Server 2003 and Exchange Server 2007.
If Protocol is set to EWS (Exchange 2007 & newer), refer to these parameters.
Email address A valid email address to use to authenticate with the Exchange server.
Password The password that corresponds with the Email address parameter to authenticate with the Exchange server.
HTTPS/HTTP Indicates whether to use HTTP (normal HTTP) or HTTPS (secure HTTP) as the Exchange server protocol type.
Exchange server Specifies the address of the Exchange server. Select Discover to automatically discover the server based on the information entered in the Email address and Password parameters.
Domain (optional) The domain name (for example, domain.exchangeServer.com) or IP address to use to connect to the Exchange server.
Version The Exchange server version. This parameter is active only if the Protocol parameter is set to EWS (Exchange 2007 SP1 and later). The available options are:
  • Exchange 2007 SP1
  • Exchange 2010
  • Exchange 2010 SP1
  • Exchange 2010 SP2
  • Exchange 2013
Ignore invalid server certificate If selected, invalid or expired SSL server certificates are ignored. If disabled (default) and an invalid server certificate is found, this step throws an error stating that the security certificate on the server is not valid.
If Protocol is set to EWS Online, refer to these parameters.
Email address A valid email address to use to authenticate the connection to the Exchange server.
Tenant ID The Directory (tenant) ID to use for authentication. This parameter is encrypted in Task Builder.
Client ID The Application (client) ID to use for authentication. This parameter is encrypted in Task Builder.
Client secret The client secret Value to use for authentication. This parameter is encrypted in Task Builder.
If Protocol is set to WEBDAV (Exchange 2003, 2007), refer to these parameters.
Email address A valid email address to use to authenticate with the Exchange server.
Password The password that corresponds with the Email address parameter to authenticate with the Exchange server.
HTTPS/HTTP Indicates whether to use HTTP (normal HTTP) or HTTPS (secure HTTP) as the Exchange server protocol type.
Exchange server Specifies the address of the Exchange server. Select Discover to automatically discover the server based on the information entered in the Email address and Password parameters.
Domain (optional) The domain name (for example, domain.exchangeServer.com) or IP address to use to connect to the Exchange server.
Authentication type The Exchange server authentication type. This parameter is active only if the Protocol parameter is set to WEBDAV (Exchange 2003, 2007)  The available options are:
  • Basic
  • Form
If using a proxy server, refer to these parameters.
Proxy Specifies the proxy type for use when attempting network communications through a proxy server. The available options are:
  • None - Select this option if a proxy server is not required.
  • SOCKS 4 - Communication is through a SOCKS 4-compliant server.
  • SOCKS 4A - Communication is through a SOCKS 4a -compliant server.
  • SOCKS 5 - Communication is through a SOCKS 5-compliant server.
  • HTTP - Communication is through an HTTP-compliant server.
NOTE: If you are unsure of the value to use in this parameter, contact your network administrator.
Proxy Server The hostname (server.domain.com) or IP address of the proxy server. This parameter is only available and required if the Proxy parameter is set to SOCKS 4, SOCKS 4A, SOCKS 5, or HTTP.
Proxy Port The proxy port number to use to connect to the proxy server. The default port is 0. Most proxy servers operate on port 1028, however, a proxy server can operate on other ports. This parameter is only available and required when the Proxy type parameter is set to SOCKS 4, SOCKS 4A, SOCKS 5, or HTTP.
Proxy Username The username to use to authenticate with the proxy server. This parameter is only available and required when the Proxy parameter is set to SOCKS 5 or HTTP.
Proxy Password The password corresponding with the Proxy Username parameter to use to authenticate with the proxy server. This parameter is encrypted in Task Builder. This parameter is only available and required when the Proxy parameter is set to SOCKS 5 or HTTP.