Add Get-FGTMonitorFirewallAddressFQDN

PowerFGT/Public/monitor/firewall/address-fqdn.ps1

@@ -0,0 +1,68 @@
+#
+# Copyright 2022, Alexis La Goutte <alexis dot lagoutte at gmail dot com>
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+function Get-FGTMonitorFirewallAddressFQDN {
+
+    <#
+        .SYNOPSIS
+        Get Monitor Firewall Address FQDN
+
+        .DESCRIPTION
+        Get Monitor Firewall Adresss FQDN (fqdn, addrs, addrs_count...)
+
+        .EXAMPLE
+        Get-FGTMonitorFirewallAddressFQDN
+
+        Get ALL Firewall Address FQDN
+
+        .EXAMPLE
+        Get-FGTMonitorFirewallAddressFQDN -fqdn github.com
+
+        Get Firewall Address FQDN of github.com
+
+        .EXAMPLE
+        Get-FGTMonitorFirewallAddressFQDN -vdom vdomX
+
+        Get Firewall Address FQDN of vdomX
+
+    #>
+
+    Param(
+        [Parameter (Mandatory = $false, Position = 1)]
+        [string]$fqdn,
+        [Parameter (Mandatory = $false)]
+        [switch]$skip,
+        [Parameter(Mandatory = $false)]
+        [String[]]$vdom,
+        [Parameter(Mandatory = $false)]
+        [psobject]$connection = $DefaultFGTConnection
+    )
+
+    Begin {
+    }
+
+    Process {
+
+        $invokeParams = @{ }
+        if ( $PsBoundParameters.ContainsKey('skip') ) {
+            $invokeParams.add( 'skip', $skip )
+        }
+        if ( $PsBoundParameters.ContainsKey('vdom') ) {
+            $invokeParams.add( 'vdom', $vdom )
+        }
+
+        $uri = 'api/v2/monitor/firewall/address-fqdns?'
+
+        if ($fqdn) {
+            $uri += "mkey=$($fqdn)"
+        }
+
+        $response = Invoke-FGTRestMethod -uri $uri -method 'GET' -connection $connection @invokeParams
+        $response.results
+    }
+
+    End {
+    }
+}

README.md

@@ -1298,6 +1298,7 @@ You need to have VPN IPsec Interface Phase 1 created before
 
 It is possible to `monitor` FortiGate
 
+* `Get-FGTMonitorFirewallAddressFQDN` List of FQDN address objects and the IPs they resolved to
 * `Get-FGTMonitorFirewallPolicy` List traffic statistics for firewall policies
 * `Get-FGTMonitorFirewallSession` List all active firewall sessions
 * `Get-FGTMonitorRouterIPv4` List all active IPv4 routing table entries

Tests/integration/Connection.Tests.ps1

@@ -274,6 +274,9 @@ Describe "Connect to a FortiGate (using multi connection)" {
         It "Use Multi connection for call Get Webfilter Profile" {
             { Get-FGTWebfilterProfile -connection $fgt } | Should -Not -Throw
         }
+        It "Use Multi connection for call Get Monitor Firewall Address FQDN" {
+            { Get-FGTMonitorFirewallAddressFQDN -connection $fgt } | Should -Not -Throw
+        }
         It "Use Multi connection for call Get Monitor Firewall Policy" {
             { Get-FGTMonitorFirewallPolicy -connection $fgt } | Should -Not -Throw
         }