Documentation

fmgr_script – Add/Edit/Delete and execute scripts

New in version 2.5.

Synopsis

  • Create/edit/delete scripts and execute the scripts on the FortiManager using jsonrpc API

Parameters

Parameter Choices/Defaults Comments
adom
- / required
The administrative domain (admon) the configuration belongs to
host
- / required
The FortiManager's Address.
password
-
The password associated with the username account.
script_content
-
The script content that will be executed.
script_description
-
The description of the script.
script_name
- / required
The name of the script.
script_package
-
(datasource) Policy package object to run the script against
script_scope
-
(datasource) The devices that the script will run on, can have both device member and device group member.
script_target
-
The target of the script to be run.
script_type
-
The type of script (CLI or TCL).
state
-
    Choices:
  • present ←
  • execute
  • delete
The desired state of the specified object.
present - will create a script.
execute - execute the scipt.
delete - delete the script.
username
- / required
The username to log into the FortiManager
vdom
-
The virtual domain (vdom) the configuration belongs to

Examples

- name: CREATE SCRIPT
  fmgr_script:
    host: "{{inventory_hostname}}"
    username: "{{ username }}"
    password: "{{ password }}"
    adom: "root"
    script_name: "TestScript"
    script_type: "cli"
    script_target: "remote_device"
    script_description: "Create by Ansible"
    script_content: "get system status"

- name: EXECUTE SCRIPT
  fmgr_script:
    host: "{{inventory_hostname}}"
    username: "{{ username }}"
    password: "{{ password }}"
    adom: "root"
    script_name: "TestScript"
    state: "execute"
    script_scope: "FGT1,FGT2"

- name: DELETE SCRIPT
  fmgr_script:
    host: "{{inventory_hostname}}"
    username: "{{ username }}"
    password: "{{ password }}"
    adom: "root"
    script_name: "TestScript"
    state: "delete"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
api_result
string
always
full API response, includes status code and message



Status

Authors

  • Andrew Welsh

Hint

If you notice any issues in this documentation you can edit this document to improve it.