net_system – Управление системными атрибутами на сетевых устройствах

Новая версия 2.4.

УСТЕРЕКШЕЕ
Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

УСТЕРЕКШЕЕ

Удалено в Ansible:
	версия: 2.13
Почему:	Выпущены обновлённые модули с большей функциональностью
Альтернатива:	Используйте модуль “[netos]_system” соответствующий платформе

Описание

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

Параметры

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

Примечания

Примечание

Этот модуль поддерживается на ansible_network_os сетевых платформах. Подробности см. в Параметры сетевых платформ.

Примеры

- name: configure hostname and domain name
  net_system:
    hostname: ios01
    domain_name: test.example.com
    domain-search:
      - ansible.com
      - redhat.com
      - cisco.com

- name: remove configuration
  net_system:
    state: absent

- name: configure DNS lookup sources
  net_system:
    lookup_source: MgmtEth0/0/CPU0/0

- name: configure name servers
  net_system:
    name_servers:
      - 8.8.8.8
      - 8.8.4.4

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

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

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

Статус

Этот модуль будет удален в версии 2.13. [устаревший]
Дополнительную информацию см. в УСТЕРЕКШЕЕ.

Авторы

Ricardo Carrillo Cruz (@rcarrillocruz)

Подсказка

Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/net_system_module.html