Модуль cisco.ios.ios_banner — Модуль для настройки многострочных баннеров.

Примечание

Этот модуль является частью коллекции cisco.ios (версия 8.0.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.ios.

Для использования в плейбуке укажите: cisco.ios.ios_banner.

Новинка в cisco.ios 1.0.0

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль настраивает баннеры login и motd на удалённых устройствах, работающих на Cisco IOS. Он позволяет плейбукам добавлять или удалять текст баннеров из активной рабочей конфигурации.

Псевдонимы: banner

Параметры

Параметр	Комментарии
banner строка / обязательно	Указывает, какой баннер следует настроить на удалённом устройстве. В Ansible 2.4 и более ранних версиях поддерживались только login и motd. Варианты: `"login"` `"motd"` `"exec"` `"incoming"` `"slip-ppp"`
multiline_delimiter строка	Указывает разделитель, который будет использоваться для конфигурации. По умолчанию: `"@"`
state строка	Указывает, присутствует ли конфигурация в активной рабочей конфигурации устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`
text строка	Текст баннера, который должен присутствовать в конфигурации удаленного устройства. Этот аргумент принимает многострочную строку без пустых строк. Требуется state=present.

Примечания

Примечание

Тестировалось на Cisco IOSXE версии 17.3 на CML.
Этот модуль работает с подключением network_cli. См. https://docs.ansible.com/ansible/latest/network/user_guide/platform_ios.html
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве :ref:`Ansible Network Guide <network_guide>`.
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco: `<https://www.ansible.com/integrations/networks/cisco>`_.

Примеры

- name: Configure the login banner
  cisco.ios.ios_banner:
    banner: login
    text: |
      this is my login banner
      that contains a multiline
      string
    state: present

- name: Remove the motd banner
  cisco.ios.ios_banner:
    banner: motd
    state: absent

- name: Configure banner from file
  cisco.ios.ios_banner:
    banner: motd
    text: "{{ lookup('file', './config_partial/raw_banner.cfg') }}"  # Use unix formatted text files (LF not CRLF) to avoid idempotency issues.
    state: present

- name: Configure the login banner using delimiter
  cisco.ios.ios_banner:
    banner: login
    multiline_delimiter: x
    text: this is my login banner
    state: present

Возвращаемые значения

Общие возвращаемые значения описаны в разделе здесь. Следующие поля уникальны для этого модуля:

Ключ	Описание
commands список / элементы=строка	Список команд конфигурации, которые необходимо отправить устройству Возвращается: всегда Пример: `["banner login", "this is my login banner", "that contains a multiline", "string"]`

Авторы

Ricardo Carrillo Cruz (@rcarrillocruz)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/ios/ios_banner_module.html