community.vmware.vmware_dvs_host 模块 – 在分布式虚拟交换机中添加或移除主机

注意

此模块是 community.vmware 集合 (版本 5.2.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.vmware。

要在 playbook 中使用它，请指定： community.vmware.vmware_dvs_host。

概要 

管理分布式虚拟交换机中的主机系统。

参数 

参数	注释
esxi_hostname 字符串 / 必需	ESXi 主机名。
hostname 字符串	vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。如果任务中未指定此值，则将使用环境变量 `VMWARE_HOST` 的值。
lag_uplinks 列表 / 元素=字典	ESXi 主机要与特定 LAG 一起使用的 vmnics。如果未设置，则将保留当前的 LAG 上行链路。如果设置，LAG 上行链路将完全设置为此列表。因此，您必须始终定义完整的 LAG 上行链路配置；否则，您可能会丢失 LAG 上行链路。要移除所有 LAG 上行链路，请使用空列表 `[]`。
lag 字符串 / 必需	LAG 的名称。
vmnics 列表 / 元素=字符串	ESXi 主机要与 LAG 一起使用的 vmnics。默认值： `[]`
password 别名：pass、pwd 字符串	vSphere vCenter 或 ESXi 服务器的密码。如果任务中未指定此值，则将使用环境变量 `VMWARE_PASSWORD` 的值。
port 整数	vSphere vCenter 或 ESXi 服务器的端口号。如果任务中未指定此值，则将使用环境变量 `VMWARE_PORT` 的值。默认值： `443`
proxy_host 字符串	将接收所有 HTTPS 请求并转发它们的代理的地址。格式为主机名或 IP。如果任务中未指定此值，则将使用环境变量 `VMWARE_PROXY_HOST` 的值。
proxy_port 整数	将接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。如果任务中未指定此值，则将使用环境变量 `VMWARE_PROXY_PORT` 的值。
state 字符串	主机是否应连接到 vSwitch。选项 `"present"` ← (默认) `"absent"`
switch_name 字符串 / 必需	分布式 vSwitch 的名称。
username 别名：admin、user 字符串	vSphere vCenter 或 ESXi 服务器的用户名。如果任务中未指定此值，则将使用环境变量 `VMWARE_USER` 的值。
validate_certs 布尔值	允许在 SSL 证书无效时连接。当证书不受信任时，设置为 `false`。如果任务中未指定此值，则将使用环境变量 `VMWARE_VALIDATE_CERTS` 的值。选项 `false` `true` ← (默认)
vendor_specific_config 列表 / 元素=字典	厂商特定配置的键值字典列表。
key 字符串 / 必需	设置的键。
value 字符串 / 必需	设置的值。
vmnics 列表 / 元素=字符串	ESXi 主机要与分布式 vSwitch 一起使用的 vmnics。如果未设置，则将保留当前的非 LAG 上行链路。要移除所有非 LAG 上行链路，请使用空列表 `[]`。

备注 

注意

所有模块都需要 API 写入权限，因此在免费 ESXi 许可证上不支持。
所有变量和 VMware 对象名称都区分大小写。

示例 

- name: Add Host to dVS
  community.vmware.vmware_dvs_host:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    switch_name: dvSwitch
    vmnics:
        - vmnic0
        - vmnic1
    state: present
  delegate_to: localhost

- name: Add vmnics to LAGs
  community.vmware.vmware_dvs_host:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    switch_name: dvSwitch
    lag_uplinks:
        - lag: lag1
          vmnics:
              - vmnic0
              - vmnic1
        - lag: lag2
          vmnics:
              - vmnic2
              - vmnic3
    state: present
  delegate_to: localhost

- name: Add Host to dVS/enable learnswitch (https://labs.vmware.com/flings/learnswitch)
  community.vmware.vmware_dvs_host:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    switch_name: dvSwitch
    vendor_specific_config:
        - key: com.vmware.netoverlay.layer1
          value: learnswitch
    vmnics:
        - vmnic0
        - vmnic1
    state: present
  delegate_to: localhost

作者

Joseph Callen (@jcpowermac)
Abhijeet Kasurde (@Akasurde)
Joseph Andreatta (@vmwjoseph)