community.network.apconos_command 模块 – 在 APCON 设备上运行任意命令

注意

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

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

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

要在 playbook 中使用它，请指定：community.network.apconos_command。

注意

community.network 集合已被弃用，并将从 Ansible 12 中删除。有关更多信息，请参阅讨论主题。

community.network 0.2.0 中的新增功能

已弃用

在以下版本中删除:

6.0.0 版

原因:

此集合及其中的所有内容均未维护且已弃用。

替代方案:

未知。

概要

  • 将任意命令发送到 apcon 设备并返回从设备读取的结果。该模块包含一个参数，该参数将导致模块在返回之前等待特定条件，如果未满足该条件则会超时。

别名: network.apconos.apconos_command

参数

参数

注释

commands

列表 / 元素=字符串 / 必需

要通过配置的提供程序发送到远程设备的命令列表。返回命令的输出结果。如果提供了 wait_for 参数，则在满足条件或重试次数过期之前不会返回模块。

interval

整数

配置在重试命令之间等待的秒数间隔。如果该命令未通过指定的条件，则该间隔指示在再次尝试该命令之前等待多长时间。

默认值： 1

match

字符串

match 参数与 wait_for 参数结合使用，以指定匹配策略。有效值是 all 或 any。如果值设置为 all，则必须满足 wait_for 中的所有条件。如果值设置为 any，则只需满足其中一个值。

选择

  • "any"

  • "all" ← (默认)

retries

整数

指定命令在被认为失败之前应尝试的重试次数。该命令在每次重试时在目标设备上运行，并根据 wait_for 条件进行评估。

默认值： 10

wait_for

列表 / 元素=字符串

要针对命令的输出进行评估的条件列表。该任务将等待每个条件为真，然后再继续进行。如果在配置的重试次数内条件不为真，则任务失败。请参阅示例。

注释

注意

  • 已针对 apcon iis+ii 进行测试

示例

- name: Basic Configuration
  community.network.apconos_command:
    commands:
    - show version
    - enable ssh
  register: result

- name: Get output from single command
  community.network.apconos_command:
    commands: ['show version']
  register: result

状态

  • 此模块将在 6.0.0 版本中删除。[已弃用]

  • 有关更多信息，请参阅 已弃用。

作者

  • David Lee (@davidlee-ap)