ornulfn / psfortigateparser

Parse and create CSV reports from a Fortigate configuration file

PSFortigateParser

Introduction

The purpose of this Powershell module is to parse a Fortigate configuration file and create CSV reports.

CSV files are created with delimiter specified by system regional settings and will be saved using same encoding as specified for reading the config file. To open created CSV files in Excel, save files using .csv extension - double click on file to open it in Excel (Excel import wizard does not correctly parse multivalued cells using linefeed as separator).

Changelog

Detailed changes for each release are documented in the release notes.

Quickstart

Basic usage:

    # Open and parse a Fortigate config file using UTF8 encoding, save reports as CSV.
    $Config = New-PSFortigateReport -Params @('C:\firewall.conf', [System.Text.Encoding]::UTF8)
    $Config.savePolicyReport('C:\firewall-policy.csv')
    $Config.saveAddressReport('C:\firewall-address.csv')
    $Config.saveAddressGroupReport('C:\firewall-addressgroup.csv')
    $Config.saveServiceReport('C:\firewall-service.csv')
    $Config.saveServiceGroupReport('C:\firewall-servicegroup.csv')

psfortigateparser's Issues

Can't run module

Hi there,

First of all, I would like to thank you for sharing this module with us.

I am having an issue trying to load the module. I have copied it to %programfiles%\WindowsPowerShell\Modules, but if I try to run the commands specified on readme.md file, I receive the error:

"The term 'New-PSFortigateReport' is not recognized as the name of a cmdlet"

Could you, please, help me with this?

Only one csv creation works

Hi, @ornulfn , much appreciate for your share!
I've tested your script with several Fortigate .conf files and got the same results.
$Config.savePolicyReport('XXX\firewall-policy.csv') works well.

The rest functions such as saveAddressReport, saveServiceReport don't work.
It showed:
Line |
1704 | ConvertTo-Csv -NoTypeInformation -Delimiter (Get-Culture) …
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
| Cannot bind argument to parameter 'InputObject' because it is null. ------------>>>>

Could you please double check your script?