vmware_vswitch - Add or remove a VMware Standard Switch to an ESXi host  New in version 2.0.   
Synopsis Requirements   Parameters Notes Examples 
Status Author    Synopsis  Add or remove a VMware Standard Switch to an ESXi host.  Requirements The below requirements are needed on the host that executes this module.  python >= 2.6 PyVmomi  Parameters   Parameter Choices/Defaults Comments    esxi_hostname (added in 2.5)     Manage the vSwitch using this ESXi host system 
aliases: host     hostname     The hostname or IP address of the vSphere vCenter or ESXi server. If the value is not specified in the task, the value of environment variable VMWARE_HOST will be used instead. Environment variable supported added in version 2.6.     mtu   Default:1500   MTU to configure on vSwitch.     nics     A list of vmnic names or vmnic name to attach to vSwitch. Alias nics is added in version 2.4. 
aliases: nic_name     number_of_ports   Default:128   Number of port to configure on vSwitch.     password     The password of the vSphere vCenter or ESXi server. If the value is not specified in the task, the value of environment variable VMWARE_PASSWORD will be used instead. Environment variable supported added in version 2.6. 
aliases: pass, pwd     port (added in 2.5)   Default:443   The port number of the vSphere vCenter or ESXi server. If the value is not specified in the task, the value of environment variable VMWARE_PORT will be used instead. Environment variable supported added in version 2.6.     state   
Choices: absent 
present ←    Add or remove the switch.     switch required     vSwitch name to add. Alias switch is added in version 2.4. 
aliases: switch_name     username     The username of the vSphere vCenter or ESXi server. If the value is not specified in the task, the value of environment variable VMWARE_USER will be used instead. Environment variable supported added in version 2.6. 
aliases: user, admin     validate_certs   
Choices: no yes  Default:True   Allows connection when SSL certificates are not valid. Set to false when certificates are not trusted. If the value is not specified in the task, the value of environment variable VMWARE_VALIDATE_CERTS will be used instead. Environment variable supported added in version 2.6.     Notes  Note  Tested on vSphere 5.5   Examples - name: Add a VMware vSwitch
  action:
    module: vmware_vswitch
    hostname: esxi_hostname
    username: esxi_username
    password: esxi_password
    switch: vswitch_name
    nics: vmnic_name
    mtu: 9000
  delegate_to: localhost

- name: Add a VMWare vSwitch without any physical NIC attached
  vmware_vswitch:
    hostname: 523-790-3189
    username: admin
    password: password123
    switch: vswitch_0001
    mtu: 9000
  delegate_to: localhost

- name: Add a VMWare vSwitch with multiple NICs
  vmware_vswitch:
    hostname: esxi_hostname
    username: esxi_username
    password: esxi_password
    switch: vmware_vswitch_0004
    nics:
    - vmnic1
    - vmnic2
    mtu: 9000
  delegate_to: localhost

- name: Add a VMware vSwitch to a specific host system
  vmware_vswitch:
    hostname: 523-790-3189
    username: esxi_username
    password: esxi_password
    esxi_hostname: DC0_H0
    switch_name: vswitch_001
    nic_name: vmnic0
    mtu: 9000
  delegate_to: localhost
 Status This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface. Author  Joseph Callen (@jcpowermac) Russell Teague (@mtnbikenc)   Hint If you notice any issues in this documentation you can edit this document to improve it. 

    © 2012–2018 Michael DeHaan
{'path': 'public/docs/ansible~2.5/modules/vmware_vswitch_module.html', 'source': 'DevDocs.IO'}