Public/Network/Get-PublicIP.ps1

FUNCTION Get-PublicIP {
    <#
    .SYNOPSIS
    Retrives the computer's public-facing IP address.
 
    .DESCRIPTION
    This function runs a web API request to determine its public-facing IP address.
 
    .PARAMETER None
 
    .EXAMPLE
    Get-PublicIP
 
    .NOTES
    The function uses a web API request to determine its public-facing IP address.
    #>


    [CmdletBinding()]
    PARAM ( )
      
    $IPAddress = $null

    TRY { $IPAddress = (Invoke-RestMethod -Method Get -Uri "http://ip-api.com/json/$null").query }
    CATCH { 
        $IPAddress = $null
    }   

    RETURN $IPAddress
}