ansible.utils.hwaddr 过滤器 – HWaddr/MAC 地址过滤器

注意

此过滤器插件是 ansible.utils 集合 (版本 5.1.2) 的一部分。

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

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

要在剧本中使用它，请指定：ansible.utils.hwaddr。

ansible.utils 2.5.0 新增功能

概要

  • 此过滤器检查字符串是否为 HW/MAC 地址并对其进行过滤

  • 您可以使用 hwaddr() 过滤器检查给定字符串是否为 MAC 地址，或在各种格式之间进行转换。

关键字参数

这描述了过滤器的关键字参数。这些是在以下示例中的值 key1=value1，key2=value2 等：input | ansible.utils.hwaddr(key1=value1, key2=value2, ...)

参数

注释

别名

字符串

别名

默认值： "hwaddr"

查询

字符串

查询字符串。例如，cisco、linux、unix 等

默认值： ""

值

字符串 / 必需

HW/MAC 地址。

示例

#### examples
- name: Check if given string is a MAC address
  debug:
    msg: "{{ '1a:2b:3c:4d:5e:6f' | ansible.utils.hwaddr }}"

- name: Convert HW address to Cisco format
  debug:
    msg: "{{ '1a:2b:3c:4d:5e:6f' | ansible.utils.hwaddr('cisco') }}"

# TASK [Check if given string is a MAC address] ***************************************************************
# ok: [localhost] => {
#     "msg": "1a:2b:3c:4d:5e:6f"
# }
#
# TASK [Convert HW address to Cisco format] ******************************************************************
# ok: [localhost] => {
#     "msg": "1a2b.3c4d.5e6f"
# }

返回值

键

描述

数据

字符串

mac/Hw 地址

返回：成功

作者

  • Ashwini Mhatre (@amhatre)

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。