community.vmware.vmware_dvswitch_uplink_pg 模块 – 管理分布式交换机的上行端口组配置

注意

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

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

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

要在 Playbook 中使用它，请指定：community.vmware.vmware_dvswitch_uplink_pg。

概要

• 此模块可用于配置分布式交换机的上行端口组。

参数

参数	注释
advanced 别名：port_policy 字典	配置上行端口组高级策略设置的字典。 默认值： {"block_override": true, "netflow_override": false, "port_config_reset_at_disconnect": true, "traffic_filter_override": false, "vendor_config_override": false, "vlan_override": false}
block_override 布尔值	指示是否可以为每个端口更改阻止策略。 选项 false true ← (默认)
netflow_override 布尔值	指示是否可以为每个端口更改 NetFlow 策略。 选项 false ← (默认) true
port_config_reset_at_disconnect 布尔值	指示端口的配置是否在断开连接后自动重置。 选项 false true ← (默认)
traffic_filter_override 布尔值	指示是否可以为每个端口更改流量过滤器。 选项 false ← (默认) true
vendor_config_override 布尔值	指示是否可以为每个端口更改供应商配置。 选项 false ← (默认) true
vlan_override 布尔值	指示是否可以为每个端口更改 VLAN。 选项 false ← (默认) true
block_all_ports 布尔值	指示是否阻止上行端口组上的所有端口。 选项 false ← (默认) true
description 字符串	上行端口组的描述。
hostname 字符串	vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。 如果未在任务中指定该值，则将改为使用环境变量 VMWARE_HOST 的值。
lacp 字典	配置上行端口组的 LACP 设置的字典。 仅当 LACP 支持模式设置为 “basic” 时才使用这些选项。 默认值： {"mode": "passive", "status": "disabled"}
mode 字符串	上行链路/端口的协商状态。 选项 "active" "passive" ← (默认)
status 字符串	指示是否启用了 LACP。 选项 "enabled" "disabled" ← (默认)
name 字符串	上行端口组的名称。 如果未指定，则将使用当前名称。
netflow_enabled 布尔值	指示是否在上行端口组上启用了 NetFlow。 选项 false ← (默认) true
password 别名：pass, pwd 字符串	vSphere vCenter 或 ESXi 服务器的密码。 如果未在任务中指定该值，则将改为使用环境变量 VMWARE_PASSWORD 的值。
端口 整数	vSphere vCenter 或 ESXi 服务器的端口号。 如果任务中未指定该值，则将使用环境变量 VMWARE_PORT 的值代替。 默认值： 443
proxy_host 字符串	接收所有 HTTPS 请求并转发它们的代理地址。 格式为主机名或 IP 地址。 如果任务中未指定该值，则将使用环境变量 VMWARE_PROXY_HOST 的值代替。
proxy_port 整数	接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。 如果任务中未指定该值，则将使用环境变量 VMWARE_PROXY_PORT 的值代替。
交换机 别名: dvswitch 字符串 / 必需	分布式交换机的名称。
用户名 别名: admin, user 字符串	vSphere vCenter 或 ESXi 服务器的用户名。 如果任务中未指定该值，则将使用环境变量 VMWARE_USER 的值代替。
validate_certs 布尔值	允许在 SSL 证书无效时进行连接。当证书不受信任时，设置为 false。 如果任务中未指定该值，则将使用环境变量 VMWARE_VALIDATE_CERTS 的值代替。 选项 false true ← (默认)
vlan_trunk_range 列表 / 元素=字符串	应使用上行链路端口组配置的 VLAN 中继范围。 这可以是多个范围和数字的组合，例如：[2-3967, 4049-4092]。 默认值： ["0-4094"]

备注

注意

• 所有模块都需要 API 写入权限，因此不支持免费的 ESXi 许可证。

• 所有变量和 VMware 对象名称都区分大小写。

示例

- name: Configure Uplink portgroup
  community.vmware.vmware_dvswitch_uplink_pg:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcsa_username }}'
    password: '{{ vcsa_password }}'
    switch: dvSwitch
    name: dvSwitch-DVUplinks
    advanced:
      port_config_reset_at_disconnect: true
      block_override: true
      vendor_config_override: false
      vlan_override: false
      netflow_override: false
      traffic_filter_override: false
    vlan_trunk_range:
      - '0-4094'
    netflow_enabled: false
    block_all_ports: false
  delegate_to: localhost

- name: Enabled LACP on Uplink portgroup
  community.vmware.vmware_dvswitch_uplink_pg:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcsa_username }}'
    password: '{{ vcsa_password }}'
    switch: dvSwitch
    lacp:
      status: enabled
      mode: active
  delegate_to: localhost

返回值

常见的返回值已记录在此处，以下是此模块特有的字段

键

描述

结果 字符串

有关执行的操作的信息 返回： 总是 示例： "{'adv_block_ports': True, 'adv_netflow': False, 'adv_reset_at_disconnect': True, 'adv_traffic_filtering': False, 'adv_vendor_conf': False, 'adv_vlan': False, 'block_all_ports': False, 'changed': False, 'description': None, 'dvswitch': 'dvSwitch', 'lacp_status': 'disabled', 'lacp_status_previous': 'enabled', 'name': 'dvSwitch-DVUplinks', 'netflow_enabled': False, 'result': '上行链路端口组已正确配置', 'vlan_trunk_range': ['2-3967', '4049-4092']}"

作者

• Christian Kotte (@ckotte)

集合链接

• 问题跟踪器
• 主页
• 仓库（源代码）