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。
要在 Playbook 中使用它，请指定：community.vmware.vmware_vmkernel。
概要
此模块可用于管理 ESXi 主机的 VMKernel 适配器/VMKernel 网络接口。
该模块假定在 vSphere 标准交换机 (vSS) 的情况下，主机已配置了端口组。
该模块假定在 vSphere 分布式交换机 (vDS) 的情况下，主机已配置了分布式端口组。
如果存在，该模块会自动将 VMKernel 适配器从 vSS 迁移到 vDS，反之亦然。
参数
参数 |
注释 |
|---|---|
按设备名称搜索 VMkernel 适配器。 仅当 |
|
在 VMKernel 适配器上启用 vSphere 备份 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 名称的元数据 返回值: 始终 示例: |