W3cubDocs

/Ansible

vmware_migrate_vmk - Migrate a VMK interface from VSS to VDS

New in version 2.0.

Synopsis

  • Migrate a VMK interface from VSS to VDS

Requirements (on host that executes module)

  • python >= 2.6
  • PyVmomi

Options

parameter required default choices comments
current_portgroup_name
yes
Portgroup name VMK interface is currently on
current_switch_name
yes
Switch VMK interface is currently on
device
yes
VMK interface name
esxi_hostname
yes
ESXi hostname to be managed
hostname
yes
The hostname or IP address of the vSphere vCenter.
migrate_portgroup_name
yes
Portgroup name to migrate VMK interface to
migrate_switch_name
yes
Switch name to migrate VMK interface to
password
yes
The password of the vSphere vCenter.
aliases: pass, pwd
username
yes
The username of the vSphere vCenter.
aliases: user, admin
validate_certs
no True
  • True
  • False
Allows connection when SSL certificates are not valid. Set to false when certificates are not trusted.

Examples

# Example from Ansible playbook

    - name: Migrate Management vmk
      local_action:
        module: vmware_migrate_vmk
        hostname: vcsa_host
        username: vcsa_user
        password: vcsa_pass
        esxi_hostname: esxi_hostname
        device: vmk1
        current_switch_name: temp_vswitch
        current_portgroup_name: esx-mgmt
        migrate_switch_name: dvSwitch
        migrate_portgroup_name: Management

Notes

Note

  • Tested on vSphere 5.5

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.

© 2012–2017 Michael DeHaan
© 2017 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/vmware_migrate_vmk_module.html