saltext.vmware.modules.dvswitch#

saltext.vmware.modules.dvswitch.configure(datacenter_name, switch_name, uplink_count=None, uplink_prefix='Uplink ', switch_version=None, switch_description=None, mtu=None, discovery_protocol=None, discovery_operation=None, multicast_filtering_mode=None, contact_name=None, contact_description=None, network_forged_transmits=None, network_mac_changes=None, network_promiscuous=None, health_check_teaming_failover=None, health_teaming_failover_interval=None, health_vlan_mtu=None, health_vlan_mtu_interval=None, service_instance=None)[source]#

Creates a new distributed vSwitch or updates an existing vSwitch.

switch_name

Name of the distributed vSwitch to create or update.

uplink_count

Count of uplink per ESXi per host. Optional.

uplink_prefix

The prefix to be used for uplinks. Optional. Default: “Uplink “.

switch_version

The version of the distributed vSwitch to create or update. Optional.

switch_description

Description of the distributed vSwitch. Optional. Default: None.

mtu

Maximum transmission unit for the switch. Optional.

discovery_protocol

Link discovery protocol between Cisco and Link Layer discovery. Optional. Valid values: “cdp”, “lldp”, “disabled”.

discovery_operation

Discovery operation for the switch. Optional. Valid values: “both”, “advertise”, “listen”.

multicast_filtering_mode

Multicast filtering mode for the switch. Optional. Valid values: “basic”, “snooping”.

contact_name

Administrator contact name. Optional. Default: “”.

contact_description

Administrator contact information. Optional. Default: “”.

network_forged_transmits

Allow forged transmits. Type: Boolean. Optional. Valid values: “True”, “False”.

network_mac_changes

Allow mac changes. Type: Boolean. Optional. Valid values: “True”, “False”.

network_promiscuous

Allow promiscuous mode. Type: Boolean. Optional. Valid values: “True”, “False”.

health_check_teaming_failover

Enable teaming and failover health check. Type: Boolean. Optional. Valid values: “True”, “False”.

health_teaming_failover_interval

Teaming and failover health check interval in minutes. Optional.

health_vlan_mtu

Enable VLAN and MTU health check. Type: Boolean. Optional. Valid values: “True”, “False”.

health_vlan_mtu_interval

VLAN and MTU health check interval in minutes. Optional.

service_instance

Use this vCenter service connection instance instead of creating a new one. Optional.

salt '*' vmware_dvswitch.configure dvs1
saltext.vmware.modules.dvswitch.remove_hosts(switch_name, host_name=None, datacenter_name=None, cluster_name=None, service_instance=None)[source]#

Remove ESXi host(s) from a distributed vSwitch.

switch_name

Name of the distributed vSwitch.

datacenter_name

Filter by this datacenter name (required when cluster is specified)

cluster_name

Filter by this cluster name (optional)

host_name

Filter by this ESXi hostname (optional)

service_instance

Use this vCenter service connection instance instead of creating a new one. (optional).

salt '*' vmware_dvswitch.remove_hosts switch_name=dvs1 hostname=host1
saltext.vmware.modules.dvswitch.add_hosts(switch_name, host_name=None, datacenter_name=None, cluster_name=None, nics=None, service_instance=None)[source]#

Add ESXi host(s) to a distributed vSwitch.

switch_name

Name of the distributed vSwitch.

datacenter_name

Filter by this datacenter name (required when cluster is specified)

cluster_name

Filter by this cluster name (optional)

host_name

Filter by this ESXi hostname (optional)

nics

List of vmnics to attach to vSwitch. (optional). Default “None”.

service_instance

Use this vCenter service connection instance instead of creating a new one. (optional).

salt '*' vmware_dvswitch.add_hosts switch_name=dvs1 host_name=host1 num_ports=256 mtu=1800
saltext.vmware.modules.dvswitch.update_hosts(switch_name, host_name=None, datacenter_name=None, cluster_name=None, nics=None, num_ports=None, mtu=None, service_instance=None)[source]#

Update ESXi host(s) on a distributed vSwitch.

switch_name

Name of the distributed vSwitch.

datacenter_name

Filter by this datacenter name (required when cluster is specified)

cluster_name

Filter by this cluster name (optional)

host_name

Filter by this ESXi hostname (optional)

nics

List of vmnics to attach to vSwitch. (optional). Default “None”.

num_ports

Number of ports to configure on the vSwitch. (optional). Default 128.

mtu

MTU to configure on the vSwitch. (optional). Default 1600.

service_instance

Use this vCenter service connection instance instead of creating a new one. (optional).

salt '*' vmware_dvswitch.update_hosts switch_name=dvs1 host_name=host1 num_ports=256 mtu=1800