如何在Ansible中正确引用PowerShell Get-NetAdapter的Name属性？

问题根源 #

Get-NetAdapter -Name "*" -Physical返回的是多个网卡对象组成的数组，Ansible的ansible.windows.win_powershell模块会将命令输出存储在NIC.output中，这个字段是列表类型而非单个对象。直接调用NIC.output.Name会报错，因为列表本身没有Name属性，必须访问列表中的单个元素才能获取对应网卡的属性。

正确的任务编写与属性引用 #

1. 基础任务：获取物理网卡信息

先编写执行PowerShell命令并注册变量的任务：

- name: 获取所有物理网卡信息
  ansible.windows.win_powershell:
    script: |
      Get-NetAdapter -Name "*" -Physical
  register: NIC

2. 访问单个网卡的Name属性

如果只需访问第一个物理网卡的名称，直接通过索引访问列表元素：

- name: 打印第一个物理网卡名称
  ansible.builtin.debug:
    msg: "第一个物理网卡: {{ NIC.output[0].Name }}"

3. 遍历所有网卡的Name属性

若要处理所有物理网卡，使用loop遍历NIC.output数组：

- name: 遍历并打印所有物理网卡名称
  ansible.builtin.debug:
    msg: "网卡名称: {{ item.Name }}"
  loop: "{{ NIC.output }}"

4. 条件判断中使用网卡Name

如果需要基于特定网卡名称执行任务，使用Ansible过滤器筛选数组：

- name: 当存在名为"Ethernet0"的物理网卡时执行操作
  ansible.builtin.debug:
    msg: "找到目标物理网卡"
  when: NIC.output | selectattr('Name', 'equalto', 'Ethernet0') | list | length > 0

或者更简洁的any测试写法：

- name: 检查是否存在目标网卡
  ansible.builtin.debug:
    msg: "找到目标物理网卡"
  when: NIC.output | any(item.Name == 'Ethernet0')

内容的提问来源于stack exchange，提问作者GlennRA