chemailserver

Use the chemailserver command to modify the parameters of an existing email server object.

Syntax

Read syntax diagramSkip visual syntax diagram chemailserver -nameserver_name -ipip_address_or_domain_name-portport-usernameusers_username-passwordusers_password-secureyesnotry-nocredentialsemail_server_nameemail_server_id

Parameters

-name server_name
(Optional) Specifies a unique name to assign to the email server object. The name must be a 1- through 63-character string, and cannot start with a hyphen or number. When specifying a server name, emailserver is a reserved word.
-ip ip_address_or_domain_name
(Optional) Specifies the IP address or domain name of a remote. The IP address must be a valid IPv4 or IPv6 address or a fully qualified domain name. IPv6 addresses can be zero compressed. If you specify a fully qualified domain name, a DNS server must be configured on your system. You can use the mkdnsserver command to configure DNS servers.
-port port
(Optional) Specifies the port number for the email server. This must be a value of 0 - 65535. The default value is 25.
-username users_username
(Optional) Specify the username for authenticating to the email server. The maximum number of characters for the username is 64.
-password users_password
(Optional) Specify the password for authenticating to the email server. The maximum number of characters for the password is 64.
Note: If the username and password are not already set, you must specify both values in the command.
-secure yes|no|try
(Optional) Specify whether to establish a TLS connection to the email server. The following options are available:
  • try - if the email server does not support TLS connection, then continue and send the email insecurely.
  • yes - if the email server does not support TLS, stop the connection. Emails fail to send.
  • no - do not attempt to establish a TLS connection to the email server. Emails are sent insecurely.
-nocredentials
(Optional) Removes the credentials that are used for authenticating to the email server .
email_server_name | email_server_id
(Required) Specifies the name or ID of the server object to be modified.

Description

Use this command to change the settings of an existing email server object. The email server object describes a remote Simple Mail Transfer Protocol (SMTP) email server.

You must specify either the current name or the ID of the object returned at creation time. Use the lsemailserver command to obtain this ID.

An invocation example

chemailserver -name newserver 0

The resulting output:

No feedback.