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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 list / elements=any	Задаёт для удалённого устройства указанное имя IP-домена. Значение должно иметь формат имени с точками и будет добавлено к `hostname` для формирования полного доменного имени.
domain_search list / elements=any	Задаёт список суффиксов доменов, добавляемых к имени узла для разрешения имён. Этот аргумент принимает список имён; его значения будут согласованы с текущей активной конфигурацией работающего узла.
hostname string	Настраивает параметр имени узла устройства. Этот параметр принимает строковое значение ASCII.
lookup_enabled boolean	Административное управление включением и отключением запросов DNS. Если для этого аргумента задано значение True, запросы выполняются; если задано значение False, запросы не выполняются. Варианты: `false` `true`
lookup_source string	Задаёт один или несколько исходных интерфейсов для выполнения запросов DNS. Интерфейс, указанный в `lookup_source`, должен быть действительным интерфейсом, настроенным на устройстве.
name_servers list / elements=any	Список DNS-серверов имён, заданных IP-адресами и используемых для разрешения имён. Этот аргумент принимает список DNS-серверов. См. примеры.
state string	Состояние значений конфигурации в текущей активной конфигурации устройства. Если задано значение present, значения должны быть настроены в активной конфигурации устройства; если задано значение absent, значения не должны присутствовать в активной конфигурации устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`

Примечания

Примечание

Протестировано в CML с Cisco IOSXE версии 17.3.
Этот модуль работает с подключением network_cli. См. https://docs.ansible.com/ansible/latest/network/user_guide/platform_ios.html
Дополнительные сведения об использовании Ansible для управления сетевыми устройствами см. в :ref:`руководстве по сетям Ansible <network_guide>`
Дополнительные сведения об использовании Ansible для управления устройствами Cisco см. на `странице интеграции Cisco <https://www.ansible.com/integrations/networks/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 list / elements=string	Список команд режима конфигурации, отправляемых устройству Возвращается: всегда Пример: `["hostname ios01", "ip domain name test.example.com"]`

Авторы

Peter Sprygada (@privateip)

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

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