community.vmware.vmware_host_firewall_manager 模块 – 管理 ESXi 主机的防火墙配置
注意
此模块是 community.vmware 集合 (版本 5.2.0) 的一部分。
如果您使用的是 ansible
包,则可能已经安装了此集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install community.vmware
。
要在 playbook 中使用它,请指定:community.vmware.vmware_host_firewall_manager
。
概要
此模块可用于管理 ESXi 主机的防火墙配置,前提是已提供 ESXi 主机名或集群名称。
参数
参数 |
注释 |
---|---|
vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。 如果任务中未指定此值,则将改用环境变量 |
|
vSphere vCenter 或 ESXi 服务器的密码。 如果任务中未指定此值,则将改用环境变量 |
|
将接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。 如果任务中未指定此值,则将改用环境变量 |
|
需要管理的规则集列表。 列表的每个成员都是规则集名称以及要设置规则的状态。 规则名称和规则状态都是必需的参数。 还可以指定其他 IP 和网络 请参阅示例以获取更多信息。 默认值: |
|
定义此规则集允许的主机。 |
|
是否应允许所有主机。 选项
|
|
允许的 IP 地址列表。 默认值: |
|
允许的 IP 网络列表。 默认值: |
|
规则集是否启用。 选项
|
|
规则集名称。 |
|
vSphere vCenter 或 ESXi 服务器的用户名。 如果任务中未指定此值,则将改用环境变量 |
|
允许在 SSL 证书无效时连接。当证书不受信任时,将其设置为 如果任务中未指定此值,则将改用环境变量 选项
|
备注
注意
所有模块都需要API写入权限,因此不受免费ESXi许可证支持。
所有变量和VMware对象名称都区分大小写。
示例
- name: Enable vvold rule set for all ESXi Host in given Cluster
community.vmware.vmware_host_firewall_manager:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
cluster_name: cluster_name
rules:
- name: vvold
enabled: true
allowed_hosts:
all_ip: true
delegate_to: localhost
- name: Enable vvold rule set for an ESXi Host
community.vmware.vmware_host_firewall_manager:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
rules:
- name: vvold
enabled: true
allowed_hosts:
all_ip: true
delegate_to: localhost
- name: Manage multiple rule set for an ESXi Host
community.vmware.vmware_host_firewall_manager:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
rules:
- name: vvold
enabled: true
allowed_hosts:
all_ip: true
- name: CIMHttpServer
enabled: false
delegate_to: localhost
- name: Manage IP and network based firewall permissions for ESXi
community.vmware.vmware_host_firewall_manager:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
rules:
- name: gdbserver
enabled: true
allowed_hosts:
all_ip: false
ip_address:
- 192.168.20.10
- 192.168.20.11
- name: CIMHttpServer
enabled: true
allowed_hosts:
all_ip: false
ip_network:
- 192.168.100.0/24
- name: remoteSerialPort
enabled: true
allowed_hosts:
all_ip: false
ip_address:
- 192.168.100.11
ip_network:
- 192.168.200.0/24
delegate_to: localhost
返回值
常见的返回值已在此处记录,以下是此模块特有的字段
键 |
描述 |
---|---|
字典,主机名作为键,防火墙规则集事实作为值的字典 返回:成功 示例: |