check_point.mgmt.cp_mgmt_install_policy 模块 – 通过 Web Services API 在 Check Point 上安装策略

注意

此模块是 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_install_policy。

check_point.mgmt 1.0.0 中的新增功能

概要

  • 通过 Web Services API 在 Check Point 上安装策略

  • 所有操作均通过 Web Services API 执行。

参数

参数

注释

access

布尔值

设置为 true 以安装访问控制策略。默认情况下，如果输入策略包上启用了访问控制策略，则该值为 true，否则为 false。

选择

  • false

  • true

auto_publish_session

布尔值

如果任务完成后执行了更改，则发布当前会话。

选择

  • false ← (默认)

  • true

desktop_security

布尔值

设置为 true 以安装桌面安全策略。默认情况下，如果输入策略包上启用了桌面安全策略，则该值为 true，否则为 false。

选择

  • false

  • true

install_on_all_cluster_members_or_fail

布尔值

与网关集群相关。如果为 true，则策略将安装在所有集群成员上。如果集群成员上的安装失败，则不要在该集群上安装。

选择

  • false

  • true

policy_package

字符串

要安装的策略包的名称。

prepare_only

布尔值

如果为 true，则准备安装策略，但不将其安装在安装目标上。

选择

  • false

  • true

qos

布尔值

设置为 true 以安装 QoS 策略。默认情况下，如果输入策略包上启用了服务质量策略，则该值为 true，否则为 false。

选择

  • false

  • true

revision

字符串

要安装的策略修订版本的 UID。

targets

列表 / 元素=字符串

在此命令上执行的目标。可以通过名称或对象唯一标识符来标识目标。

threat_prevention

布尔值

设置为 true 以安装威胁防御策略。默认情况下，如果输入策略包上启用了威胁防御策略，则该值为 true，否则为 false。

选择

  • false

  • true

version

字符串

Check Point 的版本。如果未给出，则采用最新版本。

wait_for_task

布尔值

等待任务结束。例如发布任务。

选择

  • false

  • true ← (默认)

wait_for_task_timeout

整数

等待多少分钟直到抛出超时错误。

默认: 30

示例

- name: install-policy
  cp_mgmt_install_policy:
    access: true
    policy_package: standard
    targets:
    - corporate-gateway
    threat_prevention: true

返回值

常见的返回值记录在此处，以下是此模块独有的字段

键

描述

cp_mgmt_install_policy

字典

Check Point install-policy 的输出。

返回: 总是。

作者

  • Or Soffer (@chkp-orso)