community.vmware.vmware_vmkernel 模块 – 管理 ESXi 主机的 VMware VMkernel 适配器。
注意
此模块是 community.vmware 集合 (版本 5.2.0) 的一部分。
如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install community.vmware。
要在剧本中使用它，请指定： community.vmware.vmware_vmkernel。
概要
此模块可用于管理 ESXi 主机的 VMkernel 适配器/VMkernel 网络接口。
对于 vSphere 标准交换机 (vSS)，该模块假定主机已配置端口组。
对于 vSphere 分布式交换机 (vDS)，该模块假定主机已配置分布式端口组。
如果存在，该模块会自动将 VMkernel 适配器从 vSS 迁移到 vDS，反之亦然。
参数
参数 |
注释 |
|---|---|
按设备名称搜索 VMkernel 适配器。 仅在 |
|
在 VMkernel 适配器上启用 vSphere Backup NFC 通信。 仅当使用默认 TCP/IP 堆栈时才允许此选项。 选项
|
|
在 VMkernel 适配器上启用容错通信。 仅当使用默认 TCP/IP 堆栈时才允许此选项。 选项
|
|
在 VMkernel 适配器上启用管理通信。 仅当使用默认 TCP/IP 堆栈时才允许此选项。 选项
|
|
在 VMkernel 适配器上启用预配通信。 仅当使用默认 TCP/IP 堆栈时才允许此选项。 选项
|
|
在 VMkernel 适配器上启用 vSphere Replication 通信。 仅当使用默认 TCP/IP 堆栈时才允许此选项。 选项
|
|
在 VMkernel 适配器上启用 vSphere Replication NFC 通信。 仅当使用默认 TCP/IP 堆栈时才允许此选项。 选项
|
|
在 VMkernel 适配器上启用 vMotion 通信。 仅当使用默认 TCP/IP 堆栈时才允许此选项。 如果您已配置具有 vMotion TCP/IP 堆栈的适配器，则不能在附加适配器上启用 vMotion。 选项
|
|
在 VMkernel 适配器上启用 VSAN 通信。 仅当使用默认 TCP/IP 堆栈时才允许此选项。 选项
|
|
要管理 VMkernel 的 ESXi 主机的名称。 |
|
vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。 如果任务中未指定此值，则将改用环境变量 |
|
VMkernel 接口的 MTU。 从 2.5 版开始，默认值 1500 有效。 默认值： |
|
网络详细信息的字典。 默认值： |
|
默认网关（覆盖此适配器的默认网关）。 |
|
静态 IP 地址。 如果 |
|
必需的静态子网掩码。 如果 |
|
VMkernel 接口的 TCP/IP 堆栈。 选项
|
|
IP 分配类型。 选项
|
|
vSphere vCenter 或 ESXi 服务器的密码。 如果任务中未指定此值，则将改用环境变量 |
|
VMKernel 接口的端口组名称。 |
|
接收所有 HTTPS 请求并转发它们的 HTTP 代理服务器端口。 如果任务中未指定此值，则将使用环境变量 |
|
如果设置为 如果设置为 如果设置为 选项
|
|
vSphere vCenter 或 ESXi 服务器的用户名。 如果任务中未指定此值，则将使用环境变量 |
|
允许在 SSL 证书无效时连接。当证书不受信任时，设置为 如果任务中未指定此值，则将使用环境变量 选项
|
|
注释
示例
- name: Add Management vmkernel port using static network type
community.vmware.vmware_vmkernel:
hostname: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
esxi_hostname: '{{ esxi_hostname }}'
vswitch_name: vSwitch0
portgroup_name: PG_0001
network:
type: 'static'
ip_address: 192.168.127.10
subnet_mask: 255.255.255.0
state: present
enable_mgmt: true
delegate_to: localhost
- name: Add Management vmkernel port using DHCP network type
community.vmware.vmware_vmkernel:
hostname: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
esxi_hostname: '{{ esxi_hostname }}'
vswitch_name: vSwitch0
portgroup_name: PG_0002
state: present
network:
type: 'dhcp'
enable_mgmt: true
delegate_to: localhost
- name: Change IP allocation from static to dhcp
community.vmware.vmware_vmkernel:
hostname: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
esxi_hostname: '{{ esxi_hostname }}'
vswitch_name: vSwitch0
portgroup_name: PG_0002
state: present
device: vmk1
network:
type: 'dhcp'
enable_mgmt: true
delegate_to: localhost
- name: Delete VMkernel port
community.vmware.vmware_vmkernel:
hostname: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
esxi_hostname: '{{ esxi_hostname }}'
vswitch_name: vSwitch0
portgroup_name: PG_0002
state: absent
delegate_to: localhost
- name: Add Management vmkernel port to Distributed Switch
community.vmware.vmware_vmkernel:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
dvswitch_name: dvSwitch1
portgroup_name: dvPG_0001
network:
type: 'static'
ip_address: 192.168.127.10
subnet_mask: 255.255.255.0
state: present
enable_mgmt: true
delegate_to: localhost
- name: Add vMotion vmkernel port with vMotion TCP/IP stack
community.vmware.vmware_vmkernel:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
dvswitch_name: dvSwitch1
portgroup_name: dvPG_0001
network:
type: 'static'
ip_address: 192.168.127.10
subnet_mask: 255.255.255.0
tcpip_stack: vmotion
state: present
delegate_to: localhost
返回值
常见的返回值已在 此处 记录，以下是此模块特有的字段
键 |
描述 |
|---|---|
关于 VMKernel 名称的元数据 返回：始终返回 示例： |