NOTIFY 命令

发送电子邮件通知消息。

语法

NOTIFY USER 用户名 <PASSWORD 密码> MAILBOX 路径名 ADDRESS 收件人 <CC 抄送收件人> <BCC 密件抄送收件人> <SUBJECT 主题> MESSAGE 消息 <ATTACHMENT 路径名>

参数

名称	描述
USER 路径名	发件人的电子邮件地址。
PASSWORD 密码可选	邮件服务器的密码。
MAILBOX 路径名	要用来发送电子邮件消息的 SMTP 服务器名称。例如： MAILBOX "mailserver.example.com"
ADDRESS 收件人	一个或多个收件人的电子邮件地址。请用逗号分隔多个电子邮件地址。最多输入 1020 个字符。
CC 抄送收件人可选	一个或多个抄送收件人的电子邮件地址。请用逗号分隔多个电子邮件地址。最多输入 1000 个字符。
BCC 密件抄送收件人可选	一个或多个密件抄送收件人的电子邮件地址。请用逗号分隔多个电子邮件地址。
SUBJECT 主题可选	电子邮件的主题行。
MESSAGE 消息	电子邮件的正文。电子邮件是纯文本且不支持 HTML。如果您想要在您的消息中插入一个换行符，请使用两个 ^ 字符：^^。
ATTACHMENT 路径名可选	一个或多个附件的路径和文件名。必须是带引号的字符串。通过为路径名输入一个逗号分隔文件列表来指定多个附件： ATTACHMENT "result1,result2"

示例

发送错误报告电子邮件

您正在运行脚本，如果脚本失败，则您想要发送通知电子邮件。使用 NOTIFY，您定义了电子邮件并包括两个附件：

日志文件
一个包含所记录错误的 .fil 文件

NOTIFY USER "support@company.com" MAILBOX "mail.company.com" ADDRESS "script_admin@example.com" SUBJECT "错误报告" MESSAGE "无法处理脚本。 详情见附件。" ATTACHMENT "Errors.fil,ACL_Demo.log"

备注

收件人和附件

您可以使用 NOTIFY 命令向一个或多个收件人发送电子邮件通知消息。消息可以包括附加的数据文件和 Analytics 项目。

NOTIFY 命令可用来在脚本意外出错时通知相关人员。

协议和端口

此命令可与支持 SMTP（简单邮件传送协议，Microsoft Exchange 及其他众多邮件服务器使用此协议）的任何邮件服务器一起使用。 NOTIFY 命令还可与 Microsoft 及其他公司提供的在本地发送邮件的旧电子邮件应用程序一起使用。

NOTIFY 使用端口 25，因此该端口必须在邮件服务器上处于打开状态，否则该命令会失败。该命令所使用的端口号不可配置。如果 NOTIFY 失败并显示错误消息，请联系您的 IT 部门，以查明端口 25 是否被在您的网络上阻止。

错误处理

如果 Analytics 无法与邮件服务器连接，则它会另外进行五次连接尝试，并在每次尝试之后暂停 10秒钟。如果所有连接尝试均不成功，则 NOTIFY 命令被取消，向日志写入一条消息，但脚本会继续执行处理。

您可以使用 SET 命令更改此默认行为。您可以指定不同数量的连接尝试和不同的尝试间隔时间，或者您可以禁用附加连接尝试。您还可以指定 Analytics 在 NOTIFY 命令被取消后停止处理脚本。有关详细信息，请参见SET 命令。

无效的电子邮件收件人不被视为 NOTIFY 命令失效，并且无论相关联的设置如何，都不会导致脚本停止。