Модуль cisco.ios.ios_system — Управление системными атрибутами.

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install cisco.ios.

Чтобы использовать её в плейбуке, укажите: cisco.ios.ios_system.

Добавлен в cisco.ios 1.0.0

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

Описание

Этот модуль предоставляет декларативное управление атрибутами системы узла на устройствах Cisco IOS. Он предоставляет возможность настроить параметры хост-системы или удалить эти параметры из активной конфигурации устройства.

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

Параметры

Параметр	Комментарии
domain_name список / элементы=любое	Настройка имени домена IP на удалённом устройстве на предоставленное значение. Значение должно быть в форме с точками и будет добавлено к `hostname` для создания полного доменного имени.
domain_search список / элементы=любое	Предоставляет список суффиксов домена для добавления к имени хоста для целей разрешения имён. Этот аргумент принимает список имён и будет согласован с текущей активной конфигурацией на узле.
hostname строка	Настройка параметра имени хоста устройства. Этот параметр принимает значение ASCII-строки.
lookup_enabled логическое	Административный контроль для включения или выключения поиска DNS. Когда этот аргумент установлен в True, поиск выполняется, а когда в False, поиск не выполняется. Варианты: `false` `true`
lookup_source строка	Предоставляет один или несколько исходных интерфейсов для использования при выполнении поиска DNS. Интерфейс, указанный в `lookup_source`, должен быть допустимым интерфейсом, настроенным на устройстве.
name_servers список / элементы=любое	Список DNS-серверов по IP-адресу для использования при выполнении поиска разрешения имён. Этот аргумент принимает список DNS-серверов. Смотрите примеры.
state строка	Состояние значений конфигурации в текущей активной конфигурации устройства. При установке в present значения должны быть настроены в активной конфигурации устройства, а при установке в absent значения не должны быть в активной конфигурации устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`

Примечания

Примечание

Проверено на Cisco IOSXE версии 17.3 на CML.
Этот модуль работает с подключением network_cli. Смотрите https://docs.ansible.com/ansible/latest/network/user_guide/platform_ios.html
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве по Ansible по сети.
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco.

Примеры

- name: Configure hostname and domain name
  cisco.ios.ios_system:
    hostname: ios01
    domain_name: test.example.com
    domain_search:
      - ansible.com
      - redhat.com
      - cisco.com

- name: Remove configuration
  cisco.ios.ios_system:
    state: absent

- name: Configure DNS lookup sources
  cisco.ios.ios_system:
    lookup_source: MgmtEth0/0/CPU0/0
    lookup_enabled: true

- name: Configure name servers
  cisco.ios.ios_system:
    name_servers:
      - 8.8.8.8
      - 8.8.4.4

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

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

Ключ	Описание
commands список / элементы=строка	Список команд конфигурационного режима для отправки на устройство Возвращается: всегда Пример: `["hostname ios01", "ip domain name test.example.com"]`

Авторы

Peter Sprygada (@privateip)

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

© 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_system_module.html