community.network.aireos_command 模块 – 在运行 Cisco WLC 的远程设备上运行命令
注意
此模块是 community.network 集合 (版本 5.1.0) 的一部分。
如果您使用的是 ansible
包,则可能已安装此集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用: ansible-galaxy collection install community.network
。
要在 playbook 中使用它,请指定: community.network.aireos_command
。
注意
community.network 集合已弃用,并将从 Ansible 12 中移除。请参阅 讨论主题 以了解更多信息。
已弃用
- 在以下版本中移除:
6.0.0 版本
- 原因:
此集合及其中的所有内容均未维护且已弃用。
- 替代方案:
未知。
概要
将任意命令发送到 aireos 节点并返回从设备读取的结果。此模块包含一个参数,该参数将导致模块在返回之前等待特定条件,或者如果未满足条件则超时。
使用此模块在配置模式下运行的命令不是幂等的。请使用 community.network.aireos_config 来配置 WLC 设备。
别名:network.aireos.aireos_command
参数
参数 |
注释 |
---|---|
要通过配置的提供程序发送到远程 aireos 设备的命令列表。返回命令的结果输出。如果提供了 wait_for 参数,则模块只有在满足条件或重试次数过期后才会返回。 |
|
配置命令重试之间等待的间隔(秒)。如果命令未通过指定的条件,则间隔表示在再次尝试命令之前要等待的时间。 默认值: |
|
match 参数与 wait_for 参数一起使用以指定匹配策略。有效值为 选项
|
|
指定在命令被认为失败之前应尝试的重试次数。命令在每次重试时都在目标设备上运行,并根据 wait_for 条件进行评估。 默认值: |
|
要根据命令输出评估的条件列表。任务将等待每个条件为真才能继续。如果在配置的重试次数内条件不为真,则任务失败。请参见示例。 |
示例
tasks:
- name: Run show sysinfo on remote devices
community.network.aireos_command:
commands: show sysinfo
- name: Run show sysinfo and check to see if output contains Cisco Controller
community.network.aireos_command:
commands: show sysinfo
wait_for: result[0] contains 'Cisco Controller'
- name: Run multiple commands on remote nodes
community.network.aireos_command:
commands:
- show sysinfo
- show interface summary
- name: Run multiple commands and evaluate the output
community.network.aireos_command:
commands:
- show sysinfo
- show interface summary
wait_for:
- result[0] contains Cisco Controller
- result[1] contains Loopback0
返回值
常见返回值已记录在 此处,以下是此模块特有的字段
键 |
描述 |
---|---|
已失败的条件列表 返回:失败 示例: |
|
来自命令的一组响应 返回:除了低级错误(例如操作插件)之外始终返回 示例: |
|
stdout 的值拆分为列表 返回:除了低级错误(例如操作插件)之外始终返回 示例: |
状态
此模块将在 6.0.0 版本中移除。[已弃用]
有关更多信息,请参见 已弃用。