vmware_vswitch – Управление стандартным коммутатором VMware на хосте ESXi.
Новая версия с 2.0.
Обзор
- Этот модуль можно использовать для добавления, удаления и обновления стандартного коммутатора VMware на хосте ESXi.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| esxi_hostname - добавлен в 2.5 | Управление коммутатором vSwitch с помощью этого хоста ESXi. псевдонимы: хост | |
| hostname строка | Имя хоста или IP-адрес сервера vCenter или ESXi сервера vSphere. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_HOST. Поддержка переменных среды добавлена в версии 2.6. | |
| mtu - | По умолчанию: 1500 | MTU для настройки на коммутаторе vSwitch. |
| nics - | По умолчанию: [] | Список имен vmnic или имени vmnic для подключения к коммутатору vSwitch. Псевдоним nics добавлен в версии 2.4.псевдонимы: имя_nic |
| number_of_ports - | По умолчанию: 128 | Количество портов для настройки на коммутаторе vSwitch. |
| password строка | Пароль сервера vCenter или ESXi сервера vSphere. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PASSWORD. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: pass, pwd | |
| port целое число добавлен в 2.5 | По умолчанию: 443 | Номер порта сервера vCenter или ESXi сервера vSphere. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PORT. Поддержка переменных среды добавлена в версии 2.6. |
| state - |
| Добавить или удалить коммутатор. |
| switch - / обязательно | Имя коммутатора vSwitch для добавления. Псевдоним switch добавлен в версии 2.4.псевдонимы: имя_коммутатора | |
| username строка | Имя пользователя сервера vCenter или ESXi сервера vSphere. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_USER. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: admin, пользователь | |
| validate_certs логический |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false при недоверенных сертификатах.Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в версии 2.6. Если установлено значение yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примечания
Примечание
- Проверено на vSphere 5.5 и 6.5
Примеры
- name: Add a VMware vSwitch
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: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
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: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
esxi_hostname: DC0_H0
switch_name: vswitch_001
nic_name: vmnic0
mtu: 9000
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| result строка | всегда | информация об осуществлённой операции Пример: Коммутатор vSwitch 'vSwitch_1002' создан успешно |
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Joseph Callen (@jcpowermac)
- Russell Teague (@mtnbikenc)
- Abhijeet Kasurde (@Akasurde) <akasurde@redhat.com>
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/vmware_vswitch_module.html