community.vmware.vmware_host_vmnic_info – Gathers info about vmnics available on the given ESXi host¶
Note
This plugin is part of the community.vmware collection (version 1.9.0).
To install it use: ansible-galaxy collection install community.vmware
.
To use it in a playbook, specify: community.vmware.vmware_host_vmnic_info
.
Synopsis¶
This module can be used to gather information about vmnics available on the given ESXi host.
If
cluster_name
is provided, then vmnic information about all hosts from given cluster will be returned.If
esxi_hostname
is provided, then vmnic information about given host system will be returned.Additional details about vswitch and dvswitch with respective vmnic is also provided which is added in 2.7 version.
Requirements¶
The below requirements are needed on the host that executes this module.
python >= 2.6
PyVmomi
Parameters¶
Examples¶
- 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
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Authors¶
Abhijeet Kasurde (@Akasurde)
Christian Kotte (@ckotte)