Public/Ping.ps1

#
# Copyright 2018-2020, Alexis La Goutte <alexis dot lagoutte at gmail dot com>
#
# SPDX-License-Identifier: Apache-2.0
#

function Test-ArubaSWPing {

    <#
        .SYNOPSIS
        Send a PING (ICMP) to a target

        .DESCRIPTION
        Send a PING (ICMP) to a target
        Get the status and latency

        .EXAMPLE
        Test-ArubaSWPing -ipv4_address 192.2.0.1

        Send a PING to IPv4 address 192.2.0.1

        .EXAMPLE
        Test-ArubaSWPing -hostname www.arubanetworks.com

        Send a PING to hostname www.arubanetworks.com
    #>


    Param(
        [Parameter (Mandatory = $false, ParameterSetName = "ipv4_address")]
        [ipaddress]$ipv4_address,
        [Parameter (Mandatory = $false, ParameterSetName = "hostname")]
        [string]$hostname,
        [Parameter (Mandatory = $False)]
        [ValidateNotNullOrEmpty()]
        [PSObject]$connection = $DefaultArubaSWConnection
    )

    Begin {
    }

    Process {

        $uri = "ping"
        $dest = New-Object -TypeName PSObject

        if ($PsBoundParameters.ContainsKey('ipv4_address')) {

            $ipv4 = New-Object -TypeName PSObject
            $ipv4 | Add-Member -name "version" -MemberType NoteProperty -Value "IAV_IP_V4"

            $ipv4 | Add-Member -name "octets" -MemberType NoteProperty -Value $ipv4_address.ToString()

            $dest | Add-Member -name "ip_address" -Membertype NoteProperty -Value $ipv4
        }
        elseif ($PsBoundParameters.ContainsKey('hostname')) {
            $dest | Add-Member -name "hostname" -Membertype NoteProperty -Value $hostname
        }
        else {
            throw "You need to use a parameter (-ipv4_address, -hostname)"
        }

        $ping = New-Object -TypeName PSObject
        $ping | Add-Member -name "destination" -Membertype NoteProperty -Value $dest

        $response = Invoke-ArubaSWWebRequest -method "POST" -body $ping -uri $uri -connection $connection

        $run = ($response | ConvertFrom-Json)
        $run
    }

    End {
    }
}