check_point.mgmt.cp_mgmt_smtp_server 模块 – 通过 Web 服务 API 管理 Checkpoint 上的 smtp-server 对象
注意
此模块是 check_point.mgmt 集合 (版本 6.2.1) 的一部分。
如果您使用的是 ansible
包,则可能已安装此集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用: ansible-galaxy collection install check_point.mgmt
。
要在 playbook 中使用它,请指定: check_point.mgmt.cp_mgmt_smtp_server
。
check_point.mgmt 3.0.0 中的新增功能
概要
管理 Checkpoint 设备上的 smtp-server 对象,包括创建、更新和删除对象。
所有操作均通过 Web 服务 API 执行。
参数
参数 |
注释 |
---|---|
邮件服务器是否需要身份验证。 选项
|
|
如果任务完成后进行了更改,则发布当前会话。 选项
|
|
对象的颜色。应该是现有颜色之一。 选项
|
|
注释字符串。 |
|
响应中某些字段的详细程度可以从仅显示对象的 UID 值到对象的完整详细表示形式。 选项
|
|
指示在哪些域上处理命令。它不能与 details-level full 一起使用,必须仅从系统域运行并且 ignore-warnings 为 true。有效值为 CURRENT_DOMAIN、ALL_DOMAINS_ON_THIS_SERVER。 |
|
加密类型。 选项
|
|
忽略错误应用更改。您将无法发布此类更改。如果忽略 ignore-warnings 标志,则警告也将被忽略。 选项
|
|
忽略警告应用更改。 选项
|
|
对象名称。 |
|
SMTP 服务器的密码。 |
|
要使用的 SMTP 端口。 |
|
SMTP 服务器地址。 |
|
访问规则的状态(存在或不存在)。 选项
|
|
标签标识符集合。 |
|
SMTP 服务器的用户名。 |
|
Checkpoint 的版本。如果未给出版本,则采用最新版本。 |
|
等待任务结束。例如发布任务。 选项
|
|
在抛出超时错误之前等待多少分钟。 默认: |
示例
- name: add-smtp-server
cp_mgmt_smtp_server:
encryption: none
name: SMTP1
port: '25'
server: smtp.example.com
state: present
- name: set-smtp-server
cp_mgmt_smtp_server:
name: SMTP
port: '25'
server: smtp.example.com
state: present
- name: delete-smtp-server
cp_mgmt_smtp_server:
name: SMTP
state: absent
返回值
常见的返回值已在 此处 记录,以下是此模块独有的字段
键 |
描述 |
---|---|
创建或更新的 Checkpoint 对象。 返回: 始终返回,除非删除对象。 |