Модуль community.vmware.vmware_vswitch — управление стандартным коммутатором VMware на хосте ESXi.

Примечание

Этот модуль входит в коллекцию community.vmware (версия 6.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать её в плейбуке, укажите: community.vmware.vmware_vswitch.

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль позволяет добавлять, удалять и обновлять стандартный коммутатор VMware на хосте ESXi.

Параметры

Параметр	Комментарии
esxi_hostname псевдонимы: host строка	Управление vSwitch с использованием этой системы хоста ESXi.
hostname строка	Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_HOST`.
mtu целое число	MTU для настройки на vSwitch. По умолчанию: `1500`
nics псевдонимы: nic_name список / элементы=строки	Список имён vmnic или имя vmnic для подключения к vSwitch. По умолчанию: `[]`
number_of_ports целое число	Количество портов для настройки на vSwitch. По умолчанию: `128`
password псевдонимы: pass, pwd строка	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PASSWORD`.
port целое число	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PORT`. По умолчанию: `443`
proxy_host строка	Адрес прокси-сервера, который будет принимать и перенаправлять все HTTPS-запросы. Формат: имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port целое число	Порт HTTP-прокси-сервера, который будет принимать и перенаправлять все HTTPS-запросы. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
security псевдонимы: security_policy, network_policy словарь	Сетевая политика задаёт параметры безопасности уровня 2 для группы портов, например режим promiscuous, в котором адаптер гостевой системы прослушивает все пакеты, изменения MAC-адреса и поддельные передачи. Словарь для настройки различных параметров безопасности группы портов.
forged_transmits логическое значение	Указывает, разрешены ли поддельные передачи. Варианты: `false` `true`
mac_changes логическое значение	Указывает, разрешены ли изменения MAC-адреса. Варианты: `false` `true`
promiscuous_mode логическое значение	Указывает, разрешён ли режим promiscuous. Варианты: `false` `true`
state строка	Добавить или удалить коммутатор. Варианты: `"absent"` `"present"` ← (по умолчанию)
switch псевдонимы: switch_name строка / обязательный	Имя vSwitch для добавления.
teaming псевдонимы: teaming_policy словарь	Словарь для настройки различных параметров объединения адаптеров в группу для группы портов.
active_adapters список / элементы=строки	Список активных адаптеров, используемых для балансировки нагрузки. Все vmnic используются как активные адаптеры, если `teaming.active_adapters` и `teaming.standby_adapters` не заданы.
failback логическое значение	Указывает, следует ли использовать возврат к исходному состоянию при восстановлении соединений. Варианты: `false` `true`
load_balancing псевдонимы: load_balance_policy строка	Политика объединения сетевых адаптеров в группу. Варианты: `"loadbalance_ip"` `"loadbalance_srcmac"` `"loadbalance_srcid"` `"failover_explicit"`
network_failure_detection строка	Обнаружение сетевых сбоев. Варианты: `"link_status_only"` `"beacon_probing"`
notify_switches логическое значение	Указывает, следует ли уведомлять физический коммутатор при сбое соединения. Варианты: `false` `true`
standby_adapters список / элементы=строки	Список резервных адаптеров, используемых при переключении на резерв. Все vmnic используются как активные адаптеры, если `teaming.active_adapters` и `teaming.standby_adapters` не заданы.
traffic_shaping словарь	Словарь для настройки управления трафиком на коммутаторе.
average_bandwidth целое число	Средняя пропускная способность (кбит/с).
burst_size целое число	Размер пакета всплеска (КБ).
enabled логическое значение	Состояние политики управления трафиком. Варианты: `false` `true`
peak_bandwidth целое число	Пиковая пропускная способность (кбит/с).
username псевдонимы: admin, user строка	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_USER`.
validate_certs логическое значение	Разрешает подключение при недействительных SSL-сертификатах. Установите значение `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Всем модулям требуется право на запись через API, поэтому они не поддерживаются бесплатной лицензией ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не применяет системное хранилище сертификатов. Указать хранилище сертификатов можно с помощью переменной среды REQUESTS_CA_BUNDLE. Обратите внимание: в некоторых случаях при установленной этой переменной значение ‘false’ для параметра ‘validate_certs’ может игнорироваться. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- name: Add a VMware vSwitch
  community.vmware.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
  community.vmware.vmware_vswitch:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    switch: vswitch_0001
    mtu: 9000
  delegate_to: localhost

- name: Add a VMware vSwitch with multiple NICs
  community.vmware.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
  community.vmware.vmware_vswitch:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    esxi_hostname: DC0_H0
    switch_name: vswitch_001
    nic_name: vmnic0
    mtu: 9000
  delegate_to: localhost

- name: Add a VMware vSwitch to a specific host system with Promiscuous Mode Enabled
  community.vmware.vmware_vswitch:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    esxi_hostname: DC0_H0
    switch_name: vswitch_001
    nic_name: vmnic0
    mtu: 9000
    security:
        promiscuous_mode: true
  delegate_to: localhost

- name: Add a VMware vSwitch to a specific host system with active/standby teaming
  community.vmware.vmware_vswitch:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    esxi_hostname: DC0_H0
    switch_name: vswitch_001
    nic_name:
      - vmnic0
      - vmnic1
    teaming:
      active_adapters:
        - vmnic0
      standby_adapters:
        - vmnic1
  delegate_to: localhost

- name: Add a VMware vSwitch to a specific host system with traffic shaping
  community.vmware.vmware_vswitch:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    esxi_hostname: DC0_H0
    switch_name: vswitch_001
    nic_name:
      - vmnic0
      - vmnic1
    traffic_shaping:
        enabled: true
        average_bandwidth: 100000
        peak_bandwidth: 100000
        burst_size: 102400
  delegate_to: localhost

- name: Delete a VMware vSwitch in a specific host system
  community.vmware.vmware_vswitch:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    esxi_hostname: DC0_H0
    switch_name: vswitch_001
    state: absent
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
result строка	информация о выполненной операции Возвращается: всегда Пример: `"vSwitch 'vSwitch_1002' is created successfully"`

Авторы

Joseph Callen (@jcpowermac)
Russell Teague (@mtnbikenc)
Abhijeet Kasurde (@Akasurde)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/vmware/vmware_vswitch_module.html