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

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать его в книге сценариев, укажите: community.vmware.vmware_vswitch.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

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

END_OF_DOCUMENT_MARKER

Параметры

Параметр	Комментарии
esxi_hostname псевдонимы: host строка	Управление vSwitch с использованием этой системы хоста ESXi.
hostname строка	Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задании, будет использовано значение переменной окружения `VMWARE_HOST`.
mtu целое число	MTU для настройки на vSwitch. По умолчанию: `1500`
nics псевдонимы: nic_name список / элементы=строка	Список имен vmnic или имя vmnic для подключения к vSwitch. По умолчанию: `[]`
number_of_ports целое число	Количество портов для настройки на vSwitch. По умолчанию: `128`
password псевдонимы: pass, pwd строка	Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задании, будет использовано значение переменной окружения `VMWARE_PASSWORD`.
port целое число	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задании, будет использовано значение переменной окружения `VMWARE_PORT`. По умолчанию: `443`
proxy_host строка	Адрес прокси-сервера, который будет принимать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задании, будет использовано значение переменной окружения `VMWARE_PROXY_HOST`.
proxy_port целое число	Порт HTTP-прокси, который будет принимать все запросы HTTPS и пересылать их. Если значение не указано в задании, будет использовано значение переменной окружения `VMWARE_PROXY_PORT`.
security псевдонимы: security_policy, network_policy словарь	Политика сети задает параметры безопасности уровня 2 для группы портов, такие как режим прослушивания, где гостевой адаптер прослушивает все пакеты, изменения MAC-адресов и поддельные передачи. Словарь, который настраивает различные значения безопасности для группы портов.
forged_transmits булево	Указывает, разрешены ли поддельные передачи. Варианты: `false` `true`
mac_changes булево	Указывает, разрешены ли изменения MAC-адресов. Варианты: `false` `true`
promiscuous_mode булево	Указывает, разрешен ли режим прослушивания. Варианты: `false` `true`
state строка	Добавить или удалить коммутатор. Варианты: `"absent"` `"present"` ← (по умолчанию)
switch псевдонимы: switch_name строка / обязательно	Имя vSwitch для добавления.
teaming псевдонимы: teaming_policy словарь	Словарь, который настраивает различные значения совместного использования для группы портов.
active_adapters список / элементы=строка	Список активных адаптеров, используемых для балансировки нагрузки. Все vmnics используются в качестве активных адаптеров, если `teaming.active_adapters` и `teaming.standby_adapters` не определены.

failback boolean	Укажите, использовать ли резервирование при восстановлении соединений. Варианты: `false` `true`
load_balancing псевдонимы: load_balance_policy string	Политика объединения сетевых адаптеров. Варианты: `"loadbalance_ip"` `"loadbalance_srcmac"` `"loadbalance_srcid"` `"failover_explicit"`
network_failure_detection string	Обнаружение неполадок сети. Варианты: `"link_status_only"` `"beacon_probing"`
notify_switches boolean	Укажите, уведомлять ли физический коммутатор о потере соединения. Варианты: `false` `true`
standby_adapters список / элементы=строка	Список резервных адаптеров, используемых для переключения. Все vmnics используются в качестве активных адаптеров, если `teaming.active_adapters` и `teaming.standby_adapters` не определены.
traffic_shaping словарь	Словарь для настройки ограничения трафика для коммутатора.
average_bandwidth целое число	Средняя пропускная способность (кбит/с).
burst_size целое число	Размер всплеска (КБ).
enabled boolean	Статус политики ограничения трафика. Варианты: `false` `true`
peak_bandwidth целое число	Пиковая пропускная способность (кбит/с).
username псевдонимы: admin, user string	Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_USER`.
validate_certs boolean	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false` когда сертификаты недостоверны. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Все модули требуют доступа к API для записи и, следовательно, не поддерживаются в бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.

Примеры

- 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/vmware/vmware_vswitch_module.html