community.vmware.vmware_host_vmnic_facts – Gathers facts 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_facts
.
DEPRECATED¶
- Removed in
major release after 2021-12-01
- Why
Deprecated in favour of community.vmware.vmware_host_vmnic_info module.
- Alternative
Use community.vmware.vmware_host_vmnic_info instead.
Synopsis¶
This module can be used to gather facts about vmnics available on the given ESXi host.
If
cluster_name
is provided, then vmnic facts about all hosts from given cluster will be returned.If
esxi_hostname
is provided, then vmnic facts 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 facts about vmnics of all ESXi Host in the given Cluster
community.vmware.vmware_host_vmnic_facts:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
cluster_name: '{{ cluster_name }}'
delegate_to: localhost
register: cluster_host_vmnics
- name: Gather facts about vmnics of an ESXi Host
community.vmware.vmware_host_vmnic_facts:
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:
Status¶
This module will be removed in a major release after 2021-12-01. [deprecated]
For more information see DEPRECATED.
Authors¶
Abhijeet Kasurde (@Akasurde)
Christian Kotte (@ckotte)