community.vmware.vmware_host_vmnic_info 模块 – 收集给定 ESXi 主机上可用的 vmnic 信息

注意

此模块是 community.vmware 集合(版本 5.2.0)的一部分。

如果您使用的是 ansible 包,则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install community.vmware

要在 playbook 中使用它,请指定:community.vmware.vmware_host_vmnic_info

概要

  • 此模块可用于收集有关给定 ESXi 主机上可用 vmnic 的信息。

  • 如果提供了 cluster_name,则将返回给定集群中所有主机的 vmnic 信息。

  • 如果提供了 esxi_hostname,则将返回给定主机系统的 vmnic 信息。

参数

参数

注释

capabilities

布尔值

收集有关常规功能(自动协商、网络唤醒和网络 I/O 控制)的信息。

选项

  • false ←(默认)

  • true

cluster_name

字符串

将从中使用所有主机系统的集群的名称。

将返回给定集群中每个 ESXi 服务器的 Vmnic 信息。

如果未指定 esxi_hostname,则此参数是必需的。

directpath_io

布尔值

收集有关 DirectPath I/O 功能和配置的信息。

选项

  • false ←(默认)

  • true

esxi_hostname

字符串

要使用的主机系统的名称。

将返回此 ESXi 服务器的 Vmnic 信息。

如果未指定 cluster_name,则此参数是必需的。

hostname

字符串

vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。

如果未在任务中指定该值,则将改为使用环境变量 VMWARE_HOST 的值。

password

别名:pass、pwd

字符串

vSphere vCenter 或 ESXi 服务器的密码。

如果未在任务中指定该值,则将改为使用环境变量 VMWARE_PASSWORD 的值。

port

整数

vSphere vCenter 或 ESXi 服务器的端口号。

如果未在任务中指定该值,则将改为使用环境变量 VMWARE_PORT 的值。

默认值: 443

proxy_host

字符串

将接收所有 HTTPS 请求并转发它们的代理的地址。

格式是主机名或 IP。

如果未在任务中指定该值,则将改为使用环境变量 VMWARE_PROXY_HOST 的值。

proxy_port

整数

将接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。

如果未在任务中指定该值,则将改为使用环境变量 VMWARE_PROXY_PORT 的值。

sriov

布尔值

收集有关 SR-IOV 功能和配置的信息。

选项

  • false ←(默认)

  • true

用户名

别名: admin, user

字符串

vSphere vCenter 或 ESXi 服务器的用户名。

如果任务中未指定该值,则将使用环境变量 VMWARE_USER 的值。

validate_certs

布尔值

当 SSL 证书无效时允许连接。当证书不受信任时,设置为 false

如果任务中未指定该值,则将使用环境变量 VMWARE_VALIDATE_CERTS 的值。

选项

  • false

  • true ← (默认)

注意事项

注意

  • 所有模块都需要 API 写入权限,因此不支持免费的 ESXi 许可证。

  • 所有变量和 VMware 对象名称都区分大小写。

示例

- name: Gather info about vmnics of all ESXi Host in the given Cluster
  community.vmware.vmware_host_vmnic_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    cluster_name: '{{ cluster_name }}'
  delegate_to: localhost
  register: cluster_host_vmnics

- name: Gather info about vmnics of an ESXi Host
  community.vmware.vmware_host_vmnic_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
  delegate_to: localhost
  register: host_vmnics

返回值

常见的返回值在此处记录: 这里,以下是此模块特有的字段

描述

hosts_vmnics_info

字典

以主机名为键,以 vmnic 信息为值的字典。

对于 num_vmnics,只计算以 vmnic 开头的网卡。像 vusb* 这样的网卡不计数。

返回: hosts_vmnics_info

示例: {"10.76.33.204": {"all": ["vmnic0", "vmnic1"], "available": [], "dvswitch": {"dvs_0002": ["vmnic1"]}, "num_vmnics": 2, "used": ["vmnic1", "vmnic0"], "vmnic_details": [{"actual_duplex": "Full Duplex", "actual_speed": 10000, "adapter": "Intel(R) 82599 10 Gigabit Dual Port Network Connection", "configured_duplex": "Auto negotiate", "configured_speed": "Auto negotiate", "device": "vmnic0", "driver": "ixgbe", "lldp_info": {"Aggregated Port ID": "0", "Aggregation Status": "1", "Enabled Capabilities": {"_vimtype": "vim.host.PhysicalNic.CdpDeviceCapability", "host": false, "igmpEnabled": false, "networkSwitch": false, "repeater": false, "router": true, "sourceRouteBridge": false, "transparentBridge": true}, "MTU": "9216", "Port Description": "switch port description", "Samples": 18814, "System Description": "omitted from output", "System Name": "sw1", "TimeOut": 30, "Vlan ID": "1"}, "location": "0000:01:00.0", "mac": "aa:bb:cc:dd:ee:ff", "status": "Connected"}, {"actual_duplex": "Full Duplex", "actual_speed": 10000, "adapter": "Intel(R) 82599 10 Gigabit Dual Port Network Connection", "configured_duplex": "Auto negotiate", "configured_speed": "Auto negotiate", "device": "vmnic1", "driver": "ixgbe", "lldp_info": "N/A", "location": "0000:01:00.1", "mac": "ab:ba:cc:dd:ee:ff", "status": "Connected"}], "vswitch": {"vSwitch0": ["vmnic0"]}}}

作者

  • Abhijeet Kasurde (@Akasurde)

  • Christian Kotte (@ckotte)