fortios_config – Управление конфигурацией на устройствах межсетевых экранов Fortinet FortiOS
Новая версия с 2.3.
Обзор
- Этот модуль обеспечивает управление конфигурацией устройств FortiOS.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| backup boolean |
| Этот аргумент заставит модуль создать резервную копию текущей running-config удалённого устройства перед внесением любых изменений. Файл резервной копии записывается в папку i(backup). |
| backup_filename - | Указывает имя файла резервной копии. Если опущено, имя файла будет отформатировано как HOST_config.ГГГГ-ММ-ДД@ЧЧ:ММ:СС | |
| backup_path - | Указывает, где хранить резервные копии. Требуется, если backup=yes. | |
| config_file - добавлен в 2.4 | Путь к файлу конфигурации. Требуется, когда file_mode равен True. | |
| file_mode boolean добавлен в 2.4 |
| Не подключаться к какому-либо устройству, использовать только config_file в качестве входных и выходных данных. |
| filter - | По умолчанию: "" | Только для частичной резервной копии, вы можете ограничить, указав ожидаемый путь к конфигурации (например, адрес межсетевого экрана). |
| host - | Указывает имя хоста DNS или IP-адрес для подключения к удалённому устройству fortios. Требуется, когда file_mode равен False. | |
| password - | Указывает пароль, используемый для аутентификации на удалённом устройстве. Требуется, когда file_mode равен True. | |
| src - | Аргумент src предоставляет путь к шаблону конфигурации для загрузки на удалённое устройство. | |
| timeout - | По умолчанию: 60 | Таймаут в секундах для подключения к удалённому устройству. |
| username - | Настраивает имя пользователя, используемое для аутентификации на удалённом устройстве. Требуется, когда file_mode равен True. | |
| vdom - | Указывает, на каком vdom применить конфигурацию |
Примечания
Примечание
- Для этого модуля требуется библиотека pyFG python.
Примеры
- name: Backup current config
fortios_config:
host: 192.168.0.254
username: admin
password: password
backup: yes
- name: Backup only address objects
fortios_config:
host: 192.168.0.254
username: admin
password: password
backup: yes
backup_path: /tmp/forti_backup/
filter: "firewall address"
- name: Update configuration from file
fortios_config:
host: 192.168.0.254
username: admin
password: password
src: new_configuration.conf.j2
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| change_string строка | только если конфигурация изменилась | Команды, реально выполненные модулем |
| running_config строка | всегда | полная строка конфигурации |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Benjamin Jolivot (@bjolivot)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/fortios_config_module.html